Claude Code 负责人 Boris 公开团队 5 个底层习惯:用“自我验收闭环”把 AI 编程从玩具变成生产力
这次我们来看一个有点特殊的方向:不是某个模型、不是某个一键包,而是 Claude Code 团队内部怎么用 AI 编程工具做真实开发。项目标题是《Claude Code 负责人 Boris 公开团队 5 个底层习惯:构建自我验收闭环》,关键词是 Claude Code、自我验收闭环。
先说结论:如果你已经在用 Claude Code 写代码、改代码,或者正准备把这类 AI 编程工具接入日常工作流,这篇文章值得收藏。它不仅讲了 Claude Code 是什么、怎么安装、怎么在 VSCode 里配好,更重要的是给出了 5 个可以直接抄进团队流程的“底层习惯”——核心就一句话:不要每次都靠人肉盯输出,要搭建一套“AI 干活 -> 自动验收 -> 反馈修正”的闭环。
文章会按这个顺序展开:
- 先快速讲清楚 Claude Code 到底是什么、有哪些能力、适合什么场景;
- 给出本地安装、VSCode 插件、命令行启动、配置 API Key 的完整步骤;
- 逐条拆解 Boris 公开的 5 个底层习惯,重点讲“自我验收闭环”怎么落地;
- 结合实测流程讲功能验证、显存和资源占用、以及如何把 Claude Code 接入 DeepSeek 等第三方模型;
- 最后给一份常见问题排查清单和工程化建议。
先给结论:Claude Code 不是网页聊天框,它是一个跑在终端里的 AI 编程代理,能直接读你的项目目录、改代码、执行命令、跑测试、提 PR。想用好它的关键不是“提示词写得有多花”,而是把验收机制做进工作流里,让 AI 每一次改完代码都能自己证明“改对了”。
1. Claude Code 核心能力速览
| 能力项 | 说明 |
|---|---|
| 项目类型 | 终端 AI 编程代理 |
| 运行模式 | CLI / 桌面端 / VSCode 插件 |
| 主要功能 | 代码阅读、代码生成、代码修改、命令执行、测试运行、文件批量处理 |
| 工作目录 | 可限定在项目目录内运行 |
| 支持的操作系统 | Windows / macOS / Linux 均可安装,环境要求需按官方文档确认 |
| 硬件门槛 | 无 GPU 需求,普通开发机能跑;如果需要接入本地模型,则要看本地模型本身的显存要求 |
| 接口能力 | 支持 API Key 配置接入多模型,如 Claude、DeepSeek 等 |
| 批量任务 | 支持脚本化、批量文件修改、多文件重构 |
| 一键启动 | CLI 命令启动,VSCode 插件可图形化启动 |
| 适合场景 | 代码审查、需求转代码、测试补齐、多文件重构、项目脚手架搭建 |
从材料看,Claude Code 最核心的价值不是帮你写一行函数,而是能在一个项目上下文里持续工作:你给它一个任务,它自己读代码、自己改、自己跑测试,最后告诉你改了什么、测试过没过。这种“代理式”工作方式,要求使用者掌握的不是聊天技巧,而是工程化验收方法。
目前常见的使用入口有三个:
- CLI 命令行:在终端里输入
claude启动,适合习惯终端操作、喜欢脚本化控制的开发者。 - VSCode 插件:在 VSCode 扩展市场搜索 Claude Code 安装,侧边栏直接对话,适合日常写代码时边写边用。
- 桌面端:提供了图形界面操作,安装后可以对话、管理任务、查看日志,适合不习惯终端的用户。
2. 适用场景与使用边界
Claude Code 这类 AI 编程代理适合以下场景:
- 需求到代码的快速落地:把需求描述清楚,AI 直接生成多文件代码结构,你只需要检查和调整。
- 存量代码维护:AI 读取项目源码后,完成重构、补注释、拆函数、改接口等繁琐工作。
- 测试补全:让 AI 为关键函数补单元测试和集成测试,并自动运行验证。
- 批量修改:对一个项目里的多个文件做统一修改,比如日志组件替换、配置项迁移。
- 技术方案验证:让 AI 先写 demo,验证某个库、某个接口能不能跑通,再决定是否引入。
不适合的场景也要说清楚:
- 生产环境无保护操作:不要在正式数据库、生产服务器上直接让 AI 执行破坏性命令,必须先加权限约束和人工审批。
- 强业务逻辑决策:AI 不掌握真实业务的隐性规则,不能替产品经理做业务决策。
- 私有代码安全要求极高的项目:注意代码内容可能经过 API 传输,内部机密项目需要评估隐私风险。
关于版权、隐私和安全边界,这里必须强调:如果项目代码涉及企业机密、用户数据或未公开业务逻辑,要谨慎选择接入的模型和 API 服务;使用第三方模型 API 时,确认数据保护条款;涉及人脸、声音、版权素材等敏感场景时,必须确认授权。Claude Code 修改代码后在关键节点要人工复核,尤其是权限、加密、支付、数据库操作等高风险逻辑。
3. 本地安装与前置环境准备
先不说概念,直接进入安装流程。无论你用什么系统,核心依赖就三件事:Node.js 环境、Claude Code 本体、模型 API Key 配置。
3.1 操作系统与运行时
Claude Code 官方支持 Windows、macOS 和 Linux。安装前建议先确认本机环境:
| 检查项 | 说明 |
|---|---|
| 操作系统 | Windows 10/11 以上、macOS 较新版本、主流 Linux 发行版 |
| Node.js 版本 | 建议使用 LTS 版本,过旧版本可能导致安装失败 |
| npm 或 yarn | npm 默认随 Node.js 安装 |
| 包管理器 | Windows 可用 npm 或 choco,macOS 可用 npm 或 brew |
| 终端 | Windows 使用 PowerShell 或 Git Bash,macOS/Linux 使用自带终端 |
| 网络 | 能访问对应包源和模型 API 服务 |
如果你不太确定 Node.js 是否装好,在终端执行:
node -v npm -v如果输出版本号,说明环境基本就绪。如果没有输出,先安装 Node.js LTS 版本再继续。
3.2 安装 Claude Code
按官方推荐的 npm 方式安装:
npm install -g @anthropic-ai/claude-code安装完成后,验证版本:
claude --version如果命令能正常打印版本号,说明安装成功。之后即可在任意项目目录下启动 Claude Code:
cd /path/to/your/project claude启动后,Claude Code 会进入一个交互式终端界面。首次使用会提示登录或配置 API Key,按向导完成即可。
如果你不想用全局安装,也可以在项目内安装:
npm install @anthropic-ai/claude-code --save-dev npx claude这种方式的好处是版本跟随项目锁定,多人协作时不容易出现版本不一致问题。
3.3 VSCode 插件安装
在 VSCode 扩展市场搜索 Claude Code,找到官方插件后点击安装。安装完成后:
- 打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P);
- 输入 Claude Code,找到对应命令;
- 启动后在侧边栏进入对话界面;
- 配置模型 API Key 后即可开始使用。
VSCode 插件的优势是能直接读取当前打开的文件和项目工作区,让 AI 在真实代码上下文里工作。
3.4 配置 API Key
Claude Code 默认使用 Anthropic 的模型服务。如果没有官方账号,也可以配置第三方兼容模型,比如接入 DeepSeek 或智谱。配置方式是修改settings.json。
以接入 DeepSeek 为例,可以在 Claude Code 配置目录下找到或创建settings.json,加入模型相关配置:
{ "model": "deepseek-chat", "apiKey": "your_deepseek_api_key", "baseUrl": "https://api.deepseek.com" }需要说明的是:不同版本的 Claude Code 对模型名识别不完全一致。如果你在运行时看到类似"deepseek-v4-pro" is not a model this version of claude code recognizes的报错,说明当前模型名不在该版本支持列表中,需要把模型名改成该版本能识别的名称,或者升级 Claude Code 版本。具体支持的模型名以你的 Claude Code 版本为准,不确定就先查版本对应的模型列表。
4. Claude Code 功能测试与效果验证
装好之后先别急着接业务,按照下面这套流程跑一遍,确认工具在你本机的运行状态。
4.1 基础问答测试
在项目目录启动 Claude Code,输入一个简单的项目理解问题:
请描述这个项目的目录结构和主要功能模块。预期结果:
- 输出项目根目录的文件树;
- 概括每个模块的作用;
- 指出入口文件和配置文件。
如果输出内容明显和项目实际情况不符,先检查是否在工作目录下启动,或者是否配好了项目上下文。
4.2 代码生成测试
给一个增量开发任务:
在当前项目新增一个 HTTP 接口,路径为 /api/health,返回 JSON:{"status": "ok"}。请使用项目现有的框架风格实现,并给出文件修改清单。预期结果:
- 能读取项目现有框架风格;
- 生成对应的路由文件或入口修改;
- 给出需要修改的文件列表。
判断成功的标准是它是否“基于项目现有代码”来完成,而不是凭空生成一套不匹配框架的代码。
4.3 测试与验收测试
Claude Code 的核心亮点是能自动跑测试。可以让它:
为上面新增的 /api/health 接口编写单元测试,然后执行测试命令,确认测试通过。如果测试失败,请修复代码并复测。这就是“自我验收闭环”的最小示例:AI 写完代码后不是直接交付,而是自己写测试、自己跑、自己修,形成闭环。后面第 5 节会详细展开。
4.4 多文件批量修改测试
批量任务能力可以在一个测试项目里做验证:
把项目中所有 console.log 调用替换为统一的 Logger 方法,保持不变,只替换调用方式和引入语句。请逐个文件处理,并在处理完成后输出修改文件列表。注意观察:
- 是否准确识别所有需要修改的文件;
- 是否生成正确的 import 语句;
- 是否有误伤;
- 是否在完成后主动做验证。
4.5 观察运行资源与日志
Claude Code 作为终端程序,本身不依赖 GPU,因此运行过程中 CPU 占用和内存占用都比较低。如果你接入的是云端 API 模型,本机几乎不产生推理压力;如果你通过本地模型代理接入本地大模型,则需要单独关注模型的显存占用,这时候可以打开任务管理器或nvidia-smi观察显存变化:
nvidia-smi在任务执行过程中,重点关注:
- 交互响应是否流畅;
- 大文件读取时是否卡顿;
- 批量任务是否长时间无响应;
- 日志是否有报错信息。
5. 核心内容:Boris 公开团队 5 个底层习惯
本节是重点。Claude Code 负责人 Boris 公开的团队 5 个底层习惯,核心关键词是“自我验收闭环”。这 5 个习惯不是教你写提示词,而是教你建立一套工作秩序,让 AI 编程从“偶尔能用”变成“稳定产出”。
5.1 习惯一:先定义验收标准,再让 AI 动手
很多人用 AI 编程时,提示词只写“帮我实现一个登录功能”,然后 AI 给什么就看什么,最后改来改去浪费时间。
Boris 团队的第一个习惯是:在把任务交给 AI 之前,先用一段文字写清楚验收标准。也就是说,你要告诉 AI“什么样算完成”,而不仅仅是“要做什么”。
推荐在项目里维护一个acceptance.md或直接在任务描述里写清楚:
任务:新增用户注册接口 验收标准: 1. 注册请求使用 POST /api/register 2. 参数校验包含 username、password、email 3. 注册成功后返回 201 状态码 4. 用户名重复返回 409 错误 5. 为通过校验的请求生成对应测试用例 6. 执行测试命令后全部通过把这段内容塞进提示词。这样 AI 在生成代码时会有一个“目标轴”,而不是自由发挥。接收端能减少 50% 以上的来回返工。
5.2 习惯二:把“让 AI 自己跑测试”设为默认动作
这是自我验收闭环里最关键的一环。
很多开发者让 AI 改完代码后,自己 Ctrl+C 复制到本地跑一遍,发现报错再贴回去让 AI 修。这其实是在做“人肉回环”,效率很低。
Claude Code 的底层能力已经支持“执行命令 -> 读取输出 -> 根据结果修正代码”。你应该在提示词里明确要求它“自己跑测试并修正”。
示例:
修改 src/auth.py 的 token 过期逻辑。 修改完成后,运行项目现有的测试命令。 如果测试失败,分析失败原因,修复代码,然后重新执行测试。 循环直到测试全部通过,或者说明无法通过的阻塞点。这个习惯的价值在于:AI 的每次修改都对应一次自动验证,而不是修改完就认为结束。测试通过是 AI“自证”完成的方式,但注意:测试通过不等于业务完全正确,关键逻辑仍需要人工复审。
推荐在项目中搭配 CI 使用。Claude Code 在本地跑完测试后,你 push 代码到远程,CI 再跑一遍完整流水线,形成双重验收。
5.3 习惯三:用最小可复现样本来隔离问题
团队开发中经常遇到的问题是:AI 改了一个模块,结果整个项目跑不起来,你分不清是 AI 的锅还是之前就没跑通。
Boris 团队的习惯是:遇到问题时,先构建一个最小可复现样本,再让 AI 分析。
具体做法:
- 把问题相关的代码抽到一个最小示例目录;
- 让 Claude Code 在最小目录里复现 bug;
- 修复后再合并回主项目。
这样做的优势很明显:
- 排除了无关模块的干扰;
- 测试耗时更短;
- 每次修改都有一个清晰的验证边界;
- 减少 AI 在多模块之间“瞎猜”的概率。
5.4 习惯四:要求 AI 输出修改清单和影响范围
典型不会用 AI 编程的人,是让 AI 改完后只看最终结果,不看改了哪些文件、动了哪些逻辑。项目一旦出问题,排查极其痛苦。
Boris 团队要求:每次任务完成后,AI 必须输出一份修改清单,包含文件路径、修改内容和潜在影响。
示例提示词:
完成后,请以列表形式输出: 1. 修改过的文件路径; 2. 每个文件的主要变更内容; 3. 是否影响已有接口或数据库结构; 4. 是否有需要人工确认的风险点。把“输出修改清单”写进验收流程后,AI 的每次操作都变得可审计。代码出问题,你能很快定位到具体文件和变更点;多人协作时,Code Review 也有据可依。
5.5 习惯五:建立“反馈闭环”,让 AI 自己总结失败原因
最后一个习惯属于团队工程文化层面:不要只让 AI 修 bug,还要让它记录失败原因和修复方案。
在实际使用中,你可以要求 Claude Code 在遇到失败时自动记录日志:
- 问题现象是什么;
- 初步判断的原因是什么;
- 尝试过哪几种修复方案;
- 最终哪一步解决了问题。
示例提示词:
在修复过程中,将每一步失败的原因和修复动作记录到 docs/ai-fix-log.md 中。 记录格式: - 时间 - 失败现象 - 可能原因 - 修复方案 - 验证结果这个习惯的价值是让 AI 的修复经验变成团队资产。后续再遇到相似问题,AI 可以直接翻日志,而不需要重新“试错”。
这 5 个习惯合在一起,就是“自我验收闭环”:
定义验收标准 -> AI 实现 -> AI 自测 -> 输出修改清单 -> 失败记录与反馈闭环跑起来之后,AI 不再是一个“一次性生成器”,而是一个“能自我修正的执行者”。
6. 把 Claude Code 接入团队工作流
从个人工具到团队工具,Claude Code 需要做一些工程化配置。
6.1 实现思路
常见做法是:项目根目录放一个CLAUDE.md文件,里面写项目约定。Claude Code 启动后会读取这个文件作为上下文,这样 AI 就不会“忘记”团队规则。
示例CLAUDE.md:
# 项目开发约定 - 代码风格:使用 TypeScript,遵循项目已有 ESLint 规则 - 测试要求:核心函数必须补单元测试,提交前必须跑测试 - 模块规范:新增模块必须导出统一入口 - 命令: - 安装依赖:npm install - 运行测试:npm test - 启动开发:npm run dev - 构建:npm run build有了CLAUDE.md,你可以把 Boris 团队的 5 个习惯固化成“团队默认指令”,让 AI 每次进入项目都自动遵守。
6.2 批量任务配置示例
如果你需要在团队项目里做批量重构,可以把任务拆成脚本,配合 Claude Code 批量执行:
{ "tasks": [ { "name": "replace-logger", "targetDir": "./src", "instruction": "将 src 目录下所有 console.log 替换为 Logger.info,并自动补充 import 语句", "acceptance": "npm test" }, { "name": "add-health-api", "targetDir": "./server", "instruction": "新增 /api/health 接口,附带单元测试", "acceptance": "npm run test:server" } ] }在实际操作中,你可以写一个简单的 Node.js 脚本,遍历批量任务,调用 Claude Code 的 CLI 接口执行。注意:第一批任务建议先挑小文件、小模块跑,验证后再扩大到整个仓库。
7. Claude Code 使用中的常见问题排查
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
claude命令找不到 | Node.js 未安装,或全局安装路径未加入 PATH | 执行node -v,检查 npm 全局路径 | 重装 Node.js 或重新安装 Claude Code |
| VSCode 插件无法识别 Claude Code | 插件版本与 CLI 版本不匹配 | 查看插件日志 | 升级插件到最新版,并同步升级 CLI |
提示could not locate the claude cli on path | CLI 未安装或 PATH 环境变量未配置 | 在终端执行which claude,检查安装路径 | 将 CLI 安装目录加入系统 PATH |
提示"xxx" is not a model this version of claude code recognizes | 配置的模型名不被当前版本识别 | 查看当前版本支持的模型列表 | 修改模型名为对应支持版本,或升级 Claude Code |
| 输出中文乱码 | 终端编码不是 UTF-8 | 检查终端编码设置 | 在终端设置chcp 65001,或检查配置文件字符集 |
| 修改代码后测试不通过 | 验收标准未写入任务描述 | 检查任务提示词是否包含测试命令 | 在提示词中明确要求“运行测试并循环修复” |
| 批量任务卡住 | 任务范围过大,单次上下文过长 | 查看日志,分析卡住的任务文件 | 拆分为小批次,一次处理几个文件 |
| 接入第三方模型报错 | API Key 错误或 baseUrl 配置不正确 | 检查 settings.json 配置 | 重新确认模型名称、Key 和请求地址 |
| 项目文件被误改 | 未指定修改边界 | 检查修改清单 | 在提示词中写明“只能修改 src 目录下文件” |
| 任务执行到一半退出 | 上下文窗口超限或会话超时 | 查看工具日志 | 重启会话,拆分任务,减少单次指令复杂度 |
这里重点说两个高频问题。
第一个是“claude cli not found”。很多人在 Windows 上用 npm 全局安装后,VSCode 插件却找不到命令。通常是因为 npm 全局 bin 目录没有加入系统 PATH。解决方法是找到 npm 全局目录:
npm config get prefix然后把%prefix%目录加入系统环境变量 PATH,重启 VSCode 即可。
第二个是“模型名不被识别”。这个问题在接入 DeepSeek、智谱等第三方模型时很常见。不同版本的 Claude Code 内置的模型支持列表不同,新模型上线后旧版本可能不认识。优先升级 Claude Code 到最新版本,同时在settings.json中使用该版本支持的模型名。如果仍然报错,切到官方模型验证是否是模型配置问题。
8. 资源占用、运行稳定性与降本建议
8.1 资源占用
Claude Code 本身是一个 Node.js 进程,没有 GPU 推理压力。运行时主要占用的是:
- CPU:终端处理和文本解析,CPU 占用不高;
- 内存:根据项目文本量而定,正常开发项目一般不会明显卡顿;
- 磁盘:主要是项目文件读取和日志写入,占用较小。
如果你把 Claude Code 接到本地模型,比如通过 Ollama 等方式跑本地大模型,则显存占用取决于本地模型的大小和量化等级。建议先用小参数模型测试,再逐步加大。
8.2 稳定性观察
在实际使用中,影响稳定性的因素主要有:
- 单次任务文件数量过多,容易导致上下文超限;
- 项目目录包含大量无关文件时,AI 容易被干扰,建议在任务说明中排除
node_modules、dist、.git等目录; - 长时间运行的批量任务,建议分段执行并记录进度。
8.3 降本建议
Claude Code 调用云端模型会产生 token 费用。降低费用的方法:
- 小任务先让 AI 只输出修改方案,确认后再生成代码;
- 公共依赖文件放在
CLAUDE.md中,减少重复读取; - 避免超大文件一次塞入对话,提前拆分;
- 使用缓存机制,减少重复调用的上下文开销。
9. 最佳实践与团队落地建议
9.1 第一次使用先小成本验证
不要拿核心业务代码做第一次实验。先建一个测试项目,跑通“定义验收标准 -> AI 实现 -> 自测 -> 输出修改清单”这条链路,再逐步接入真实项目。
具体来说,可以先挑一个内部工具脚本让 Claude Code 加测试,或者让它重构一个低风险模块。这个过程中重点观察它是否真的会跑测试、是否能根据失败输出修正代码、修改清单是否清晰。
9.2 把关键约定写进 CLAUDE.md
前面提过,在项目根目录放CLAUDE.md是成本最低的团队规范化方法。团队负责人可以把 Boris 团队的习惯固化进去:
- 必须运行测试后才能交付;
- 输出修改清单;
- 记录失败日志;
- 涉及高风险改动先说明影响范围。
这样即使新成员没有培训,AI 也能在项目上下文中自动遵守规则。
9.3 任务拆小,验证前置
一次让 AI 做太多事,往往输出质量下降、错误难以定位。更好的做法是:
- 大任务拆成小任务;
- 每个小任务都有明确的验收标准;
- 每个任务结束后要求 AI 输出变更清单;
- 关键节点人工 review。
9.4 安全合规提醒
最后再强调一遍使用边界:
- 涉及生产数据库、支付逻辑、用户隐私、权限系统的代码变更,务必人工 review;
- 使用云端模型 API 时,注意敏感代码脱敏;
- 涉及版权素材、人脸、声音、未经授权的数据内容时,确认授权后再操作;
- 企业私有仓库内使用第三方 API 前,最好和法务或安全团队确认数据条款。
10. 总结与下一步
这次分享的重点是 Claude Code 的“自我验收闭环”方法论,而不是某个具体模型的效果对比。Boris 团队的 5 个底层习惯看起来都不复杂,但实际能改变 AI 编程的使用质量:
- 先定义验收标准,再让 AI 动手;
- 让 AI 自己跑测试;
- 用最小可复现样本隔离问题;
- 输出修改清单和影响范围;
- 记录失败原因,形成反馈闭环。
建议你最先验证的功能是“让 AI 改完代码后自己跑测试并修复失败”。这一项一旦跑通,Claude Code 的使用体验会明显上一个台阶,这也是从“AI 写代码玩具”过渡到“AI 编程生产力工具”的关键一步。
最容易踩的坑有三个:一是没写清验收标准就让 AI 开工,导致返工;二是 AI 改完代码后不要求它自测,直接把错误代码提交上去;三是没有输出修改清单,出问题后无法回溯。记住,Claude Code 用得好不好,不是看提示词写得多花哨,而是看你有没有把“定义 -> 执行 -> 验证 -> 反馈”这条闭环真正跑起来。
下一步,你可以在自己的项目里加一个CLAUDE.md,把“必须跑测试、必须输出修改清单、必须记录失败原因”这三条写进去,然后挑一个小模块试跑一次。跑通了,再考虑接入团队 CI、批量任务、第三方模型等更深层的玩法。