Claude Code 代理：是 HTTP 代理还是 API 网关？你到底需要哪一种
发布于 2026-11-11
人们搜「Claude Code 代理」或「Claude Code 中转」时，指的是两件解决不同问题的事。把它们混为一谈，是配置不生效最常见的原因。这篇短文帮你分清两者，并指向正确的步骤。第二种需求的完整教程已经有了，所以这里只写差异部分。
利益声明：我们运营 OriginCoder，一个 API 网关，它属于第二种情况。本文内容截至 2026 年 11 月。
两种含义
| 你想要什么 | 改变了什么 | 典型原因 | |
|---|---|---|---|
| 1. HTTP 代理 | Claude Code 的网络流量经过一个代理服务器出去，但仍然访问同一个服务 | 网络路径 | 公司网络、防火墙，或必须经过的出站代理 |
| 2. API 网关或中转 | Claude Code 把请求发到另一个 API 地址，由它转发给模型厂商 | 服务地址和密钥 | 按 token 付费、一个 Key 对接多个模型、逐请求费用记录 |
一个快速判断：你要改的是「谁来接收请求」，还是只改「请求走的路」？如果目的地仍然是 Anthropic，就是第 1 种；如果目的地变成了网关，就是第 2 种。
第 1 种：HTTP 代理
如果你的网络要求走出站代理，Claude Code 会识别大多数命令行工具通用的标准代理环境变量：
export HTTPS_PROXY="http://proxy.example.com:8080"
export HTTP_PROXY="http://proxy.example.com:8080"
export NO_PROXY="localhost,127.0.0.1"
说明：
proxy.example.com:8080是占位符，请换成你自己的代理地址。- 如果你的代理用自己的证书机构检查 TLS，你可能还需要让 Node.js 信任该证书，例如使用
NODE_EXTRA_CA_CERTS。 - 代理支持的细节（包括支持哪些代理类型）会随版本变化，权威清单请查 Anthropic 当前的 Claude Code 文档。
- 这只改变网络路线。你的账号、计费和限额仍然属于你登录的那个服务。
这属于网络配置话题，Anthropic 文档已覆盖，所以我们不展开。对来源不明的第三方代理软件要小心：代理能看到经过它的一切内容。
第 2 种：API 网关（自定义 Base URL）
如果你想要按 token 付费、一个 Key 对接多个模型，或逐请求的费用记录，就设置地址和密钥，把 Claude Code 指向网关：
export ANTHROPIC_BASE_URL="https://origincoder.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxx"
Claude Code 的 Base URL 不要加 /v1，因为它会自己拼接路径。完整步骤（包括 CC-Switch 一键导入、settings.json、验证和排查）见 Claude Code 接入自定义 API 地址。这种做法不需要 HTTP 代理，除非你的网络本来就要求走代理，那就两者叠加使用。
两者一起用
它们互相独立。如果办公网络强制出站代理，你又想用网关，就同时设置第 1 种的代理变量和第 2 种的 Base URL 变量。请求会经由你的代理发往网关。
你该选哪一种
- 你的问题是连通性（「连不上服务器」）：第 1 种。
- 你的问题是成本、用量限制或模型选择：第 2 种。见 Claude Code 用量限制是怎么回事和 Claude Code 替代方案：官方订阅还是 API 网关。
- 你不确定网关是什么：先读 AI 网关是什么。
网关是请求链路上的第三方，能看到你的提示词和代码上下文，请先阅读其条款。各模型单价见模型价格页。OriginCoder 是独立平台，与 Anthropic 没有任何关联。