Claude Code 保姆级实战教程，小白也能看懂

作者：修BUG | 发布时间：

如何安装cladue code 和接入国产大模型

由于cladue 对中国大陆用户及其不友好，加上一些朋友的开发环境限制，以及考虑成本 我在另一篇文章中已经写了如何将第三方国产大模型接入cladue code

data-postsbox="{"id":41899,"title":"一文教会你安装Claude code 并接入各类中外大模型","author":"修BUG","author_id":32084,"cover_image":"https://static.pigsec.cn/wp-content/uploads/2026/02/5f0df4760b135802.png","cover_video":"","views":689,"comment_count":2,"category":"ai","is_forum_post":false}">{"id":41899,"title":"一文教会你安装Claude code 并接入各类中外大模型","author":"修BUG","author_id":32084,"cover_image":"https://static.pigsec.cn/wp-content/uploads/2026/02/5f0df4760b135802.png","cover_video":"","views":689,"comment_count":2,"category":"ai","is_forum_post":false}

核心准备：安装 Claude Code 与 IDE 完美集成

不要仅仅在系统终端里运行，将它集成到 VS Code 中才是最强大的生产力形态。

1. 针对不同系统的完美安装方案

  • Mac 用户：直接前往官网主页，点击复制 Bash 脚本，粘贴到终端运行即可。

  • Windows 用户：官网默认提供的 Windows 脚本实际上是 PowerShell 脚本，运行极易报错(我在上面提到的哪个文章中有详细用powershell安装的教程 实际的更简单)。使用 npm 安装：前往 nodejs.org，点击绿色大按钮下载 NodeJS 安装包并一路默认安装。

  • 打开命令行（Command Prompt），输入 node -v，如果返回版本号说明 Node 安装成功。

  • 输入指令 npm install -g @anthropic-ai/claude-code 进行全局安装。

  • 初始化配置：安装完成后，在终端输入 claude 并回车。选择终端文本样式（作者推荐 Dark Mode 深色模式）。

  • 选择通过网页登录你的 Anthropic/Claude 账户进行授权绑定。

2. 在 VS Code 中进行项目初始化（极其重要）

  • 在 VS Code 中，按快捷键 Ctrl + Shift + 反引号（）` 打开一个新的集成终端。

  • 第一步永远是初始化 Git：输入 git init 并回车，为你接下来的代码创建一个本地版本库（存档点）。

  • 唤醒 Claude Code：在终端面板右上角的下拉箭头处，选择切换到 Command Prompt（命令提示符），输入 claude 回车，然后按数字键 1 信任当前项目目录。

实战场景一：从零开始构建“办公室家务管理 App”

我们要构建一个包含 Outlook 样式日历、能分配人员、支持循环周期的家务管理应用。

1. 如何写出完美的高级 Prompt（提示词）

  • 错误示范：只给一句笼统的话：“做一个家务 App，要有日历视图能看当前任务”。这种提示词缺乏技术栈限制、存储方案、架构设计和工程规范。

  • 标准操作：连按两下 Esc 键清空当前输入框。

  • 使用要点列表（Bullets）列出所有高优先级需求。（注：在输入框中换行需要按住 Alt + Enter 或 Option + Enter）。

  • 核心秘籍：在提示词的最后加上一句话：“请向我提问，以澄清需求细节、工程原则和硬性约束条件。”

2. 使用 Plan Mode（计划模式）与 AI 进行技术架构探讨

  • 切换模式：按住 Shift + Tab 键，直到左下角的模式切换为 Plan 模式。在此模式下，Claude 绝对不会擅自写代码，而是必须先和你商议。

  • 回答 AI 的提问：按下回车后，Claude 开始推理并向你抛出选择题。比如它问：前端用 React 吗？数据存哪里？需要做身份验证吗？

  • 你可以使用键盘左右方向键切换问题，按数字键 1 提交答案（视频中作者选择了 React、本地存储 Local Storage、不需要身份验证）。

  • 这种互动就像你和一位资深工程师同事在开需求评审会。

3. 审查与强制修改执行计划

  • 问答结束后，Claude 会输出一份包含数据模型、项目结构、实现步骤的超详细技术方案摘要。

  • 审查细节：视频作者审查时发现，AI 擅自决定使用了 Vite 和 Tailwind（虽然没要求，但可以接受），但发现它打算用 JavaScript 而不是 TypeScript。

  • 强制纠正：在终端提示“是否继续 (would you like to proceed?)”时，选择选项 3，输入命令：“请使用 TypeScript 代替 JavaScript”。沟通技巧：对 AI 说话不用太客气，像对资深同事一样，清晰、坚定、直接陈述事实即可。

  • AI 重新生成计划，确认文件后缀全部变成了 .ts 和 .tsx 后，选择继续。

4. 自动化写代码与防范式测试

  • 自动接受修改：对于新手，可以一行行手动确认代码；但为了效率，强烈建议选择选项 1（自动接受所有 Claude 的代码修改）。

  • 处理终端许可：不到一分钟，Claude 写完了几百行代码，此时它请求运行 npm install 安装依赖包。选择选项 2 批准运行。

  • 防踩坑细节（重点）：安装完依赖后，Claude 接着请求“帮你运行本地开发服务器 (run the dev server)”。作者强烈建议拒绝这个请求。正确做法是：自己新开一个终端窗口，手动输入命令启动服务器，这样你能时刻监控报错日志，不会被 AI 抢走控制权。

  • 不要急着修 Bug（Vibe Engineering 铁律）：在浏览器测试 App 时，作者发现了一个 Bug：点击日历空白处添加任务时，默认时间错误（跑到晚上 8 点去了）。

  • 忍住！不要立刻让 AI 去修！ 因为只要你输入新的提示词，AI 就有可能引发“回归错误（改坏原本好的代码）”。

  • 铁律：立刻执行 git commit（提交早期版本），建议在这个阶段新建一个 Git 分支。确保你有一个“已知没有大错”的存档点后，再去修 Bug。

实战场景二：接手已有项目与制定团队规范（解决 Bug）

假如你是中途拿着 Claude Code 介入一个老项目，如何让它理解以前的规范？

1. 清理内存上下文

  • 输入 /clear 或连按两下 Esc。这相当于清空 AI 大脑，让它用全新的眼光审视当前代码库，释放内存占用。

2. 核心大招：创建 claude.md 规范文件 这是 AI 接手老代码的灵魂。这个文件里的内容会在每次你开启 Claude 会话时，被强行注入到它的记忆的最前排。

  1. 绝对不要使用自带命令：不要用它自带的 /init 命令生成，那个生成的太烂了。建议自己提供一段长 Prompt 让它生成。

  2. 文件需包含的三个层次：是什么（What）：项目的技术栈、文件结构、包依赖。

  3. 为什么（Why）：每个核心组件的业务作用和目的是什么。

  4. 怎么做（How）：规定 Claude 必须遵守的工作流（比如：“每次修改后必须跑通测试用例”）。

  5. 渐进式信息披露（Progressive Disclosure）原则：不要把几千字的规范全塞进这一个文件里。在 claude.md 里面建立一个“目录索引”，让它指向其他具体的 .md 文件（如 architecture-patterns.md），AI 会顺藤摸瓜去读。（在 VS Code 里可以按 Ctrl+Shift+V 预览排版好的 Markdown 文件）。

3. 实战验证：规范约束与修 Bug

  • 作者在 claude.md 里强行加了一条新规定：“开发新功能或修复 Bug 时，你必须先创建一个新的 Git 分支。”

  • 提交保存后，彻底退出 Claude 并重新启动以加载新规范。

  • 输入极简修 Bug 指令：“这是一个 Bug：点击日历时填充的时间不对。”

  • 奇迹出现：Claude 自己翻找找到了出错的 .tsx 文件。在它准备改代码前，它主动停下来请求运行终端命令新建一个 Git 分支！它完美遵守了 claude.md 中的规范。

  • Bug 修复完成后，像审查人类工程师的代码一样去检查它的逻辑，如果不满意，用提示词让它重写，不要自己手动改。

实战场景三：底层架构大换血与 YOLO 危险模式

现在的任务是：让两个不同的浏览器页面不需要刷新，就能实时同步数据的变化。这需要底层后端的重构。

1. 开启极致效率的 YOLO 模式

  • 按 Shift + Tab 切换出带警告标志的 “危险跳过权限模式（Dangerously Skip Permissions）”，作者戏称它为 YOLO（You Only Live Once）模式。

  • 在这个模式下，Claude 执行任何终端命令（安装包、删文件、起服务）都不会再弹窗问你“同不同意”，它会像一台失控的跑车一样狂飙代码。速度极快，但风险也极大。

2. 严格遵守“探索-计划-编码-提交”工作流 遇到这种级别的大改动，绝对不能直接让 AI 去写：

  • 第一步：探索与计划（Explore & Plan）切回普通的 Plan 模式。

  • 高阶 Prompt 技巧：详细描述你想做的架构改动，并明确要求：“去探索一下项目里的这些文件，然后给我提供 3 个不同的后续推进方案（Options）。”

  • Claude 思考后给出了方案：方案1可能是简单的浏览器跨签页同步；方案3是创建一个完整的 WebSocket 服务器端来实现真正的实时双向同步。

  • 作者选择了最硬核的方案三。

  • 第二步：审查大规模计划Claude 给出一份极其详尽的“分阶段实施路线图（Phased approach）”和设计决策。确认无误后批准执行。

  • 第三步：编码执行（Code）此时因为开启了 YOLO 模式，你只需坐等。

  • 接下来的 5 分钟内，Claude 全自动地在后台帮你配置了全新的后端服务器，写好了 WebSocket 通信逻辑，并修改了前端页面的数据获取方式。

  • 最终验证：作者并排打开了两个浏览器窗口，在左边新建了一个团队成员，右边的网页瞬间实时弹出了该成员。大重构完美成功。


标签：claude code