ROUTEX API GATEWAY
把 Claude Code 和 Codex
接入你的 RouteX。
填入 RouteX 控制台提供的 API Base URL 与密钥,复制配置即可开始。密钥仅在你的浏览器中生成示例,不会被保存或发送。
01 · 接入参数
先准备这两项
从 RouteX 控制台的 API Key 页面复制。Base URL 应是完整 API 地址,通常以 /v1 结尾。
02 · ANTHROPIC 兼容
Claude Code
RouteX 为 Claude Code 提供 Anthropic 兼容接口。复制下面内容到终端,然后运行 claude。
说明该配置使用 RouteX API 的 Claude Code 兼容接入方式,并关闭非必要的外部请求。
Terminal
长期使用可写入 ~/.zshrc 或 ~/.bashrc;不要提交包含密钥的配置文件。
03 · OPENAI RESPONSES 兼容
Codex
在 ~/.codex/config.toml 创建或合并以下配置,再把 API Key 写进 ~/.codex/auth.json。
说明该配置使用 RouteX API 的 OpenAI/Codex 兼容接入方式;Base URL 必须支持 Responses API。
~/.codex/config.toml
~/.codex/auth.json
完成后在任意项目目录运行 codex。API Key 不写进 config.toml。
04 · TROUBLESHOOTING
连不上?从这里检查
- 401 / Unauthorized
- 密钥无效、已轮换,或
auth.json格式不正确。 - 404 / Model not found
- 模型名必须和 RouteX 控制台展示的精确 ID 一致。
- Codex 请求失败
- 确认 Base URL 带有
/v1,并且网关开启了 Responses API。 - Claude Code 请求失败
- 确认
ANTHROPIC_BASE_URL使用了 RouteX 控制台显示的 Base URL。
安全建议
令牌属于密码,不属于代码仓库。
使用环境变量或本地配置文件管理密钥。如果密钥曾被提交到 Git,请立即在 RouteX 控制台轮换。