Claude Code · Anthropic 协议 · 多模型边界

Claude Code中转API:Claude、GPT、Gemini与国产模型怎么接

Claude Code 原生使用 Anthropic Messages 协议。当前新增 Claude Opus 5.5,模型 ID 为 claude-opus-5-5;同一账户里的 GPT、Gemini、DeepSeek、GLM、Kimi 等模型,应通过支持 OpenAI 兼容 Provider 的客户端调用,不能只在 Claude Code 中替换模型名称。

维护:词元AI中转站更新:2026-10-07主词:Claude Code中转API
配置入口API 密钥页面模板
核心设置Base URL / Key / Model
工作方式计划 / 权限 / 上下文

直接结论:Claude Code 使用 ANTHROPIC_BASE_URL=https://www.gpt345.com/v1 和本站 Key 接入 Claude 模型。GPT、Gemini 与国产模型使用同一账户余额,但应在支持 OpenAI 兼容 Provider 的客户端中调用。

1. Claude Code 原生配置

Claude Opus 5.5 需要 Claude Code v2.1.280 或更高版本。升级后可显式指定 claude --model claude-opus-5-5,先用短请求确认模型 ID、响应和余额变化。

macOS / Linux
export ANTHROPIC_BASE_URL="https://www.gpt345.com/v1"
export ANTHROPIC_API_KEY="YOUR_GPT345_API_KEY"
claude

Windows PowerShell 使用 $env:ANTHROPIC_BASE_URL 与 $env:ANTHROPIC_API_KEY。Key 不要写入公开仓库;模型是否对当前 Key 开放,以登录后的控制台为准。

2. GPT、Gemini 与国产模型怎么用

目标正确入口注意事项
Claude 模型Claude Code + Anthropic Messages 协议使用上方环境变量;Opus 5.5 的模型 ID 为 claude-opus-5-5
GPT / Gemini / DeepSeek / GLM / Kimi支持 OpenAI 兼容 Provider 的客户端Base URL 使用 https://www.gpt345.com/v1,模型 ID 从模型广场复制
在 Claude Code 中调用非 Claude 模型经过验证的协议转换层工具调用与消息格式可能不完全兼容,不能只替换模型名

如果主要目标是自由切换多模型,可参考 OpenAI 兼容接口指南;Claude 模型选择见 Claude API 中转页,新模型规格见 Claude Opus 5.5 详情页。

3. 首次调用怎么验收

  1. 创建试验 Key 并设置小额预算。
  2. 只配置 Base URL、Key 和一个已开放的 Claude 模型。
  3. 发送一句短请求,核对 HTTP 状态、request ID、返回模型和余额变化。
  4. 确认成功后再启用 MCP、长上下文或高并发。

4. 401、403、429 与断流

现象先检查
401Key 是否完整、环境变量是否被当前终端读取
403当前 Key 的模型权限、余额和分组
429并发、额度和是否存在无限重试
Reconnecting / ECONNRESET代理、流式空闲超时、网络切换和上游状态

完整步骤见 Claude Code 错误排查。联系客服时提供脱敏时间、模型、状态码和 request ID,不要发送完整 Key。

5. Windows、macOS 与 Linux 的完整验收命令

环境变量配置成功不等于请求一定走到目标网关。先在当前终端确认变量,再发起一次最小请求;不要把完整 Key 粘贴到截图或工单。

环境设置与检查重开终端后
macOS / Linuxexport ANTHROPIC_BASE_URL=https://www.gpt345.com/v1
printf '%s ' "$ANTHROPIC_BASE_URL"
写入 shell 配置文件后重新加载;只检查 Key 是否存在,不回显完整值
PowerShell(当前窗口)$env:ANTHROPIC_BASE_URL='https://www.gpt345.com/v1'
$env:ANTHROPIC_API_KEY='YOUR_KEY'
关闭窗口即失效,适合首次小额验收
PowerShell(持久)[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL','https://www.gpt345.com/v1','User')必须新开终端,并确认旧变量没有覆盖

Claude Code 原生链路是客户端按 Anthropic Messages 格式组织请求,再由 /v1 网关路由到已开放的 Claude 模型。OpenAI 兼容客户端通常调用 Chat Completions 或 Responses 形态;消息、工具调用和流式事件格式不同,因此从 Claude 换到 GPT、Gemini 或国产模型时,不能只改 model 字段。

6. 客户端、协议与模型选择矩阵

客户端目标优先 Provider首次验收
Claude Code 使用 ClaudeAnthropic Provider短对话成功后,再测流式输出、工具调用和长上下文
Codex 或其他 GPT 客户端客户端支持的 OpenAI Provider确认它要求 Chat Completions 还是 Responses,不假设两者完全等价
Cherry Studio、OpenCode 等多 Provider 客户端按模型选择 Anthropic 或 OpenAI 兼容 Provider先关闭自动重试,记录真实首个错误码
Gemini、DeepSeek、GLM、Kimi已验证的 OpenAI 兼容 Provider从模型广场复制准确模型 ID,仅测试一个最小请求

这里描述的是协议选择方法,不代表每个第三方客户端版本都已验证。客户端升级后若改变请求协议,应以其当前文档和实际请求日志为准。

7. 从错误码到原因的判断树

  1. 没有发出请求:先检查环境变量作用域、代理和 DNS,不要先更换模型。
  2. 401:检查 Key 是否复制完整、是否仍有效,以及客户端是否错误地添加了前缀。
  3. 403:核对 Key 权限、模型开放范围和请求协议;同一个模型名不代表所有协议都可用。
  4. 429:记录首次出现时间、并发数和重试次数;关闭自动重试后单请求复现,区分额度、频率和上游拥塞。
  5. ECONNRESET 或流中断:用短输出排除长连接超时,再逐步恢复流式输出、MCP、长上下文和高并发。

推荐分四阶段验收:短文本 → 流式输出 → 单个工具或 MCP → 长上下文。每阶段只改变一个变量,并保存时间、模型、状态码、request ID 与余额变化。

8. 常见问题

Claude Code 能直接使用 GPT、Gemini 或国产模型吗?

Claude Code 原生使用 Anthropic Messages 协议,本站配置主要用于 Claude 模型。其他模型应使用支持 OpenAI 兼容 Provider 的客户端,或经过明确验证的协议转换层。

Claude Code 使用 Opus 5.5 需要什么版本?

官方配置文档要求 Claude Code v2.1.280 或更高版本;先升级并用 claude --model claude-opus-5-5 做短请求验收。

Claude Code 返回 401 或 429 怎么排查?

401 先检查 Key、环境变量和 Base URL;429 检查额度、并发和重试循环。每次只改一个变量并保留 request ID。