ClaudeCode 项目实战操作指南：用 CLAUDE.md 与 Plan/Yolo 模式跑通一个真实项目

1. 真实项目里 ClaudeCode 到底怎么跑起来ClaudeCode 是 Anthropic 推出的命令行 AI 编程工具能直接读写你本地项目文件、执行命令、跑测试适合已经有一定工程结构、想让 AI 深度参与开发流程的开发者。很多人第一次装完 ClaudeCode敲几句对话觉得“也就那样”问题往往不在模型而在于没把项目记忆、任务规划和执行权限这三件事串起来。我试过在一个真实的中型前端项目里完整跑一遍从生成 CLAUDE.md 到 Plan 拆解再到 Yolo 自动执行最后用 compact 压缩上下文收尾整个闭环跑通之后效率提升非常明显。这篇就按这个顺序讲先让 ClaudeCode 认识你的项目CLAUDE.md再让它学会只规划不动手Plan 模式然后放开权限自动执行Yolo 模式中途上下文快满时用 compact 续命。每一步都给可复制的命令和配置你跟着在本地项目里操作一遍就能跑通。需要说明的是ClaudeCode 本身是客户端工具它调用模型需要 API 凭证。下面接入部分我会用 TaoToken 作为示例因为它同时提供 Claude 系列模型的对话和 API 接入配置起来比较直接。你如果有其他合规的模型服务把 base_url 和 key 换掉即可流程完全一样。2. 前置准备拿到可用的 API Key 并接入 ClaudeCodeClaudeCode 默认走 Anthropic 官方接口但国内开发者直接配置官方 key 往往不方便。TaoToken 提供了兼容 Anthropic 协议的接入方式ClaudeCode 可以直接对接。整个准备分两步拿 Key配环境变量。2.1 获取 API Key打开 TaoToken 控制台进入 API Keys 页面创建一个新 key。创建时建议按项目命名比如claudecode-demo方便后面区分不同用途的额度。复制出来的 key 只显示一次先存到安全的地方。如果你还没决定用哪个模型可以先去模型对话页面体验一下 Claude 系列模型的实际输出风格确认符合预期再接入到 ClaudeCode 里跑项目。2.2 配置环境变量ClaudeCode 读取的是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个环境变量。在 macOS/Linux 下写入 shell 配置文件# 写入 ~/.zshrc 或 ~/.bashrc export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的key粘贴在这里Windows PowerShell 下用$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的key粘贴在这里改完记得source ~/.zshrc或重开终端。验证环境变量是否生效echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY两个都能正确输出就说明配置到位了。这里注意 base_url 结尾不要多加/v1ClaudeCode 会自己拼接路径多写反而会 404。3. 可复制配置CLAUDE.md 骨架与项目记忆CLAUDE.md 是 ClaudeCode 的项目级记忆文件放在项目根目录每次启动会话都会自动读取。它决定了 Claude 对你项目的理解程度写得好能省掉大量重复解释。3.1 用 /init 自动生成初版进入你的项目根目录启动 ClaudeCodecd /path/to/your-project claude在交互界面里输入/initClaudeCode 会扫描项目下所有文件分析技术栈、目录结构、依赖关系然后在根目录生成 CLAUDE.md。生成过程中它会问你是否创建选 yes。默认生成的是英文版你可以直接说“把 CLAUDE.md 翻译成中文并保留代码块”它会就地改写。3.2 手动补全的 CLAUDE.md 骨架自动生成的版本偏通用建议按下面这个骨架手动补全关键信息。这个骨架我在多个项目里用过覆盖了 ClaudeCode 最需要知道的上下文# 项目名称 ## 项目简介 一句话说明这个项目是做什么的面向什么用户。 ## 技术栈 - 前端React 18 TypeScript Vite - 状态管理Zustand - 样式Tailwind CSS - 测试Vitest Testing Library ## 目录结构 - src/components通用组件 - src/pages页面级组件 - src/api接口封装 - src/store全局状态 ## 代码惯例 - 组件一律用函数式 hooks - 接口请求统一走 src/api/request.ts 封装 - 提交前必须跑 npm run lint 和 npm run test ## 常用命令 - 启动开发npm run dev - 构建npm run build - 测试npm run test - 类型检查npm run typecheck ## 注意事项 - 不要直接修改 src/api/request.ts 的拦截器逻辑 - 新增依赖前先确认 package.json 里是否已有同类库这份骨架的价值在于Claude 每次动手前都会读它知道你的技术栈、代码风格和禁区不会乱装依赖、不会用错状态管理方案。写完保存下次会话自动生效。3.3 用 /memory 随时编辑会话中想改 CLAUDE.md不用退出直接输入/memory它会列出可编辑的记忆文件选 1 是项目级 CLAUDE.md选 2 是用户级全局记忆。改完保存即可当前会话立即生效。4. Plan 模式与 Yolo 模式从拆解到自动执行ClaudeCode 默认每次修改文件都要你手动确认安全但慢。真正跑项目要会用模式切换Plan 模式只规划不执行Yolo 模式放开权限自动干。4.1 模式切换快捷键不同版本快捷键略有差异一般是ShiftTab或AltM循环切换。切换时界面底部会显示当前模式名。三种模式分别是普通模式每次确认、自动编辑模式文件操作免确认、Plan 模式只读规划。4.2 Plan 模式先出方案再动手面对“搭一个新模块”这种复杂任务先切到 Plan 模式。比如我要做一个像素风格的移动端 todolist在 Plan 模式下输入需求Claude 不会直接改文件而是输出一份方案技术栈选型、页面结构、状态管理方案、适配策略。看完方案如果不满意直接说“重新规划状态管理换成 Zustand”它会重出方案。确认没问题后切回普通模式或自动编辑模式说“按刚才的方案执行”它才开始动手。这一步能避免它上来就乱改一通。4.3 Yolo 模式完全放手的自动执行重构代码、修复杂 bug 这种需要连续多步操作的场景用 Yolo 模式。启动命令claude --dangerously-skip-permissions启动时会有确认提示选择接受。进入后 Claude 拥有更高权限可以连续执行文件读写、命令运行不再逐步确认。进入后仍能用ShiftTab调整权限粒度比如临时切回需要确认的模式。Yolo 模式适合你对项目结构比较熟、任务边界清晰的情况。如果任务本身模糊建议还是先 Plan 再执行别一上来就 Yolo。4.4 三种模式对照模式适用场景文件操作命令执行普通模式日常小改动每次确认每次确认自动编辑批量文件创建修改免确认确认Plan 模式复杂任务规划只读只读Yolo 模式重构、修 bug、新项目免确认免确认5. 验证请求跑通一次完整闭环配置和模式都就绪后用一个真实小任务验证整条链路。我拿一个待办事项组件来演示。5.1 启动并确认接入成功cd /path/to/your-project claude进入后先输入/status确认当前会话状态、模型、base_url 都正确。再输入/cost看当前 token 消耗统计确认计费走的是你配置的 key。5.2 Plan 拆解任务切到 Plan 模式输入我要在 src/components 下新增一个 TodoList 组件支持添加、删除、标记完成用 Zustand 管理状态样式用 Tailwind。先给我方案。Claude 会输出组件结构、状态设计、文件清单。确认后切到 Yolo 模式输入按刚才的方案执行创建文件并跑通测试。它会连续创建组件文件、store 文件、测试文件然后运行npm run test。整个过程不用你逐步确认。5.3 用 compact 压缩上下文任务跑完会话历史已经很长。输入/cost看 token 消耗如果接近上限界面会提示类似Context left until auto-compact: 3%。这时手动触发压缩/compact 保留 TodoList 组件的实现细节和未解决的测试问题带指令的 compact 会让 Claude 在总结时侧重你指定的内容避免压缩后丢失关键上下文。压缩过程大约需要一两分钟完成后会话继续可以接着做下一个任务。5.4 会话恢复中途退出或强制关闭后用下面命令恢复claude -c # 直接进入上次对话 claude -r # 打开历史对话列表选择要恢复的会话claude -r用得更多因为它能让你在多个历史会话里挑。6. 本篇常见错排查跑这个流程时容易踩几个坑提前说清楚。报 401 或认证失败先检查ANTHROPIC_API_KEY是否有多余空格或换行echo出来看一眼。再确认 key 没有过期或被禁用。如果用的是 TaoToken 的 key去控制台 API Keys 页面确认状态是启用。报 404 或路径错误多半是ANTHROPIC_BASE_URL写多了路径。正确写法是https://taotoken.net/api不要加/v1或/messagesClaudeCode 会自己拼。CLAUDE.md 没生效确认文件在项目根目录文件名大小写正确全大写。用/memory看当前加载的是哪个文件如果加载的是用户级而不是项目级说明项目根目录下没有 CLAUDE.md。Yolo 模式启动被拒--dangerously-skip-permissions启动时的确认提示必须选接受选拒绝会退回普通模式。如果公司环境有安全策略限制这个参数可能被拦截那就用自动编辑模式替代。compact 后上下文丢失严重不带指令的/compact会做通用总结可能丢掉你关心的细节。养成带指令的习惯比如/compact 保留数据库 schema 和未完成的迁移任务。Plan 模式改了文件Plan 模式理论上只读但如果你在 Plan 模式下说了“直接改”部分版本可能会执行。规划阶段就只讨论方案别说执行类的话。接入和排障相关的细节可以对照接入文档逐项核对如果只是想先验证模型输出质量去模型对话页面直接试几轮更省事长期在项目里高频使用、需要稳定额度的话Coding Plan 更适合具体在 console 里能看到当前方案和用量。7. 把闭环固定成习惯整套流程跑通后建议固定成这样的节奏新项目先/init生成 CLAUDE.md 再手动补全骨架每个复杂任务先 Plan 出方案方案确认后切 Yolo 连续执行会话变长就带指令 compact退出前用/cost看一眼消耗。这套动作重复几次就成肌肉记忆了。还有一个实用技巧在项目根目录建一个TASK.md每行写一个待办任务然后对 ClaudeCode 说“读取 TASK.md每行是一个任务依次执行”。配合 Yolo 模式它能一口气把清单跑完适合批量小改动。任务清单别写太泛每条要具体到文件和预期结果否则它容易跑偏。