ROUTEX / 文档 / 客户端接入

ROUTEX API GATEWAY

把 Claude Code 和 Codex
接入你的 RouteX。

填入 RouteX 控制台提供的 API Base URL 与密钥,复制配置即可开始。密钥仅在你的浏览器中生成示例,不会被保存或发送。

Claude CodeCodexResponses API

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

自定义 Provider

~/.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 控制台轮换。