Codex 接入

用独立 profile 配置 Orbis Responses 线路，保留原有登录，验证模型、续聊和文件工具。

将 Codex CLI 接到 Orbis 的 GPT 线路。安装、第一次文件任务及进阶操作见 Codex 新手入门图文教程。

1. 准备 Responses 线路的 Key

在 模型广场 选择 GPT 文本模型，例如 GPT-6.1 Sol，为支持 OpenAI Responses 的线路创建 Key。Key 绑定线路，不能只改模型名来换线路。

Codex 需要 Responses 的流式输出、续聊与工具调用；只有 Chat Completions 接口的线路不能直接套用本文。GPT 图片模型不适用。

2. 创建独立配置

先运行 codex --version。以下使用 0.134.0 及以上的 独立 profile 文件，不会替换你的默认配置。

在 ~/.codex/orbis.config.toml 新建文件，Windows 为 %USERPROFILE%\.codex\orbis.config.toml；同名文件已存在时先备份、再合并：

model = "gpt-6.1-sol"
model_provider = "orbis"
web_search = "disabled"

[model_providers.orbis]
name = "Orbis"
base_url = "https://api.orbiorbi.com/v1"
wire_api = "responses"
env_key = "ORBIS_API_KEY"

地址保留 /v1，不加 /responses；env_key 是变量名，不是密钥。顶部三项放在表头之前，不要包在旧的 [profiles.orbis] 下。先关闭网页搜索，接通后再核对所选线路的附加能力。

在线路 快速接入 → 工具接入 → Codex CLI 中核对当前模型与配置。若模型未被当前 Codex 识别，需使用线路提供的匹配模型目录；不要随意改成另一个模型别名或填写不存在的目录文件。

3. 输入 Key，用 profile 启动

在项目目录打开终端。提示出现后粘贴 Key，输入不会显示。

$env:ORBIS_API_KEY = [System.Net.NetworkCredential]::new('', (Read-Host '粘贴 Orbis Key' -AsSecureString)).Password
codex --profile orbis

# macOS 默认终端 Zsh
printf '粘贴 Orbis Key：'
read -rs ORBIS_API_KEY
printf '\n'
export ORBIS_API_KEY
codex --profile orbis

新开终端需要重新输入 Key。恢复会话使用 codex --profile orbis resume；切回原默认配置，退出后运行不带 profile 的 codex。项目和托管配置仍可能影响最终设置。

4. 验证一次真实请求

  1. /status 核对 provider、模型和目录。
  2. 发送“只回复 OK”，到 使用日志 核对实际模型、线路与扣费；请求会使用 API 额度。
  3. 再读取一份练习文件，并追问一句，分别检查工具调用与续聊。
现象检查什么
缺少 ORBIS_API_KEY / 401变量是否在启动 Codex 的同一个终端中设置，Key 是否有效
配置没有生效版本是否支持独立文件，是否带 --profile orbis
404 / 模型不可用/v1 地址、精确 ID、Key 所属线路
能回答，工具或续聊失败该线路的 Responses 兼容性，保留脱敏错误信息

本文配置用于 CLI；从桌面图标启动的应用不会自动获得终端变量。其他客户端表面的配置边界见 官方网关说明。完整安装与任务示例见 图文教程。