网络代理服务器

每个智能体 CLI 一个代理服务器,
设置一次,作用于它的所有智能体

公司希望 Claude Code 经由公司的代理服务器访问网络,而你个人的 Codex 走家里的网络。在 shell 里 export HTTPS_PROXY,会让所有 CLI 走同一条路。AgentsRoom 让每个提供商都有自己的出口。

在“设置 > AI 服务商”中选择一个提供商,展开“高级设置”,填写代理服务器地址并点击“测试”:在启动任何内容之前,AgentsRoom 就会显示出口 IP。之后,该提供商的每个智能体启动时都会带上代理服务器变量,AgentsRoom 自己对该提供商的配额查询也走同一条路。

每个提供商一个出口
  • Claude Code公司代理服务器proxy.corp.example:3128出口 IP203.0.113.10
  • Codex家庭代理服务器home.example.net:8080出口 IP198.51.100.24
  • GitHub Copilot CLI直连出口 IP192.0.2.7

每个提供商经由自己的代理服务器访问网络,或者直连,“测试”会显示提供商将看到的地址。

大多数智能体 CLI 本来就会使用代理服务器:它们在启动时读取标准变量 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY。问题在于这些变量放在哪里。把它们 export 到 shell 配置文件里,你运行的每个 CLI 都会走同一个出口,于是你没法同时让 Claude Code 留在公司网络上、让 Codex 走家里的网络。

AgentsRoom 把这个设置下移一层,放到提供商上。“设置 > AI 服务商”中的每个提供商标签页,在“高级设置”下都有一个“代理服务器”字段。该提供商的每个智能体启动时,终端里都会带上代理服务器变量,无论它在哪个项目里运行,其他提供商则不受影响。

它也覆盖 AgentsRoom 自己向提供商发起的调用,例如读取你的 Claude 或 Codex 用量。这些调用经过同一个代理服务器,所以账号只会看到一个地址,而不是一边看到智能体的地址,另一边看到你电脑的地址。

“代理服务器”字段能做什么

每个提供商一个字段,在该提供商的每个智能体启动时生效。

每个提供商一个代理服务器

Claude Code、Codex、GitHub Copilot CLI 以及其他智能体 CLI,各有自己的“代理服务器”字段。留空的话,该提供商就直连。

HTTP、HTTPS 或 SOCKS

接受 http://、https://、socks5:// 和 socks5h:// 地址。Claude Code 不支持 SOCKS,所以请给 Claude 智能体使用 http:// 代理服务器。

“测试”显示出口 IP

在启动任何内容之前,“测试”会分别直接和经由代理服务器查询你的公网地址,并连同延迟一起显示两者。如果两者相同,说明该代理服务器没有改变你的 IP,面板会直接告诉你。

例外,localhost 始终直连

列出必须绕过代理服务器的主机,例如内网或软件包仓库。localhost、127.0.0.1 和 ::1 始终排除在外,所以钩子和本地 MCP 服务器照常工作。

配额查询走同一条路

AgentsRoom 自己对该提供商的调用,例如用量仪表,也经过代理服务器。如果代理服务器宕机,它们会像网络故障一样失败:绝不会退回到直连。

没有明文密码

这个设置会随你的账号同步到你的其他电脑,所以不能直接以明文填写密码。请把它保存在密钥管理器中,然后写 http://user:{{secret:NAME}}@host:port。

AgentsRoom 的 Settings,AI providers 页面,选中 Codex 标签页:环境变量下方,Advanced settings 中的 Proxy 区域填有一个 http:// 代理服务器地址,以及 Exceptions 字段和 Test 按钮
Codex 标签页的“代理服务器”字段,位于“高级设置”下。之后启动的每个 Codex 智能体都经由这个地址访问网络,其他提供商保持各自的路线,“测试”会在启动任何内容之前显示出口 IP。

如何设置

五步,每个提供商设置一次。

  1. 1

    打开提供商的标签页

    进入“设置 > AI 服务商”,选择提供商(例如 Codex),然后展开“高级设置”。“代理服务器”字段位于环境变量下方。在设置搜索框中输入“代理服务器”也能直接跳到这里。

  2. 2

    填写代理服务器地址

    填写地址,例如 http://proxy.example.com:3128,并在“例外”中填写必须直连的主机。标题旁边的开关可以关闭代理服务器而不丢失设置,在办公室连不上家里的代理服务器时很方便。

  3. 3

    点击“测试”

    AgentsRoom 会显示经由代理服务器的出口 IP、延迟,以及不使用代理服务器时你的地址。密码被拒绝、代理服务器无法连接、代理服务器没有响应,都会直接说明。

  4. 4

    启动智能体

    代理服务器在智能体启动时生效:该提供商的每个新智能体都会获得 HTTPS_PROXY、HTTP_PROXY、ALL_PROXY 和 NO_PROXY,大写和小写形式都有,因为 curl 等一些工具只读取小写形式。已经在运行的智能体会保持原来的路线,直到你重新启动它。

  5. 5

    智能体运行的一切都跟着走

    智能体在其终端中启动的 git、npm 或 curl 都经过同一个代理服务器。如果其中某个必须保持直连,就把对应主机加到“例外”中。

Claude Code 和 Codex 自己已经能做什么

Claude Code 读取 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY,包括小写形式,并接受写在代理服务器 URL 中的用户名和密码。它的文档明确说明不支持 SOCKS 代理服务器。文档建议把这些变量设置在 ~/.claude/settings.json 的 env 块中,而不是 shell 里,这是唯一能可靠传到其后台智能体的配置,/status 会显示它识别到的代理服务器。在会检查 TLS 的公司代理服务器后面,它信任操作系统的证书和 NODE_EXTRA_CA_CERTS。(Claude Code 文档,Enterprise network configuration,2026年10月21日查阅。)

Codex CLI 从其环境中读取 HTTPS_PROXY、ALL_PROXY 和 NO_PROXY,并从 CODEX_CA_CERTIFICATE 或 SSL_CERT_FILE 获取自定义根证书。在 codex-cli 0.163.0 中,跟随 macOS 系统代理设置或 PAC 文件是一项开发中的功能,默认关闭(codex features enable respect_system_proxy)。其 /experimental 菜单中的 Network proxy 项是另一回事:它限制沙箱中的命令能访问哪些地方,并不决定 OpenAI 看到的地址。

所以,如果只是一台电脑上的一个 CLI,这些变量就够了,而写在 ~/.claude/settings.json 中的代理服务器本来就只作用于 Claude Code。它们给不了你的是:一个管理所有 CLI 的地方,启动前对出口 IP 的检查,配额读取也走同一条路,以及一个不含密码、能跟着你同步到其他电脑的设置。这正是 AgentsRoom 补上的部分。

限制

  • 代理服务器在智能体启动时生效。已经在运行的智能体会保持原来的路线,直到你重新启动它。
  • 忽略标准代理服务器变量的 CLI,其自身流量会直连。AgentsRoom 不会强制它,但对该提供商的配额查询仍然经过代理服务器。
  • Claude Code 不支持 SOCKS 代理服务器。Claude 请使用 http:// 或 https:// 代理服务器。
  • 不会悄悄退回直连:代理服务器宕机时,该提供商的智能体无法连接到提供商,其用量仪表会显示网络错误。
  • 密码对应的机密保存在每台电脑的机密库中,而机密不会同步:在第二台电脑上,请保存一个同名的机密。
  • 只有该提供商的智能体以及 AgentsRoom 对该提供商的调用会使用代理服务器。内置浏览器、你的开发服务器以及你在其他终端中启动的命令,保持各自的网络路径。
  • 环境变量块(提供商、文件夹、项目或智能体)中显式写出的 HTTPS_PROXY 行,在智能体的终端中优先于此设置。

常见问题

怎样为 Claude Code 设置代理服务器?

Claude Code 从你的 shell 或 ~/.claude/settings.json 的 env 块中读取标准变量 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY,并且不支持 SOCKS。在 AgentsRoom 中,打开“设置 > AI 服务商”,选择 Claude,展开“高级设置”,在“代理服务器”中填写一个 http:// 代理服务器地址:之后启动的每个 Claude Code 智能体都会获得这些变量,其他 CLI 保持各自的路线。

怎样让 Codex CLI 使用代理服务器?

Codex CLI 从其环境中读取 HTTPS_PROXY、ALL_PROXY 和 NO_PROXY,并从 CODEX_CA_CERTIFICATE 或 SSL_CERT_FILE 读取自定义根证书。在 codex-cli 0.163.0 中,跟随操作系统的代理设置仍是一项开发中的功能,默认关闭。在 AgentsRoom 中,Codex 标签页的“代理服务器”字段会为每个 Codex 智能体设置这些变量,Codex 的用量读取也经过同一个代理服务器。

Claude Code 和 Codex 能同时使用不同的代理服务器吗?

可以。每个提供商标签页都有自己的“代理服务器”字段,所以在同一个项目里、同一时刻,Claude 智能体可以经由公司代理服务器访问网络,而 Codex 智能体走你家里的网络。没有设置代理服务器的提供商直连。

怎样查看提供商看到的是哪个 IP 地址?

点击代理服务器地址旁边的“测试”。AgentsRoom 会向一个公共端点查询两次你的地址,一次直连,一次经由代理服务器,并连同延迟一起显示两者。如果两者相同,说明该代理服务器没有改变你的地址,面板会提醒你。

能使用需要用户名和密码的代理服务器吗?

可以,而且不用以明文写出密码。代理服务器设置会随你的账号同步到你的其他电脑,所以明文密码会被拒绝。请把密码保存在密钥管理器中,然后在代理服务器地址中引用这个机密:它会在智能体启动时在你的电脑上解析。如果密码包含 @、: 或 /,请以 URL 编码形式保存。

代理服务器会作用于 npm、git 以及智能体运行的命令吗?

会。这些变量设置在智能体的终端中,所以智能体在那里启动的一切(git、npm、curl、测试运行器)也都使用代理服务器。把必须保持直连的主机填进“例外”;localhost、127.0.0.1 和 ::1 始终排除在外。

代理服务器宕机会怎样?

有意设计为不会退回直连:你选择这个出口,就是为了让提供商永远看不到你的另一个地址。该提供商的智能体无法连接到提供商,其用量仪表会显示网络错误,直到代理服务器恢复或你把它关掉。

每台电脑都要重新设置一遍吗?

地址和例外不用:它们随你的账号保存,在你登录的每台电脑上都会恢复。密码要:机密保存在每台电脑的机密库中,所以请在第二台电脑上保存一个同名的机密。从手机启动的智能体运行在桌面电脑上,使用桌面电脑的代理服务器。

你可能还喜欢

让每个智能体 CLI 都有自己的出口

下载 AgentsRoom,打开“设置 > AI 服务商”,为每个提供商设置一个代理服务器。所有套餐均可使用。

免费下载 AgentsRoom

配套应用:随时随地监控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

获取扩展程序
Chrome Web Store

把 Bug 和需求直接发送到您的公开待办清单。

多项目管理
多供应商
多代理运行
实时状态
文件差异与提交
移动应用
实时预览
代理团队
浏览器自动化
Backlog 驱动开发
提示词库
技能库
查看所有功能