简介这份源码资料面向希望借助AI提升编码效率的开发者尤其是对Claude Code感兴趣、想快速上手这一AI编程助手的初中级程序员。内容围绕代码理解、生成、调试优化、多语言互转与重构等核心场景展开帮助读者建立从访问方式到实战集成的完整认知。资源包共3个文件以inscode工程配置、html页面和gitignore忽略规则为主压缩后约6KB体量轻巧便于快速导入与查阅。目前已有653人学习下载说明其在AI编程工具圈内具备一定关注度。通过这份资料读者可系统了解Claude Code与ChatGPT Code Interpreter的差异、常见问题解答及集成思路并借助源码结构快速验证与二次开发为日常开发流程引入更高效的AI辅助方案。1. Claude Code 完全指南从源码视角拆开一个终端 Agent 的真实骨架很多人第一次听到 Claude Code以为它只是「把 Claude 塞进终端」。真跑起来才发现它干的事情远比聊天复杂读文件、改代码、执行命令、跑测试、根据报错自己回滚重试。标题里带「源码」两个字意思不是让你去背某份官方仓库的目录树而是说这个工具的行为逻辑是可以被拆开看的——它的工具调用协议、上下文管理、权限确认、会话状态全都有迹可循。这篇笔记面向两类人一类是刚装完 Claude Code、只会敲claude然后发呆的新手另一类是想搞清楚它到底怎么调度终端、怎么接第三方模型、怎么在 VS Code 里跑通的老手。我会按「它是什么 → 怎么装怎么接 → 源码级行为怎么理解 → 坑在哪 → 怎么验证」的顺序讲能抄的命令和配置都给你边界和翻车点也一并说清。2. 装之前先想清楚Claude Code 的运行形态与接入方式2.1 它到底是 CLI、插件还是桌面程序Claude Code 目前最常见的三种形态终端 CLI、VS Code 扩展、以及桌面客户端。三者共享同一套核心能力但触发方式不同。CLI 是最接近「源码行为」的形态因为你能直接看到它每一步的工具调用和权限询问VS Code 扩展把同样的能力嵌进编辑器方便你在当前工作区里直接让它改文件桌面版更偏向开箱即用适合不想折腾终端的人。从工程角度看CLI 形态最值得先跑通原因有三点第一它的输入输出是纯文本流方便你观察它什么时候读文件、什么时候执行命令第二它的配置项模型、API 地址、权限模式都能通过环境变量或配置文件覆盖接第三方模型时最灵活第三出问题时日志最完整不像 GUI 那样把错误吞掉。提示如果你只是想体验桌面版最快但如果你想搞清楚「源码级」行为先把 CLI 跑通再考虑插件。2.2 安装路径macOS、Ubuntu、Windows 各走哪条路安装方式取决于你的系统。常见做法是用 Node.js 生态的包管理器或者官方提供的安装脚本。下面给的是通用思路具体命令以你拿到的安装说明为准。macOS 上如果你已经有 Node.js 环境最直接的是用 npm 全局安装# 确认 Node 版本Claude Code 一般要求较新的 LTS node -v # 全局安装 CLI npm install -g anthropic-ai/claude-code # 验证是否装好 claude --versionUbuntu 上流程类似但要注意权限和 PATH。如果你用sudo npm install -g有时会出现全局 bin 目录不在当前用户 PATH 里的情况# 查看 npm 全局前缀 npm config get prefix # 如果 prefix 是 /usr/local确认 /usr/local/bin 在 PATH 中 echo $PATH # 安装后如果 claude 命令找不到手动软链或重开 shell which claudeWindows 上建议在 WSL2 里跑原生 PowerShell 也能装但路径分隔符和权限模型容易让工具调用出玄学问题。装完后第一件事不是急着改代码而是进一个空目录跑一次claude看它能不能正常启动、能不能识别当前工作区。2.3 接第三方模型环境变量与配置文件怎么改Claude Code 默认走官方模型但很多人想接 DeepSeek、Qwen、GLM 这类模型来降成本或做本地化。常见做法是通过环境变量覆盖 API 端点和密钥。不同版本的变量名可能不同但思路一致一个指向 base URL一个放 API key一个指定模型名。# 示例通过环境变量指向兼容 OpenAI 协议的第三方端点 export ANTHROPIC_BASE_URLhttps://your-endpoint.example.com/v1 export ANTHROPIC_API_KEYyour-key-here export ANTHROPIC_MODELyour-model-name # 启动时确认它读到了配置 claude --help这里的关键不是变量名本身而是你要确认三件事端点是否兼容 Anthropic 的消息格式、模型是否支持工具调用tool use、返回的流式格式是否被正确解析。很多「接上了但一直报错」的情况根源是第三方端点只兼容了聊天补全没兼容工具调用协议。判断方法很简单让它执行一个需要读文件的任务如果它只会聊天不会动手就是工具调用没通。注意接第三方模型时权限确认和命令执行仍然由本地 CLI 控制模型只负责决策不负责实际执行。这一点对理解后面的「源码行为」很关键。3. 源码视角Claude Code 的工具调用循环是怎么转起来的3.1 一次任务从输入到执行中间经过了什么把 Claude Code 当成一个循环来看它每一轮大致做四件事收集上下文当前目录、打开的文件、历史对话、把上下文和用户输入发给模型、解析模型返回的工具调用请求、在本地执行工具并把结果回填。这个循环会一直转到模型认为任务完成或者触发权限拒绝、超时、轮次上限。所谓「源码视角」就是你要意识到模型本身不碰你的文件系统它只是输出一个结构化的「我想读某个文件」或「我想执行某条命令」。真正动手的是本地运行时。这个设计决定了三件事第一权限控制点在本地不在模型第二你可以通过拦截工具调用来做审计第三模型的能力上限受限于你给它开放了哪些工具。3.2 工具调用的数据结构长什么样虽然拿不到官方源码但工具调用的结构是可以从行为反推的。一次典型的工具调用请求至少包含工具名、参数对象、以及一个用于匹配结果的调用 ID。下面用伪代码表示这个结构帮你理解它为什么能串起来# 伪代码模拟一次工具调用请求与结果回填 tool_call { id: call_abc123, name: read_file, arguments: { path: ./src/main.py, start_line: 1, end_line: 50 } } # 本地运行时执行后把结果按 id 回填 tool_result { id: call_abc123, content: ...文件内容..., is_error: False }逻辑说明id是关联请求和结果的唯一键缺了它模型就不知道哪条结果对应哪次调用。name决定本地运行时去调哪个执行器。arguments是模型生成的参数本地要做校验——比如路径是否越界、行号是否合法。参数说明path一般是相对工作区的路径start_line/end_line用于大文件分段读取避免一次性塞爆上下文。理解这个结构后你就能明白为什么「让它读一个超大文件」经常失败不是模型不想读是上下文窗口和分段策略在限制。3.3 权限确认与自动执行怎么在安全和效率之间取舍Claude Code 默认会在执行命令或写文件前问你一句。这个确认机制就是本地运行时在工具调用链上加的一道闸。你可以选择每次都确认、只对危险操作确认、或者全自动。全自动很爽但在不熟悉的仓库里跑一次误删或误改就够你喝一壶。常见做法是分场景配置在个人沙箱项目里开自动执行在公司仓库里保持确认。如果你要接第三方模型更建议保持确认因为不同模型对「什么算危险命令」的判断差异很大。判断标准可以简单点涉及rm、git reset、chmod、写系统目录的一律手动确认。提示权限模式通常可以通过启动参数或配置文件调整具体开关名以你所用版本为准。不要为了省事在重要仓库里长期开全自动。4. 在 VS Code 与终端之间打通配置、调试与日常用法4.1 VS Code 扩展怎么装、怎么和 CLI 共享配置VS Code 里装 Claude Code 扩展通常是在扩展市场搜索安装然后在命令面板里触发。它和 CLI 共享同一套底层能力但工作区上下文由编辑器提供——比如当前打开的文件、选中的代码段、终端输出。这意味着在 VS Code 里让它改代码比在纯 CLI 里更精准因为它知道你在看哪一段。配置上扩展一般会读取和 CLI 相同的环境变量或配置文件。如果你已经在终端里配好了第三方模型扩展通常能直接复用。装完后建议先做一个最小验证打开一个测试文件让它「把当前文件的某个函数改名」看它是否能正确定位并修改。4.2 让它在终端里直接执行命令的正确姿势Claude Code 的一个核心能力是直接执行终端命令。很多人第一次用会紧张它会不会乱跑命令答案是执行前通常有确认而且你可以通过提示词约束它。比如你可以明确说「只允许运行测试命令不要改任何文件」它会在工具调用层面遵守这个约束。一个实用的日常用法是让它先跑测试根据失败输出定位问题再改代码再跑一遍。这个循环里命令执行和文件修改是交替的。你可以通过观察它的工具调用顺序判断它是不是在瞎试。如果它连续多次执行同一条失败命令而不改代码说明上下文里缺少关键信息这时候你应该手动补一句报错细节。# 示例在项目里让它先跑测试再改代码 claude 运行 pytest如果失败定位失败原因并修复修完再跑一遍逻辑说明这条提示词把「执行—观察—修改—验证」的循环明确交给它减少它自由发挥的空间。参数说明命令里的测试框架名要换成你项目实际用的比如npm test、go test ./...。4.3 会话状态与上下文管理为什么它有时候会「忘事」Claude Code 的会话是有状态的但状态不是无限的。当对话轮次变多、读入的文件变大早期内容会被压缩或丢弃。这就是为什么它有时候会忘记你前面说过的约束。应对方法有两个一是把关键约束写进项目根目录的说明文件比如CLAUDE.md这类约定文件让它每轮都能读到二是在长任务里主动重述关键要求。从源码视角看上下文管理是运行时在拼装请求时做的裁剪。你看到的「忘事」本质是裁剪策略把某些内容挤出去了。理解这一点你就不会指望它记住所有细节而是会把重要信息放在它每轮都能看到的地方。5. 避坑与排查接第三方模型、权限、路径的高频翻车点5.1 接上第三方模型后只会聊天不会动手现象配置好第三方端点后它能正常对话但让它读文件或执行命令时它只回复文字不触发工具调用。原因第三方端点只兼容了基础聊天协议没有实现工具调用tool use的返回格式。模型即使想调用工具返回的结构也不被本地运行时识别。解决确认端点是否声明支持工具调用如果不支持换一个兼容的端点或者在提示词里明确要求它输出特定格式再由你自己解析。最稳妥的是先用官方模型验证工具调用链路是通的再换第三方。5.2 安装后命令找不到或版本混乱现象npm install -g之后终端里敲claude提示 command not found或者找到的是旧版本。原因npm 全局 bin 目录不在 PATH 里或者系统里存在多个 Node 版本装到了另一个版本下面。解决用npm config get prefix找到全局目录确认它在 PATH 中用which -a claude看是否存在多个必要时用 nvm 统一 Node 版本后重装。5.3 在 VS Code 里改文件改错位置现象让它改某个函数结果它改了同名文件或错误路径下的文件。原因工作区里有多个同名文件或者它读取的上下文里路径不明确。解决在提示词里给出相对工作区的完整路径改完后用git diff检查改动范围确认没有误伤。养成改完就看 diff 的习惯比事后后悔强。5.4 自动执行模式下误跑危险命令现象开了自动执行后它跑了一条你没预期的命令比如批量删除或重置。原因权限闸被关掉模型对危险命令的判断又不够保守。解决在重要仓库里保持确认模式如果必须自动先用git stash或提交当前改动给自己留后悔药把危险命令加入拒绝列表如果版本支持。5.5 长任务中途上下文丢失导致重复劳动现象任务跑到一半它开始重复之前已经做过的事或者忘记已经改过的文件。原因上下文被裁剪早期信息丢失。解决把关键约束和已完成步骤写进项目说明文件在长任务里分阶段确认每完成一个阶段就让它复述当前状态必要时开新会话并手动带上摘要。6. 验证一个 Agent 是否真的在按你的意图工作三个可复现的检查技巧第一个技巧是「工具调用审计」。你不需要读源码只需要在它执行时观察它调用了哪些工具、参数是什么。如果它声称改了文件但你没看到写文件调用那它就是在编。这个检查能过滤掉大部分「假装干活」的情况。第二个技巧是「最小复现仓库」。准备一个只有几个文件的小项目里面放一个明显的 bug让它修。观察它是否先读文件、再定位、再改、再验证。如果它跳过读文件直接改说明它在猜结果不可信。这个技巧的好处是成本低、可重复适合在接新模型时做准入测试。第三个技巧是「回滚验证」。在让它做任何修改前先提交一次。改完后用git diff看改动用git checkout能一键回滚。这不仅是验证手段也是安全网。我自己的习惯是只要它要动超过一个文件先提交只要它要跑命令先确认当前分支是干净的。检查项观察点通过标准工具调用是否有读文件、写文件、执行命令的调用记录声称的动作与实际调用一致最小复现小项目里能否定位并修复已知 bug先读后改改完能验证回滚验证git diff 是否只包含预期改动无意外文件被改这三个技巧不需要你懂内部实现但能让你判断一个 Agent 是不是在认真干活。我踩过的最大坑就是早期太信任它的文字描述后来养成「看调用、看 diff、留提交」的习惯翻车次数明显下降。希望帮到你。本文还有配套的精品资源点击获取 Claude Code 源码级拆解：终端 Agent 工具调用与第三方模型接入指南
简介这份源码资料面向希望借助AI提升编码效率的开发者尤其是对Claude Code感兴趣、想快速上手这一AI编程助手的初中级程序员。内容围绕代码理解、生成、调试优化、多语言互转与重构等核心场景展开帮助读者建立从访问方式到实战集成的完整认知。资源包共3个文件以inscode工程配置、html页面和gitignore忽略规则为主压缩后约6KB体量轻巧便于快速导入与查阅。目前已有653人学习下载说明其在AI编程工具圈内具备一定关注度。通过这份资料读者可系统了解Claude Code与ChatGPT Code Interpreter的差异、常见问题解答及集成思路并借助源码结构快速验证与二次开发为日常开发流程引入更高效的AI辅助方案。1. Claude Code 完全指南从源码视角拆开一个终端 Agent 的真实骨架很多人第一次听到 Claude Code以为它只是「把 Claude 塞进终端」。真跑起来才发现它干的事情远比聊天复杂读文件、改代码、执行命令、跑测试、根据报错自己回滚重试。标题里带「源码」两个字意思不是让你去背某份官方仓库的目录树而是说这个工具的行为逻辑是可以被拆开看的——它的工具调用协议、上下文管理、权限确认、会话状态全都有迹可循。这篇笔记面向两类人一类是刚装完 Claude Code、只会敲claude然后发呆的新手另一类是想搞清楚它到底怎么调度终端、怎么接第三方模型、怎么在 VS Code 里跑通的老手。我会按「它是什么 → 怎么装怎么接 → 源码级行为怎么理解 → 坑在哪 → 怎么验证」的顺序讲能抄的命令和配置都给你边界和翻车点也一并说清。2. 装之前先想清楚Claude Code 的运行形态与接入方式2.1 它到底是 CLI、插件还是桌面程序Claude Code 目前最常见的三种形态终端 CLI、VS Code 扩展、以及桌面客户端。三者共享同一套核心能力但触发方式不同。CLI 是最接近「源码行为」的形态因为你能直接看到它每一步的工具调用和权限询问VS Code 扩展把同样的能力嵌进编辑器方便你在当前工作区里直接让它改文件桌面版更偏向开箱即用适合不想折腾终端的人。从工程角度看CLI 形态最值得先跑通原因有三点第一它的输入输出是纯文本流方便你观察它什么时候读文件、什么时候执行命令第二它的配置项模型、API 地址、权限模式都能通过环境变量或配置文件覆盖接第三方模型时最灵活第三出问题时日志最完整不像 GUI 那样把错误吞掉。提示如果你只是想体验桌面版最快但如果你想搞清楚「源码级」行为先把 CLI 跑通再考虑插件。2.2 安装路径macOS、Ubuntu、Windows 各走哪条路安装方式取决于你的系统。常见做法是用 Node.js 生态的包管理器或者官方提供的安装脚本。下面给的是通用思路具体命令以你拿到的安装说明为准。macOS 上如果你已经有 Node.js 环境最直接的是用 npm 全局安装# 确认 Node 版本Claude Code 一般要求较新的 LTS node -v # 全局安装 CLI npm install -g anthropic-ai/claude-code # 验证是否装好 claude --versionUbuntu 上流程类似但要注意权限和 PATH。如果你用sudo npm install -g有时会出现全局 bin 目录不在当前用户 PATH 里的情况# 查看 npm 全局前缀 npm config get prefix # 如果 prefix 是 /usr/local确认 /usr/local/bin 在 PATH 中 echo $PATH # 安装后如果 claude 命令找不到手动软链或重开 shell which claudeWindows 上建议在 WSL2 里跑原生 PowerShell 也能装但路径分隔符和权限模型容易让工具调用出玄学问题。装完后第一件事不是急着改代码而是进一个空目录跑一次claude看它能不能正常启动、能不能识别当前工作区。2.3 接第三方模型环境变量与配置文件怎么改Claude Code 默认走官方模型但很多人想接 DeepSeek、Qwen、GLM 这类模型来降成本或做本地化。常见做法是通过环境变量覆盖 API 端点和密钥。不同版本的变量名可能不同但思路一致一个指向 base URL一个放 API key一个指定模型名。# 示例通过环境变量指向兼容 OpenAI 协议的第三方端点 export ANTHROPIC_BASE_URLhttps://your-endpoint.example.com/v1 export ANTHROPIC_API_KEYyour-key-here export ANTHROPIC_MODELyour-model-name # 启动时确认它读到了配置 claude --help这里的关键不是变量名本身而是你要确认三件事端点是否兼容 Anthropic 的消息格式、模型是否支持工具调用tool use、返回的流式格式是否被正确解析。很多「接上了但一直报错」的情况根源是第三方端点只兼容了聊天补全没兼容工具调用协议。判断方法很简单让它执行一个需要读文件的任务如果它只会聊天不会动手就是工具调用没通。注意接第三方模型时权限确认和命令执行仍然由本地 CLI 控制模型只负责决策不负责实际执行。这一点对理解后面的「源码行为」很关键。3. 源码视角Claude Code 的工具调用循环是怎么转起来的3.1 一次任务从输入到执行中间经过了什么把 Claude Code 当成一个循环来看它每一轮大致做四件事收集上下文当前目录、打开的文件、历史对话、把上下文和用户输入发给模型、解析模型返回的工具调用请求、在本地执行工具并把结果回填。这个循环会一直转到模型认为任务完成或者触发权限拒绝、超时、轮次上限。所谓「源码视角」就是你要意识到模型本身不碰你的文件系统它只是输出一个结构化的「我想读某个文件」或「我想执行某条命令」。真正动手的是本地运行时。这个设计决定了三件事第一权限控制点在本地不在模型第二你可以通过拦截工具调用来做审计第三模型的能力上限受限于你给它开放了哪些工具。3.2 工具调用的数据结构长什么样虽然拿不到官方源码但工具调用的结构是可以从行为反推的。一次典型的工具调用请求至少包含工具名、参数对象、以及一个用于匹配结果的调用 ID。下面用伪代码表示这个结构帮你理解它为什么能串起来# 伪代码模拟一次工具调用请求与结果回填 tool_call { id: call_abc123, name: read_file, arguments: { path: ./src/main.py, start_line: 1, end_line: 50 } } # 本地运行时执行后把结果按 id 回填 tool_result { id: call_abc123, content: ...文件内容..., is_error: False }逻辑说明id是关联请求和结果的唯一键缺了它模型就不知道哪条结果对应哪次调用。name决定本地运行时去调哪个执行器。arguments是模型生成的参数本地要做校验——比如路径是否越界、行号是否合法。参数说明path一般是相对工作区的路径start_line/end_line用于大文件分段读取避免一次性塞爆上下文。理解这个结构后你就能明白为什么「让它读一个超大文件」经常失败不是模型不想读是上下文窗口和分段策略在限制。3.3 权限确认与自动执行怎么在安全和效率之间取舍Claude Code 默认会在执行命令或写文件前问你一句。这个确认机制就是本地运行时在工具调用链上加的一道闸。你可以选择每次都确认、只对危险操作确认、或者全自动。全自动很爽但在不熟悉的仓库里跑一次误删或误改就够你喝一壶。常见做法是分场景配置在个人沙箱项目里开自动执行在公司仓库里保持确认。如果你要接第三方模型更建议保持确认因为不同模型对「什么算危险命令」的判断差异很大。判断标准可以简单点涉及rm、git reset、chmod、写系统目录的一律手动确认。提示权限模式通常可以通过启动参数或配置文件调整具体开关名以你所用版本为准。不要为了省事在重要仓库里长期开全自动。4. 在 VS Code 与终端之间打通配置、调试与日常用法4.1 VS Code 扩展怎么装、怎么和 CLI 共享配置VS Code 里装 Claude Code 扩展通常是在扩展市场搜索安装然后在命令面板里触发。它和 CLI 共享同一套底层能力但工作区上下文由编辑器提供——比如当前打开的文件、选中的代码段、终端输出。这意味着在 VS Code 里让它改代码比在纯 CLI 里更精准因为它知道你在看哪一段。配置上扩展一般会读取和 CLI 相同的环境变量或配置文件。如果你已经在终端里配好了第三方模型扩展通常能直接复用。装完后建议先做一个最小验证打开一个测试文件让它「把当前文件的某个函数改名」看它是否能正确定位并修改。4.2 让它在终端里直接执行命令的正确姿势Claude Code 的一个核心能力是直接执行终端命令。很多人第一次用会紧张它会不会乱跑命令答案是执行前通常有确认而且你可以通过提示词约束它。比如你可以明确说「只允许运行测试命令不要改任何文件」它会在工具调用层面遵守这个约束。一个实用的日常用法是让它先跑测试根据失败输出定位问题再改代码再跑一遍。这个循环里命令执行和文件修改是交替的。你可以通过观察它的工具调用顺序判断它是不是在瞎试。如果它连续多次执行同一条失败命令而不改代码说明上下文里缺少关键信息这时候你应该手动补一句报错细节。# 示例在项目里让它先跑测试再改代码 claude 运行 pytest如果失败定位失败原因并修复修完再跑一遍逻辑说明这条提示词把「执行—观察—修改—验证」的循环明确交给它减少它自由发挥的空间。参数说明命令里的测试框架名要换成你项目实际用的比如npm test、go test ./...。4.3 会话状态与上下文管理为什么它有时候会「忘事」Claude Code 的会话是有状态的但状态不是无限的。当对话轮次变多、读入的文件变大早期内容会被压缩或丢弃。这就是为什么它有时候会忘记你前面说过的约束。应对方法有两个一是把关键约束写进项目根目录的说明文件比如CLAUDE.md这类约定文件让它每轮都能读到二是在长任务里主动重述关键要求。从源码视角看上下文管理是运行时在拼装请求时做的裁剪。你看到的「忘事」本质是裁剪策略把某些内容挤出去了。理解这一点你就不会指望它记住所有细节而是会把重要信息放在它每轮都能看到的地方。5. 避坑与排查接第三方模型、权限、路径的高频翻车点5.1 接上第三方模型后只会聊天不会动手现象配置好第三方端点后它能正常对话但让它读文件或执行命令时它只回复文字不触发工具调用。原因第三方端点只兼容了基础聊天协议没有实现工具调用tool use的返回格式。模型即使想调用工具返回的结构也不被本地运行时识别。解决确认端点是否声明支持工具调用如果不支持换一个兼容的端点或者在提示词里明确要求它输出特定格式再由你自己解析。最稳妥的是先用官方模型验证工具调用链路是通的再换第三方。5.2 安装后命令找不到或版本混乱现象npm install -g之后终端里敲claude提示 command not found或者找到的是旧版本。原因npm 全局 bin 目录不在 PATH 里或者系统里存在多个 Node 版本装到了另一个版本下面。解决用npm config get prefix找到全局目录确认它在 PATH 中用which -a claude看是否存在多个必要时用 nvm 统一 Node 版本后重装。5.3 在 VS Code 里改文件改错位置现象让它改某个函数结果它改了同名文件或错误路径下的文件。原因工作区里有多个同名文件或者它读取的上下文里路径不明确。解决在提示词里给出相对工作区的完整路径改完后用git diff检查改动范围确认没有误伤。养成改完就看 diff 的习惯比事后后悔强。5.4 自动执行模式下误跑危险命令现象开了自动执行后它跑了一条你没预期的命令比如批量删除或重置。原因权限闸被关掉模型对危险命令的判断又不够保守。解决在重要仓库里保持确认模式如果必须自动先用git stash或提交当前改动给自己留后悔药把危险命令加入拒绝列表如果版本支持。5.5 长任务中途上下文丢失导致重复劳动现象任务跑到一半它开始重复之前已经做过的事或者忘记已经改过的文件。原因上下文被裁剪早期信息丢失。解决把关键约束和已完成步骤写进项目说明文件在长任务里分阶段确认每完成一个阶段就让它复述当前状态必要时开新会话并手动带上摘要。6. 验证一个 Agent 是否真的在按你的意图工作三个可复现的检查技巧第一个技巧是「工具调用审计」。你不需要读源码只需要在它执行时观察它调用了哪些工具、参数是什么。如果它声称改了文件但你没看到写文件调用那它就是在编。这个检查能过滤掉大部分「假装干活」的情况。第二个技巧是「最小复现仓库」。准备一个只有几个文件的小项目里面放一个明显的 bug让它修。观察它是否先读文件、再定位、再改、再验证。如果它跳过读文件直接改说明它在猜结果不可信。这个技巧的好处是成本低、可重复适合在接新模型时做准入测试。第三个技巧是「回滚验证」。在让它做任何修改前先提交一次。改完后用git diff看改动用git checkout能一键回滚。这不仅是验证手段也是安全网。我自己的习惯是只要它要动超过一个文件先提交只要它要跑命令先确认当前分支是干净的。检查项观察点通过标准工具调用是否有读文件、写文件、执行命令的调用记录声称的动作与实际调用一致最小复现小项目里能否定位并修复已知 bug先读后改改完能验证回滚验证git diff 是否只包含预期改动无意外文件被改这三个技巧不需要你懂内部实现但能让你判断一个 Agent 是不是在认真干活。我踩过的最大坑就是早期太信任它的文字描述后来养成「看调用、看 diff、留提交」的习惯翻车次数明显下降。希望帮到你。本文还有配套的精品资源点击获取