1. 为什么我把 Claude Code 当成项目里的“常驻搭档”Claude Code 是 Anthropic 推出的终端编码智能体它跟编辑器里那种“选中一段代码再问一句”的补全工具不一样它直接跑在你的项目目录里能读文件、能改代码、能执行命令还能按你给的规划一步步推进。适合谁适合已经有一定项目经验、想让 AI 真正参与“从需求到提交”全流程的开发者尤其是手里有多个模块、多个代码库、需要跨文件改动的人。我最初也是抱着试试看的心态在本地一个前后端分离的项目里跑了一遍。结果发现真正决定效率高低的不是模型本身而是你有没有把项目记忆、规划模式和分工机制这三件事配好。CLAUDE.MD 负责让 Claude 记住“这个项目是什么样”Plan Mode 负责让它先想清楚再动手Subagents 负责把大任务拆开并行推进。这三块拼起来才是一套能反复用的骨架。这篇就按九步走每一步都给出可复制的配置和验证动作。你不需要一次性全用上但建议至少把 CLAUDE.MD 和 Plan Mode 跑通再考虑 Subagents。2. 前置准备TaoToken 接入与 Claude Code 环境Claude Code 本身是一个终端工具它需要调用模型 API。我这边用的是 TaoToken 提供的接入方式官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是帮你把模型调用统一到一个入口省去自己维护多个密钥的麻烦。先拿到 API Key。打开 https://taotoken.net/api-keys 创建一个新密钥复制下来。注意这个 Key 只显示一次丢了就得重建。然后在终端里设置环境变量。macOS 或 Linux 用export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的KeyWindows PowerShell 用$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的Key如果你想让配置持久化可以写进~/.bashrc或~/.zshrcWindows 则用系统环境变量面板。设置完执行echo $ANTHROPIC_BASE_URL确认输出正确。接着安装 Claude Code。官方推荐用 npm 全局安装npm install -g anthropic-ai/claude-code装完在项目根目录输入claude如果能看到交互界面说明环境通了。第一次启动它会让你确认一些权限按提示走即可。注意API Key 不要提交到 Git 仓库建议放在.env里并加入.gitignore。3. 九步配置骨架从 CLAUDE.MD 到 Subagents3.1 第一步用 /init 生成 CLAUDE.MD 初稿进入项目目录启动claude然后输入/initClaude 会扫描你的项目结构生成一个CLAUDE.MD文件。这个文件就是项目的“记忆卡”后续每次对话它都会参考。初稿通常包含项目概述、目录结构、常用命令。但初稿往往太泛需要你手动补关键信息。3.2 第二步补全 CLAUDE.MD 模板我实测下来一个能用的 CLAUDE.MD 至少要有这几块项目定位、技术栈、目录约定、编码规范、常用命令、禁区。下面是我在用的模板你可以直接复制改# 项目名称 ## 项目定位 一句话说明这个项目做什么面向谁。 ## 技术栈 - 前端React 18 TypeScript Vite - 后端Node.js 20 Express PostgreSQL - 测试Vitest Supertest ## 目录约定 - src/componentsUI 组件每个组件一个文件夹 - src/api接口封装统一走 request.ts - src/utils纯函数工具不依赖 React ## 编码规范 - 所有导出函数必须写 JSDoc - 禁止使用 any用 unknown 加类型守卫 - 提交前必须跑 npm run lint 和 npm run test ## 常用命令 - 开发npm run dev - 构建npm run build - 测试npm run test - 迁移npm run migrate ## 禁区 - 不要直接改 migrations 目录下的历史文件 - 不要在生产配置里硬编码密钥写完保存下次启动 Claude Code 它会自动读取。这一步的验证动作在对话里问“这个项目用什么测试框架”它应该能答出 Vitest。3.3 第三步开启 Plan ModePlan Mode 是 Claude Code 的核心开关快捷键是ShiftTab。开启后你提需求它不会直接改代码而是先给一份行动方案包括要改哪些文件、每步做什么、有什么风险。你审查确认后它才执行。我试过在没开 Plan Mode 的情况下让它改一个跨三个文件的接口结果它改了两个就停了第三个忘了。开了 Plan Mode 之后它会先把三个文件列出来我确认后再动手一次过。验证动作开启 Plan Mode输入“给用户列表加一个分页参数”看它是否先输出方案而不是直接改文件。3.4 第四步配置 settings.json 骨架Claude Code 支持项目级配置放在.claude/settings.json。这个文件控制权限、工具白名单、环境变量。下面是我用的骨架{ permissions: { allow: [ Read, Glob, Grep, Edit, Bash(npm run lint), Bash(npm run test) ], deny: [ Bash(rm -rf *), Bash(git push --force) ] }, env: { NODE_ENV: development } }allow里放你信任的操作deny里放危险命令。这样 Claude 执行时不会每次都问你但危险动作会被拦住。验证动作故意让它执行rm -rf node_modules看是否被拒绝。3.5 第五步用 Git 做检查点Claude Code 没有内置的“恢复检查点”功能所以 Git 就是你的安全网。我的习惯是每次 Claude 完成一个可用的改动立刻 commit。不满意就git checkout -- .回退。git add -A git commit -m claude: 完成用户列表分页如果改坏了git checkout -- .或者回退到上一个 commitgit reset --hard HEAD~1验证动作让 Claude 改一个文件commit再让它改坏然后 checkout 回退确认文件恢复。3.6 第六步拖拽截图沟通Claude Code 的终端界面支持拖拽图片。遇到报错或者要还原 UI 设计稿直接把截图拖进去它能理解图像内容。我试过把一个复杂的报错截图拖进去它直接定位到是某个依赖版本冲突比我自己翻日志快得多。验证动作截一张报错图拖进终端问“这个错误怎么修”。3.7 第七步多代码库上下文全栈项目里前端和后端往往是两个文件夹。你可以在启动 Claude Code 时把两个目录都加进去claude --add-dir ../backend --add-dir ../frontend这样它能同时看到两边的代码跨库改接口时不会只改一边。验证动作让它“把后端返回的字段名同步到前端类型定义”看它是否两边都改。3.8 第八步Subagents 并行处理Subagents 是 Claude Code 的分工机制。对于大任务你可以让它拆成多个子任务每个子任务由一个子智能体处理。比如整个项目的代码迁移可以按模块拆开。在对话里输入请把这个迁移任务拆成三个子任务分别处理 auth、user、order 模块并行执行。它会生成多个子智能体各自负责一块。验证动作观察终端是否出现多个任务进度条最后汇总结果。3.9 第九步让 Claude 自检并人工审查任务完成后别急着 commit。先让它自检请检查刚才的改动找出潜在的 bug 和边缘情况。它有时能发现你忽略的细节比如空数组、并发写入、时区问题。但最重要的一点永远亲自审查 AI 生成的代码。把它当成一个速度极快但经验尚浅的初级开发者它的产出必须经过你的 Code Review。验证动作让它自检后你自己再读一遍 diff确认逻辑正确。4. 验证请求跑通一次完整流程配置完之后用一个小需求验证整条链路。比如“给用户列表加一个按注册时间排序的功能”。第一步开启 Plan Mode输入需求。Claude 输出方案改src/api/user.ts加排序参数改src/components/UserList.tsx加排序按钮改src/utils/sort.ts加排序函数。第二步你确认方案它执行。执行完你跑npm run test看测试是否通过。第三步让它自检你审查 diff然后 commit。第四步如果想验证模型对话能力可以打开 https://taotoken.net/api 的模型对话入口直接问它“刚才的排序函数有没有边缘情况”它会基于上下文回答。整个流程跑通一次你就有了可复用的骨架。后面每个需求都按这个节奏走。5. 常见报错排查5.1 启动时报 ANTHROPIC_API_KEY 未设置说明环境变量没生效。检查echo $ANTHROPIC_API_KEY是否有输出。如果没有重新 export 或者写进 shell 配置文件。Windows 注意 PowerShell 和 CMD 的语法不同。5.2 CLAUDE.MD 不生效确认文件在项目根目录文件名大小写正确。Claude Code 只读根目录的CLAUDE.MD子目录里的不会自动加载。如果改了没反应重启一次claude。5.3 Plan Mode 不触发快捷键是ShiftTab按一次看界面是否出现 “Plan Mode” 标识。如果没反应可能是终端拦截了快捷键换个终端试试。另外确认你的 Claude Code 是最新版本老版本可能不支持。5.4 Subagents 任务卡住子智能体并行时会消耗较多资源。如果卡住先检查网络再检查是否有子任务在等权限确认。可以在 settings.json 里把常用命令加进 allow 列表减少确认次数。5.5 改完代码测试失败先看是不是 Claude 改了测试没改实现或者反过来。让它自检时明确说“请同时检查实现和测试是否一致”。如果还不行用 Git 回退到上一个 commit重新来。5.6 权限被拒绝检查 settings.json 的 deny 列表看是不是误拦了正常命令。比如你把Bash(git *)全禁了那 commit 也会被拦。改成只禁危险操作比如Bash(git push --force)。6. 长期编码与 Agent 协作的下一步如果你打算把 Claude Code 当成日常主力建议把 Coding Plan 用起来地址是 https://taotoken.net/api 的 coding-plan 入口。它适合长期编码和 Agent 协作场景能帮你把多个项目的调用统一管理。接入文档在 https://taotoken.net/api 的 doc 入口里面有完整的参数说明和示例。API Keys 管理在 https://taotoken.net/api-keys 定期轮换密钥是个好习惯。Claude Code 的配置骨架搭好之后真正决定效率的是你的使用节奏小需求直接 Plan Mode 走一遍大任务拆 Subagents每次改动都 commit。这套流程跑顺了你会发现 AI 编码不再是“试试看”而是项目里一个稳定的生产力环节。