接入 GPT Bridge
选择你正在使用的客户端,复制对应配置即可。默认推荐 Codex / OpenAI-compatible 接入。
1
第一步:配置环境变量
Claude Code 使用 ANTHROPIC_AUTH_TOKEN 读取 GPT Bridge API Key。先完成密钥配置,再继续第二步。
Windows / PowerShell
正在读取配置...
把 gb_live_请替换为你的密钥 换成管理员提供的 API Key 后执行。Windows 命令保存为用户环境变量,需重开终端和客户端;macOS / Linux 的 export 只对当前终端有效,请从该终端启动客户端。长期使用可将 export 行加入当前 shell 的启动文件,图形应用需确认启动环境能读取它。不要使用网页登录密码。
2
第二步:配置 settings.json 字段
打开用户级 ~/.claude/settings.json;Windows 路径是 %USERPROFILE%\.claude\settings.json。文件不存在则创建,已有内容则先备份,再合并下面的 env 对象,保留权限、hooks 等其他字段。JSON 不支持注释,注意逗号,不要重复创建同名字段。
settings.json 字段片段
正在读取配置...
第一步的认证变量不需要再写进 settings.json。检查已有 ANTHROPIC_API_KEY、ANTHROPIC_MODEL 等进程环境是否与这份设置冲突。原生 Anthropic Messages 路径支持 low / medium / high / xhigh / max,具体 effort 取决于所选模型。
完成第一步和第二步后,重新启动 Claude CodeWindows 先重开终端再运行 claude;macOS / Linux 从已配置环境变量的终端启动。重启后再进行第三步。
3
第三步:手动选择与显示模型
从控制台首页复制真实的模型 ID,在 Claude Code 输入 /model 模型ID,或启动时使用 claude --model 模型ID。默认模型仍可通过第二步的 ANTHROPIC_MODEL 修改。
如需在 /model 选择器中增加一个可见选项,把下面字段合并到同一份 settings.json 的 env 中,并将示例模型 ID 换成你要使用的完整 ID,然后重新启动 Claude Code。
ANTHROPIC_CUSTOM_MODEL_OPTION 添加一个选项;NAME 是显示名称。新版还可使用 modelPicker 配置多个选项,availableModels 仅限制允许范围。功能以本机 Claude Code 版本为准。
可选:询问助手如何配置多个可见模型
这段提示词只让助手检查版本并给出手动配置说明。先完成前两步并重启,再发送。
Claude Code 官方模型配置说明
1
第一步:配置环境变量
Codex 使用 GPTBRIDGE_KEY 读取 GPT Bridge API Key。先复制并执行适合你系统的命令,再继续第二步。
Windows / PowerShell
正在读取配置...
把 gb_live_请替换为你的密钥 换成管理员提供的 API Key 后执行。Windows 命令保存为用户环境变量,需重开终端和客户端;macOS / Linux 的 export 只对当前终端有效,请从该终端启动客户端。长期使用可将 export 行加入当前 shell 的启动文件,图形应用需确认启动环境能读取它。不要使用网页登录密码。
2
第二步:配置 config.toml 字段
打开用户级 ~/.codex/config.toml;Windows 路径是 %USERPROFILE%\.codex\config.toml。如果使用了自定义 CODEX_HOME,请打开该目录内的 config.toml。不要将 Provider 配置放进项目目录的 .codex/config.toml。
- 先备份原文件。文件不存在则创建,已有内容则逐项合并,保留其他设置。
- 将
model_provider = "gptbridge" 放在文件顶部、任何 [表头] 之前;已有该字段则修改原值,不重复添加。
- 已有
[features] 时只合并 image_generation = true,不要再建第二个同名表。
- 在文件末尾添加
[model_providers.gptbridge] 及其字段;同名表已存在则更新原表。
完成第一步和第二步后,完全退出并重新打开 Codex 客户端仅关闭聊天或新建线程不会重新读取配置。Windows 同时重开启动终端;macOS / Linux 确认客户端从带有密钥环境变量的环境启动。重启后再进行第三步。
3
第三步:让模型配置可用模型列表
确认前两步已完成并重启 Codex 后,复制下面的提示词,发给 Codex。它只负责查询模型目录、配置可见模型并验证,不再替你配置环境变量或 Provider。
助手修改模型目录后,按它的说明再次重启 Codex,查看模型选择器。以后需要刷新列表时也可使用这段提示词。