1. 抓包 Claude Code 到底能看见什么一次真实的 ReAct 链路拆解Claude Code 抓包这件事很多人第一次做都会有点懵——明明用的是同一个claude-sonnet-4-6模型、同一套 REST 接口为什么 Claude Code 能在几分钟内重构整个代码库、自动跑测试、提交 PR而自己用 SDK 写的智能助手只会吐出一堆没法直接用的文字我当初的假设也很朴素难道 Anthropic 在底层做了什么特殊优化或者有什么我不知道的工程技巧真正的答案藏在一次抓包之后。用 Proxyman 配好 SSL 证书让 Claude Code 做一个简单的代码审查抓到的请求体长这样{ model: claude-sonnet-4-6, stream: true, thinking: { type: adaptive }, max_tokens: 32000, messages: [ ... ], system: [ ... ], tools: [ ... ] }乍一看没什么特别但把system、tools、messages三个字段展开整个画面就清晰了。所谓魔法其实是若干精心设计的工程细节叠加而成system prompt 里塞进了工作目录、git 状态、CLAUDE.md 规范、当前日期tools 数组暴露了 Read/Edit/Bash/Glob/Grep 等一整套原子化能力messages 里则是tool_use和tool_result成对出现的循环记录。这就是 Agent 工程实现的全貌——不是黑科技是工程。这篇内容聚焦 Claude Code 抓包视角下的 Agent 工程实现围绕 ReAct 循环拆解请求构造、工具调用与响应回传。我会交付可复制的settings.json与config.toml配置骨架并给出用 TaoToken 统一 Key/API 通道接入后的抓包验证动作帮你在本地复现完整链路。适合已经用过 Claude Code、想搞清楚它内部怎么跑的人也适合正在自己写 Agent 但卡在工具调用不稳定这一步的开发者。2. 前置准备用 TaoToken 统一 Key 打通抓包链路抓包最怕的就是请求分散在多个 Key、多个通道上日志对不上号。我试过把 Claude Code、自己写的 Agent、以及几个测试脚本的请求全部收敛到同一个 API 通道抓包时一眼就能看出哪条是 CLI 发的、哪条是脚本发的。TaoToken 在这里的作用就是提供统一的 Key 和 API 通道让所有请求走同一个入口抓包验证时不用来回切换配置。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数配置里直接写死即可。你需要先拿到一个 API Key然后把它填进 Claude Code 的配置里。拿 Key 的路径是登录后进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 创建一个新 Key。创建时建议按用途命名比如claude-code-local、agent-debug这样抓包时从 Key 前缀就能区分请求来源。注意Key 只在创建时完整显示一次复制后立刻存进本地环境变量或配置文件不要硬编码进代码仓库。如果你打算长期跑编码类 Agent 任务可以顺带看一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对高频编码场景做了额度规划比按次调用更划算。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置字段有疑问时对照着看。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层一层是 CLI 自身的settings.json控制模型、API 地址、权限模式另一层是项目级的config.toml或.claude/config.toml控制工具白名单、MCP Server、子代理行为。下面这份骨架可以直接复制把YOUR_TAOTOKEN_KEY替换成你自己的 Key。3.1 settings.jsonCLI 层配置{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: YOUR_TAOTOKEN_KEY, ANTHROPIC_MODEL: claude-sonnet-4-6, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5-20251001 }, permissions: { allow: [ Read, Glob, Grep, Edit, Write, Bash(git status), Bash(git diff:*), Bash(mvn test:*) ], deny: [ Bash(rm -rf:*), Bash(git push --force:*) ] }, includeCoAuthoredBy: false, cleanupPeriodDays: 30 }这里几个字段值得展开说。ANTHROPIC_BASE_URL指向 TaoToken 的 API 基址Claude Code 会把所有请求发到这里抓包时你只需要盯住这一个域名。ANTHROPIC_SMALL_FAST_MODEL指定的是子代理比如 Explore用的轻量模型主对话用 Sonnet探索类任务用 Haiku成本和延迟都能压下来。permissions.allow里我特意把Bash拆成细粒度规则只放行git status、git diff、mvn test这类只读或可逆命令rm -rf和git push --force直接进 deny 列表——这是抓包时观察到的 Claude Code 默认行为它自己也会在 system prompt 里强调破坏性操作前必须确认。3.2 config.toml项目层配置[project] name zeno-agent-debug root /Users/you/IdeaProjects/ZenoAgent [agent] max_iterations 50 tool_timeout_seconds 120 enable_subagents true [agent.subagents.explore] model claude-haiku-4-5-20251001 tools [Read, Glob, Grep] thoroughness medium [agent.subagents.plan] model claude-sonnet-4-6 tools [Read, Glob, Grep] inherit_context true [mcp_servers.filesystem] command npx args [-y, modelcontextprotocol/server-filesystem, /Users/you/IdeaProjects/ZenoAgent] [memory] file MEMORY.md max_lines 200max_iterations是 ReAct 循环的硬上限防止 Agent 在某个工具调用上死循环。tool_timeout_seconds控制单个工具执行的超时Bash 跑测试这种可能耗时的操作要给足。子代理配置里Explore 用 Haiku 做快速扫描Plan 用 Sonnet 做规划这是抓包时从tools数组和model字段反推出来的实际行为。MEMORY.md的max_lines 200对应 Claude Code 只加载前 200 行的策略超出部分会被截断。提示config.toml里的 MCP Server 配置和settings.json的权限是叠加生效的MCP 提供的工具同样受permissions约束。4. 验证请求抓包看 ReAct 循环怎么跑起来配置好之后启动 Claude Code 并让它做一个简单任务比如看看这个项目哪里需要改进。同时在 Proxyman 里开启抓包过滤taotoken.net域名。你会看到一串请求按时间顺序拆开看就是完整的 ReAct 循环。4.1 第一轮请求Think 阶段的上下文组装第一轮请求的messages里user 消息不是单纯的一句话而是多段 content{ role: user, content: [ { type: text, text: system-reminder...技能列表.../system-reminder }, { type: text, text: system-reminder...CLAUDE.md git状态.../system-reminder }, { type: text, text: 帮我看看这个项目哪里需要改进, cache_control: { type: ephemeral } } ] }注意cache_control标记。这是 Anthropic Prompt Caching 的开关作用是把这段内容之前的 KV Cache 存到服务端后续请求只要前缀没变就直接复用费用降到原来的 1/10。Claude Code 在 system prompt 的两段内容和 user 消息的最后一段上都打了这个标记这样角色定义和行为规范可以独立缓存、独立失效。4.2 第二轮请求Act 阶段的工具调用模型返回的 assistant 消息里会出现tool_use{ role: assistant, content: [ { type: thinking, thinking: 让我先看看项目结构... }, { type: tool_use, id: toolu_01ABC, name: Glob, input: { pattern: **/*.java } } ] }thinking块是模型的推理过程tool_use是它决定调用的工具。抓包时你会发现Claude Code 的 system prompt 里明确写了如果有更专用的工具Read、Edit、Grep就不要用 Bash所以模型在选工具时优先挑原子化能力而不是一把梭 Bash。4.3 第三轮请求Observe 阶段的结果回传工具执行完结果作为tool_result追加回 messages{ role: user, content: [ { type: tool_result, tool_use_id: toolu_01ABC, content: 找到 32 个 Java 文件... } ] }然后下一轮请求带着这个结果继续发给模型模型基于新上下文决定下一步。这个过程可以无限循环直到模型输出纯文本回复而不是tool_use为止。抓包时数一下请求轮次就能直观看到 ReAct 循环跑了多少步。4.4 用 curl 验证通道连通性在正式跑 Claude Code 之前建议先用 curl 确认 TaoToken 通道是通的curl -X POST https://taotoken.net/api/v1/messages \ -H x-api-key: YOUR_TAOTOKEN_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-6, max_tokens: 128, messages: [ { role: user, content: 回复 OK 两个字母即可 } ] }返回里能看到content数组和usage字段说明通道正常。如果返回 401检查 Key 是否复制完整返回 404检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api而不是带/v1的路径。5. 本篇常见错排查抓包和配置过程中有几个坑几乎每个人都会踩一遍。第一个坑抓不到 HTTPS 请求。Proxyman 需要安装并信任根证书Claude Code 走的是 Node.js 的 HTTPS 栈如果证书没装进系统钥匙串请求会直接失败而不是被拦截。macOS 上装完证书后还要在钥匙串访问里把证书设为始终信任。第二个坑ANTHROPIC_BASE_URL写错。常见错误是写成https://taotoken.net/api/v1导致请求路径变成/api/v1/v1/messages。正确写法是https://taotoken.net/apiClaude Code 自己会拼/v1/messages。第三个坑工具调用返回格式错误。如果模型返回的tool_use里input不是合法 JSON或者tool_result的tool_use_id对不上整个循环会崩。抓包时重点看这两个字段tool_use_id必须严格匹配。工程上要做多层防御Prompt 强约束、协议层 JSON Mode、解析层容错、失败时把错误信息回传给模型让它自我纠正。第四个坑子代理上下文污染。如果 Explore 子代理继承了主对话的全部历史它会带着一堆无关信息去扫描代码结果反而不准。抓包时对比主请求和子代理请求的messages长度子代理应该只有精简后的任务描述而不是完整历史。第五个坑Prompt Caching 没生效。如果每轮请求的cache_creation_input_tokens都是 0说明缓存没命中。检查cache_control标记的位置是否稳定——只要标记之前的内容有一字变化缓存就失效。CLAUDE.md 里如果写了动态内容比如当前时间戳会导致每轮缓存都重建。第六个坑MCP Server 启动失败。config.toml里配的npx命令如果本地没有对应包Claude Code 启动时会静默跳过这个 Server工具列表里就少了几个工具。抓包时对比tools数组和配置里声明的工具缺了就是 Server 没起来。6. 把抓包变成日常调试手段抓包这件事做一次是好奇做成习惯就是工程能力。我现在调试任何 Agent 问题第一步都是抓包看请求——工具选错了看tools数组上下文丢了看messages长度成本高了看usage里的缓存命中率。Claude Code 的神奇拆开来看全是可复制的工程细节精心组装的上下文、原子化的工具集、严格的 Prompt 规范、多层防御的结构化输出。如果你想继续深入接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有完整的字段说明模型对话 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 可以直接验证模型响应长期跑编码任务的话 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 更合适。配置骨架已经给你了剩下的就是自己抓一次包把每一轮请求的tool_use和tool_result对一遍——踩过这一遍Agent 工程对你来说就不再是黑盒了。