如何在 Codex 和 Claude Code 中使用 Proxyman MCP
在本教程中，你将完成以下操作：
- 下载并设置 Proxyman
- 通过 MCP 将 Codex 或 Claude Code 连接到 Proxyman
- 在把敏感流量数据发送给 AI 智能体之前先做好保护
- ✅ 让智能体创建一条 Proxyman Scripting 规则
调试应用时，问题的答案往往就藏在网络流量里。Proxyman 可以抓取这些流量，其内置的 MCP 服务器还能让 AI 编程助手帮你分析。
MCP 是 Model Context Protocol（模型上下文协议）的缩写。它是一种简单的连接方式，让 Codex 和 Claude Code 等工具能够与你电脑上的 Proxyman 通信。你无需离开终端，智能体就能读取 Flows、解释请求，并创建调试规则。
本指南介绍如何将 Proxyman MCP 连接到 Codex 或 Claude Code。同样的方法也适用于其他支持 MCP 的智能体。
1. 下载并设置 Proxyman
开始之前，请先在你的电脑上下载并设置 Proxyman。
- 打开 Proxyman 官网，下载最新版本的 Proxyman。
- 安装并打开 Proxyman。
- 如果你想检查 HTTPS 流量，请按照
Proxyman->Certificate->Install for macOS->Follow the instruction的路径安装 Proxyman 证书。 - 使用 MCP 期间，请确保 Proxyman 保持打开。MCP 服务器控制的是你电脑上运行的 Proxyman 应用，它并不是云端 API。
只有在 Proxyman 已经能够抓取你想调试的流量之后，MCP 才最有用。对于 HTTPS 流量，请先确保已设置好 SSL Proxying 并安装证书。
2. 将 Proxyman MCP 连接到 Codex 或 Claude Code
Proxyman 内置了设置界面，可以为你的智能体生成正确的命令。请直接使用该命令，而不要复制其他电脑上的命令或过时教程里的命令。
- 在 Proxyman 中打开
Settings->MCP。 - 开启 MCP Server。
- 保持 Redact Sensitive Data Before Sending to AI 处于开启状态。Proxyman 会在智能体接收到 Flow 之前，检测并隐藏敏感值，例如授权请求头、Cookie、密码和令牌。
- 在设置界面中选择 Codex 或 Claude Code。
- 点击 Copy Command。
- 在项目中打开终端，粘贴该命令并运行。
- 如果 Codex 或 Claude Code 已经打开，请重新启动。
如果列表中没有你的智能体，请选择 Manual。Proxyman 会显示 MCP 配置，你可以将其添加到智能体的设置文件中。连接完成后，请保持 Proxyman 打开。
除非你完全清楚智能体会接收到什么内容，否则请勿关闭敏感数据脱敏功能。抓取到的请求可能包含客户信息、会话 Cookie、API 密钥或访问令牌。
2.1 检查连接是否正常
新建一个 Codex 或 Claude Code 会话，就 Proxyman 中已经可见的流量提一个简单的问题。例如：
Show me the latest requests to api.example.com and explain any failed response.
智能体应当通过 Proxyman MCP 读取这些 Flow，并返回一份摘要。如果看不到任何流量，请先从你的应用、浏览器、模拟器或设备发起一次请求。
3. 添加 Proxyman Skill 并创建 Scripting 规则
Proxyman 提供了官方的 Proxyman Skill。该 Skill 会教智能体如何安装 Proxyman、连接 MCP，以及在流量调试中正确使用 MCP 工具。
使用 skills.sh 安装所有 Proxyman Skill：
npx skills add ProxymanApp/proxyman-SKILL.md/skills
你也可以只安装 MCP 设置 Skill：
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup
安装后，请重启或重新加载智能体。当智能体需要协助设置 Proxyman、查找 MCP 工具，或安全地处理抓取的流量时，该 Skill 尤其有用。
3.1 让 Codex 或 Claude Code 创建规则
MCP 连接完成后，你可以用日常语言让智能体创建 Proxyman 规则。例如，你可以这样提问：
Create a Proxyman Scripting Rule for httpbin.proxyman.app. Add the X-data: 123 header to requests, return status 201 in responses, replace Set-Cookie with abcdef, and enable the rule.
智能体可以通过 Proxyman MCP 创建该规则。在将规则用于真实流量之前，请先在 Proxyman 中检查一遍。好的习惯是让规则的范围尽可能小，例如只匹配测试域名或某一个 API 路径。
同样的方法也可用于其他任务，例如创建 Map Local 规则、重放请求、解释错误响应，或导出选中的 Flow。
4. 常见问题与解决方法
4.1 智能体找不到 Proxyman MCP 工具
解决方法：确保已安装并运行 Proxyman。然后打开 Settings -> MCP，开启 MCP Server，重新复制适用于你的智能体的命令，并在终端中运行。命令执行完成后，重启智能体。
4.2 智能体看不到任何请求
解决方法：MCP 只能读取 Proxyman 已经抓取到的流量。请打开你的应用或浏览器，重复一次想要调试的操作。对于 HTTPS 流量，请确保已为该域名配置好证书和 SSL Proxying。
4.3 重要的值对智能体不可见
解决方法：启用 Redact Sensitive Data Before Sending to AI 后，出现这种情况属于正常现象。日常调试时请保持开启。如果某个测试请求需要特定的值，请使用安全的测试账号，或自己在 Proxyman 中查看该值，而不要把生产环境的机密信息分享给智能体。
4.4 智能体创建的规则范围过宽
解决方法：让智能体用更精确的条件更新规则，例如加入准确的主机名、路径、HTTP 方法，或仅用于测试的请求头。不再需要某条规则时，请务必检查并将其禁用。
5. 总结
在本教程中，我们学习了如何：
- 通过 MCP 将 Codex 或 Claude Code 连接到 Proxyman
- 在敏感的请求和响应数据到达 AI 智能体之前对其进行保护
- 添加官方的 Proxyman Skill，帮助智能体正确使用 MCP
- 让智能体创建一条 Proxyman Scripting 规则
MCP 能为你的编程智能体提供来自你正在调试的流量的有用上下文。从简单的请求和精确的规则入手，保持敏感数据脱敏功能开启，并让 Proxyman 始终掌控本地调试会话。
你可能会觉得有用的相关教程：
Proxyman 是一款高性能的 macOS/Windows/Linux 应用，可帮助开发者抓取来自浏览器、iOS 设备、iOS 模拟器和 Android 设备的 HTTP/HTTPS 和 WebSocket 流量。
前往 https://proxyman.com 下载。
