直接结论: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、响应和余额变化。
export ANTHROPIC_BASE_URL="https://www.gpt345.com/v1"
export ANTHROPIC_API_KEY="YOUR_GPT345_API_KEY"
claudeWindows 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. 首次调用怎么验收
- 创建试验 Key 并设置小额预算。
- 只配置 Base URL、Key 和一个已开放的 Claude 模型。
- 发送一句短请求,核对 HTTP 状态、request ID、返回模型和余额变化。
- 确认成功后再启用 MCP、长上下文或高并发。
4. 401、403、429 与断流
| 现象 | 先检查 |
|---|---|
| 401 | Key 是否完整、环境变量是否被当前终端读取 |
| 403 | 当前 Key 的模型权限、余额和分组 |
| 429 | 并发、额度和是否存在无限重试 |
| Reconnecting / ECONNRESET | 代理、流式空闲超时、网络切换和上游状态 |
完整步骤见 Claude Code 错误排查。联系客服时提供脱敏时间、模型、状态码和 request ID,不要发送完整 Key。
5. Windows、macOS 与 Linux 的完整验收命令
环境变量配置成功不等于请求一定走到目标网关。先在当前终端确认变量,再发起一次最小请求;不要把完整 Key 粘贴到截图或工单。
| 环境 | 设置与检查 | 重开终端后 |
|---|---|---|
| macOS / Linux | export ANTHROPIC_BASE_URL=https://www.gpt345.com/v1printf '%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 使用 Claude | Anthropic Provider | 短对话成功后,再测流式输出、工具调用和长上下文 |
| Codex 或其他 GPT 客户端 | 客户端支持的 OpenAI Provider | 确认它要求 Chat Completions 还是 Responses,不假设两者完全等价 |
| Cherry Studio、OpenCode 等多 Provider 客户端 | 按模型选择 Anthropic 或 OpenAI 兼容 Provider | 先关闭自动重试,记录真实首个错误码 |
| Gemini、DeepSeek、GLM、Kimi | 已验证的 OpenAI 兼容 Provider | 从模型广场复制准确模型 ID,仅测试一个最小请求 |
这里描述的是协议选择方法,不代表每个第三方客户端版本都已验证。客户端升级后若改变请求协议,应以其当前文档和实际请求日志为准。
7. 从错误码到原因的判断树
- 没有发出请求:先检查环境变量作用域、代理和 DNS,不要先更换模型。
- 401:检查 Key 是否复制完整、是否仍有效,以及客户端是否错误地添加了前缀。
- 403:核对 Key 权限、模型开放范围和请求协议;同一个模型名不代表所有协议都可用。
- 429:记录首次出现时间、并发数和重试次数;关闭自动重试后单请求复现,区分额度、频率和上游拥塞。
- 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。