Claude Code 自定义 API 中转站配置指南

调研日期：2026-06-08 最后更新：2026-06-08 状态：持续维护中适用版本：Claude Code v2.1.163+

一、背景

Claude Code 官方支持通过环境变量自定义 API 端点，可以对接第三方 API 代理（中转站）而非直连 api.anthropic.com。这在以下场景有用：

国内网络直连 Anthropic 不稳定或被墙
公司统一 API 管理和计费
利用第三方代理商的余额/价格优势
多人共享配额

二、我司当前配置

┌─────────────┐      ┌───────────────────────────────┐      ┌────────────┐      ┌──────────────┐
│ Claude Code │ ───→ │ model.mify.ai.srv/anthropic   │ ───→ │  PPIO API  │ ───→ │ AWS Bedrock  │
│  (本地CLI)  │      │   (公司内部网关 MiFE/2.0.0)    │      │ ppio.ai    │      │ (Anthropic)  │
└─────────────┘      └───────────────────────────────┘      └────────────┘      └──────────────┘

上游 API 确认：AWS Bedrock（2026-06-08 验证）

PPIO 底层走的是 AWS Bedrock 调用 Anthropic Claude 模型，而非 Anthropic 官方 API 直连。

判断依据：

tool_use_id 格式为 toolu_bdrk_XXXXX（Bedrock 特征前缀）
Anthropic 直连格式为 toolu_01XXXXX（无 bdrk）
100% 的 tool_use_id 都带有 bdrk 标识（抽样 49 个全部匹配）
响应中 model 字段返回 pa/claude-opus-4-6（PPIO 自定义路由前缀）

各上游 API 的 tool_use_id 指纹对比：

上游 API	tool_use_id 格式	示例
Anthropic 直连	`toolu_01XXXXX`	`toolu_01Ab5sV2...`
AWS Bedrock	`toolu_bdrk_01XXXXX`	`toolu_bdrk_015m9r...` ← 我们的情况
Google Vertex AI	`toolu_vrtx_01XXXXX`	`toolu_vrtx_01Kj6k...`

配置项	值
`ANTHROPIC_BASE_URL`	`http://model.mify.ai.srv/anthropic`
`ANTHROPIC_AUTH_TOKEN`	`sk-SL5Y...` (公司统一分发)
`ANTHROPIC_MODEL`	`ppio/pa/claude-opus-4-6`
模型 ID 前缀	`ppio/pa/` (PPIO 的路由前缀)
主模型	`ppio/pa/claude-opus-4-6` (Opus 4.6)
Sonnet	`ppio/pa/claude-sonnet-4.5`
Haiku	`ppio/pa/claude-haiku-4-5`

三、Claude Code 支持的完整环境变量

从 Claude Code v2.1.163 二进制中提取的所有 ANTHROPIC_ 配置项：

3.1 核心鉴权与端点

环境变量	用途	说明
`ANTHROPIC_BASE_URL`	API 端点地址	替代默认的 `https://api.anthropic.com`，指向中转站
`ANTHROPIC_API_KEY`	API Key (官方格式)	官方 `sk-ant-api03-...` 格式
`ANTHROPIC_AUTH_TOKEN`	API Key (通用格式)	支持第三方 key 格式，如 `sk-xxx`
`ANTHROPIC_CUSTOM_HEADERS`	自定义请求头	JSON 格式，透传给 API 端点

3.2 模型配置

环境变量	用途	说明
`ANTHROPIC_MODEL`	主模型 ID	对话使用的默认模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 模型 ID
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 模型 ID
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Haiku 模型 ID
`ANTHROPIC_SMALL_FAST_MODEL`	快速小模型	用于轻量任务（如 skill routing）
`ANTHROPIC_CUSTOM_MODEL_OPTION`	自定义模型 slot	在 `/model` 列表中显示的额外选项
`ANTHROPIC_CUSTOM_MODEL_OPTION_NAME`	自定义模型显示名
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	自定义模型描述
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	自定义模型能力声明
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Opus 显示名
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Sonnet 显示名
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Haiku 显示名
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Opus 能力声明
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Sonnet 能力声明
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Haiku 能力声明

3.3 云平台端点（替代方案）

环境变量	用途
`ANTHROPIC_VERTEX_BASE_URL`	Google Cloud Vertex AI 端点
`ANTHROPIC_VERTEX_PROJECT_ID`	Vertex 项目 ID
`ANTHROPIC_BEDROCK_BASE_URL`	AWS Bedrock 端点
`ANTHROPIC_BEDROCK_MANTLE_BASE_URL`	Bedrock Mantle 端点
`ANTHROPIC_BEDROCK_MANTLE_API_KEY`	Bedrock Mantle Key
`ANTHROPIC_FOUNDRY_BASE_URL`	Anthropic Foundry 端点
`ANTHROPIC_FOUNDRY_API_KEY`	Foundry Key
`ANTHROPIC_FOUNDRY_RESOURCE`	Foundry 资源标识
`ANTHROPIC_AWS_BASE_URL`	AWS 自定义端点
`ANTHROPIC_AWS_API_KEY`	AWS API Key

3.4 高级配置

环境变量	用途
`ANTHROPIC_BETAS`	启用 beta 特性
`ANTHROPIC_PROFILE`	配置 profile
`ANTHROPIC_WORKSPACE_ID`	工作空间 ID
`ANTHROPIC_ORGANIZATION_ID`	组织 ID
`ANTHROPIC_SCOPE`	权限范围
`ANTHROPIC_UNIX_SOCKET`	Unix Socket 路径（本地代理）
`ANTHROPIC_FEDERATION_RULE_ID`	联邦认证规则
`ANTHROPIC_IDENTITY_TOKEN`	身份令牌
`ANTHROPIC_IDENTITY_TOKEN_FILE`	身份令牌文件路径

四、配置方式

4.1 方式一：settings.json（推荐，持久化）

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转站地址",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的key",
    "ANTHROPIC_MODEL": "模型ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "opus模型ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "sonnet模型ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "haiku模型ID"
  }
}

4.2 方式二：Shell 环境变量（临时）

export ANTHROPIC_BASE_URL="https://你的中转站地址"
export ANTHROPIC_AUTH_TOKEN="sk-你的key"
export ANTHROPIC_MODEL="claude-opus-4-20250514"
claude  # 启动即生效

4.3 方式三：项目级配置

在项目 .claude/settings.json 中设置（仅该项目生效）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://项目专用中转"
  }
}

4.4 优先级

项目 .claude/settings.json > 用户 ~/.claude/settings.json > shell 环境变量

五、自建中转方案对比

5.1 个人使用：直接对接第三方

无需自建任何东西，注册第三方 API 提供商 → 拿 key → 配置环境变量。

提供商	地址	特点	个人可购买	价格
PPIO	ppio.com	我司当前使用；国内访问稳定；底层走 AWS Bedrock	⚠️ Claude 未公开售卖，需联系商务	按 token 计费（ToB 定价）
OpenRouter	openrouter.ai	聚合多家模型；海外最主流；个人自助	✅ 自助注册充值即用	按 token 计费，加少量加价
各家国内中转	搜索”Claude API 中转”	良莠不齐，选信誉好的	✅ 多数支持个人	差异大

PPIO 详情

PPIO（派欧云）是国内分布式云计算服务商，AI API 代理是其业务之一。

维度	说明
官网	ppio.com（原 ppinfra.com 已 301 跳转）
底层通道	AWS Bedrock（已通过 `tool_use_id` 的 `bdrk` 前缀确认）
公开售卖模型	DeepSeek、Qwen、GLM、MiniMax 等开源/国产模型
Claude 模型	未出现在公开定价页，属于 ToB 定制服务
个人购买 Claude	需联系商务确认：电话 021-60747977 / 邮件 bd@ppio.com
模型 ID 格式	`ppio/pa/claude-opus-4-6`（pa = proxy anthropic）
我司使用方式	公司统一采购 key，通过内部网关 `model.mify.ai.srv` 转发

链路全景：

你的 Claude Code
    → model.mify.ai.srv (公司 MiFE 网关, IP 10.16.73.7)
        → PPIO API (ppio.com)
            → AWS Bedrock (us-east-1 / us-west-2)
                → Anthropic Claude 模型

OpenRouter 详情（个人推荐）

对个人用户来说 OpenRouter 是最方便的选择：

维度	说明
官网	openrouter.ai
注册	邮箱注册，无需企业认证
充值	信用卡 / Crypto，最低 $5
Claude 模型	全系列可用（Opus/Sonnet/Haiku）
底层通道	Anthropic 直连 + Bedrock + Vertex（自动选择）
模型 ID 格式	`anthropic/claude-opus-4`
国内访问	需要代理或 Cloudflare Worker 转发

配置示例（PPIO，需有企业 key）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ppio.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你在PPIO的key",
    "ANTHROPIC_MODEL": "ppio/pa/claude-opus-4-6"
  }
}

配置示例（OpenRouter，个人自助）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-你的key",
    "ANTHROPIC_MODEL": "anthropic/claude-opus-4"
  }
}

如何鉴别中转站的上游 API

检查 Claude Code 会话日志中的 tool_use_id 前缀即可判断：

# 查看你的会话日志
grep -oP '"tool_use_id":"toolu_[^"]{0,10}' ~/.claude/projects/*/你的session.jsonl | head -3

`tool_use_id` 前缀	上游 API
`toolu_01...`	Anthropic 官方 API 直连
`toolu_bdrk_01...`	AWS Bedrock
`toolu_vrtx_01...`	Google Vertex AI

5.2 团队使用：自建网关

适用于多人共享、统一计费、限流管控。

方案 A：one-api / new-api（推荐）

项目	Stars	特点
one-api	20k+	Go，多后端聚合、用户管理、令牌计费、配额
new-api	5k+	one-api fork，UI 更好、支持更多模型

部署方式（Docker）：

docker run -d --name one-api \
  -p 3000:3000 \
  -v /data/one-api:/data \
  justsong/one-api:latest

然后：

后台添加 Channel → 填入 PPIO/官方的 key
创建用户令牌 → 分发给组员
Claude Code 配置：ANTHROPIC_BASE_URL=http://你的服务器:3000

方案 B：纯 Nginx 反向代理（最轻量）

只做转发，不做计费管理：

server {
    listen 443 ssl;
    server_name api.your-team.com;
 
    location /anthropic/ {
        proxy_pass https://api.ppio.ai/;
        proxy_set_header Host api.ppio.ai;
        proxy_set_header Authorization $http_authorization;
        proxy_set_header Content-Type $content_type;
        proxy_buffering off;           # SSE 流式必须关闭缓冲
        proxy_read_timeout 300s;       # 长请求超时
        chunked_transfer_encoding on;
    }
}

方案 C：Cloudflare Worker（免运维）

export default {
  async fetch(request) {
    const url = new URL(request.url);
    url.hostname = 'api.anthropic.com';  // 或 api.ppio.ai
    const newRequest = new Request(url, request);
    return fetch(newRequest);
  }
};

绑定自定义域名即可使用。免费额度每天 10 万次请求。

5.3 方案对比总结

方案	适合	成本	维护	功能
直接用第三方	个人	仅 API 费用	零	仅转发
nginx 反代	2-3 人小组	一台服务器	低	转发+域名统一
one-api/new-api	团队 5+ 人	一台服务器	中	计费/限流/多后端/多用户
Cloudflare Worker	个人/小组	免费	零	仅转发，国内可能慢

六、注意事项

6.1 API 兼容性要求

Claude Code 发送的请求严格遵循 Anthropic Messages API 格式。中转站必须：

支持 /v1/messages 端点
支持 SSE 流式响应 (stream: true)
正确转发 anthropic-version 头
支持 tool_use (function calling) 格式
支持 extended thinking（Opus 模型）

6.2 常见问题

问题	原因	解决
`ECONNREFUSED`	中转站地址不可达	检查网络/DNS
`401 Unauthorized`	key 无效或过期	更新 `ANTHROPIC_AUTH_TOKEN`
`model not found`	模型 ID 格式不对	使用中转站要求的模型 ID 格式
响应截断	中转站 timeout 太短	调整代理超时 ≥300s
流式输出卡顿	代理开启了 buffering	nginx 加 `proxy_buffering off`
tool_use 报错	中转站不支持 tool_use	换支持完整 API 的提供商

6.3 安全建议

不要把 ANTHROPIC_AUTH_TOKEN 提交到 git（.claude/settings.json 应在 .gitignore 中）
自建网关加 HTTPS + IP 白名单
定期轮换 API Key
one-api 场景：每人独立令牌，方便审计和撤销

七、验证配置

配置完成后验证是否生效：

# 方法 1：启动 Claude Code 看模型信息
claude --version
# 进入后执行 /model 查看可选模型列表
 
# 方法 2：直接 curl 测试中转站
curl -X POST "https://你的中转站/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "Hi"}]
  }'
 
# 方法 3：在 Claude Code 中查看当前配置
# 输入 /config 或查看 $ANTHROPIC_BASE_URL

八、变更记录

日期	变更内容	操作人
2026-06-08	确认 PPIO 上游为 AWS Bedrock（通过 tool_use_id bdrk 前缀验证）	zhoubencheng
2026-06-08	初始版本：完整环境变量列表 + 自建方案对比	zhoubencheng

待补充（TODO）

PPIO 注册流程截图和具体价格表
one-api 完整部署教程（含 HTTPS + Docker Compose）
中转站性能对比测试（延迟/吞吐）
ANTHROPIC_CUSTOM_MODEL_OPTION 详细用法（自定义模型 slot）
Bedrock/Vertex 官方云端点配置方式
多中转站负载均衡方案

Quartz 4

Explorer

Claude Code 自定义 API 中转站配置指南

Claude Code 自定义 API 中转站配置指南

一、背景

二、我司当前配置

三、Claude Code 支持的完整环境变量

3.1 核心鉴权与端点

3.2 模型配置

3.3 云平台端点（替代方案）

3.4 高级配置

四、配置方式

4.1 方式一：settings.json（推荐，持久化）

4.2 方式二：Shell 环境变量（临时）

4.3 方式三：项目级配置

4.4 优先级

五、自建中转方案对比

5.1 个人使用：直接对接第三方

PPIO 详情

OpenRouter 详情（个人推荐）

如何鉴别中转站的上游 API

5.2 团队使用：自建网关

方案 A：one-api / new-api（推荐）

方案 B：纯 Nginx 反向代理（最轻量）

方案 C：Cloudflare Worker（免运维）

5.3 方案对比总结

六、注意事项

6.1 API 兼容性要求

6.2 常见问题

6.3 安全建议

七、验证配置

八、变更记录

待补充（TODO）

Graph View

Table of Contents