ai-website-cloner-template

环境要求

• GitHub 账号（用 Use this template 创建自己的仓库）
• Node.js 与 npm 环境（用于执行 npm install）
• AI 编程代理：推荐 Claude Code + Opus 5，同时支持 Codex、Cursor、Gemini
• 可选：Docker（使用 docker compose 方式运行时需要）

安装与启动步骤

1. 1创建模板副本

   在 GitHub 项目页点 Use this template，再点 Create a new repository，生成属于你自己的仓库。

2. 2克隆新仓库

   把命令里的用户名和仓库名换成你刚创建的仓库地址，再在本地执行。

   git clone https://github.com/YOUR-USERNAME/YOUR-NEW-REPOSITORY.git
   cd YOUR-NEW-REPOSITORY

   复制

3. 3安装依赖

   在项目根目录执行，安装 Next.js / React 项目所需依赖，装好后才能运行。

   npm install

   复制

4. 4启动 AI 代理

   推荐 Claude Code 搭配 Opus 5，--chrome 让代理可访问浏览器；Codex、Cursor、Gemini 也可。

   claude --chrome

   复制

5. 5执行克隆技能

   把占位符换成目标网站地址，多个网址用空格分隔，代理会反向生成 Next.js 应用。

   /clone-website <target-url1> [<target-url2> ...]

   复制

6. 6改用 Docker 运行

   可选方式。app 为构建并运行应用，dev 为开发模式并监听 3001 端口，需先装好 Docker。

   docker compose up app --build
   docker compose up dev --build

   复制

7. 7自定义修改

   基础克隆完成后，可按需修改组件、样式和交互逻辑，用于学习或二次开发。

如何确认成功

npm install 无报错；执行 docker compose up app 能成功构建并启动容器，dev 模式监听 3001 端口。

常见问题

注意事项

• 项目采用 MIT 协议，可自由使用与修改。
• 务必替换命令中的 YOUR-USERNAME、YOUR-NEW-REPOSITORY 与 <target-url> 等占位符。
• 克隆他人网站请注意版权与目标站点的使用条款，仅用于学习、原型验证等场景。