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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api （这个地址不加 UTM 参数，配置里直接写死即可）。你需要先拿到一个 API Key，然后把它填进 Claude Code 的配置里。
拿 Key 的路径是：登录后进入控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 创建一个新 Key。创建时建议按用途命名，比如claude-code-local、agent-debug，这样抓包时从 Key 前缀就能区分请求来源。
注意：Key 只在创建时完整显示一次，复制后立刻存进本地环境变量或配置文件，不要硬编码进代码仓库。
如果你打算长期跑编码类 Agent 任务，可以顺带看一下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它针对高频编码场景做了额度规划，比按次调用更划算。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，配置字段有疑问时对照着看。
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.json：CLI 层配置
{ "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/api，Claude 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_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里有完整的字段说明，模型对话 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 可以直接验证模型响应，长期跑编码任务的话 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 更合适。配置骨架已经给你了，剩下的就是自己抓一次包，把每一轮请求的tool_use和tool_result对一遍——踩过这一遍，Agent 工程对你来说就不再是黑盒了。
