Codex CLI 接入¶
本页通过 Codex CLI 的自定义提供商配置接入 RouteFast/sub2api 的 GPT 路由：
- 自定义 provider id：
routefast； - Base URL：
https://api.routefast.ai/v1； - 鉴权：从环境变量
ROUTEFAST_API_KEY读取； - 协议：
responses； - WebSocket：默认关闭，使用 HTTP/SSE。
请使用 OpenAI-ChatGPT 分组的密钥，先完成一次简单文本请求，再用于实际项目。
安装 Codex CLI¶
macOS 或 Linux：
也可以使用 npm：
安装后检查：
最新安装方式见 Codex CLI 官方文档。
1. 设置密钥¶
macOS / Linux / WSL：
Windows PowerShell：
环境变量名是配置中自定义的，不要改成密钥本身。以上设置只对当前终端及随后启动的进程有效；在同一终端运行 codex，新窗口需要重新注入。写好 config.toml 并不会自动保存环境变量中的密钥。长期使用可由密码管理器、系统凭证工具或 CI Secret 注入，不要把密钥放进项目配置或仓库。
2. 配置 config.toml¶
用户级配置文件位于：
- macOS / Linux / WSL：
~/.codex/config.toml - Windows：
%USERPROFILE%\.codex\config.toml
若设置过 CODEX_HOME，应编辑该目录下实际使用的 config.toml。先复制已有配置，保留一份带日期的备份，例如 config.toml.before-routefast-20260907；备份名已存在时换一个名称。
如果文件已存在，请分别合并顶层字段和 provider 配置段。TOML 中 [model_providers.routefast] 后的字段属于该表，空行不会切回顶层。 把 model_provider、model 等顶层字段放在第一个 [表名] 之前；已有同名字段时修改原值，不要再重复追加一份：
model_provider = "routefast"
model = "gpt-5.6-terra"
model_reasoning_effort = "medium"
[model_providers.routefast]
name = "RouteFast.AI"
base_url = "https://api.routefast.ai/v1"
env_key = "ROUTEFAST_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
说明：
- 该 RouteFast 配置的
base_url包含/v1； wire_api当前只支持responses；env_key是官方推荐的自定义提供商密钥方式；- 不要同时配置
env_key、experimental_bearer_token和 provider 的其他鉴权方式； requires_openai_auth = false表示不要求 ChatGPT OAuth 登录；supports_websockets = false让客户端走 HTTP/SSE。
这些字段可在 Codex 配置参考 中核对。当前官方规定 provider 配置放在用户级文件中，项目内 .codex/config.toml 中的 model_provider / model_providers 会被忽略。不要用保留的 openai、ollama、lmstudio 作为自定义 ID。
客户端配置不能代替 RouteFast 和上游的数据保留政策，敏感数据处理建议见密钥与数据安全。
3. 启动并检查¶
进入你的项目目录：
启动后运行：
确认 provider 是 routefast，模型是预期值。发送“只回复：连接测试成功，不调用工具”，收到完整回答后到 RouteFast 用量记录中核对时间与模型。该请求可能产生费用，成功只验证本次文本调用。
如果仍使用其他配置，检查是否带了 --model / --config / --profile 启动参数、是否使用了另一个 CODEX_HOME，以及项目是否覆盖了模型字段。官方配置说明
选择模型¶
本页示例沿用 gpt-5.6-terra。先检查该模型是否在当前密钥的目录中，再试一次请求；若不可用，使用你实际获准访问的精确模型 ID。
部分名称属于 RouteFast 的路由名。目录不提供对推理档位、工具调用、上下文长度或实时容量的完整保证；medium 也是示例值。若响应指出推理参数不支持，按错误体调整，并将客户端版本、模型和脱敏错误交给支持团队确认。不要为了匹配其他平台教程自行填写超大上下文窗口或打开未经验证的搜索、图片等能力。
切换模型¶
启动时可用 -m 指定本次会话模型；下面的 ID 同样需要在你的密钥目录中：
也可在 Codex 会话内使用 /model，切换后用 /status 核对实际模型。
CI 与脚本¶
自动化环境同样需要可读的用户级 provider 配置，以及由 CI Secret 注入的 ROUTEFAST_API_KEY。先在交互会话完成验证，再从实际项目目录执行：
提示词不是权限隔离措施，应按工作流设置 CLI 的权限与沙盒。不要把 Codex 暴露为无需授权的公共执行服务；它可能读取文件、运行命令并修改代码。CI、MCP 或其他外部工具需要各自的配置与权限控制。
恢复其他提供商¶
先退出 Codex，对照接入前备份恢复原来的顶层 model_provider、model 和推理设置；再按需要移除 [model_providers.routefast]。只删除 provider 表而仍保留 model_provider = "routefast" 会留下无效配置。 如果期间修改了其他设置，按字段合并；只有确认没有需要保留的新改动时，才用整份备份恢复。
环境变量可用下面的命令从当前 shell 移除：
Windows PowerShell：
这不会移除 shell 启动文件、系统用户变量或 CI Secret 中的持久值；还需在原注入位置清理本次设置。重新启动后用 /status 确认 provider 和模型已恢复，原提供商的认证按其原有方式处理。