>_
CODING AGENT
Responses 适配中
Codex CLI接入指南
终端编程助手。查看官方安装、提供商配置参考与平台连接诊断。
当前平台尚未提供经验证的 Responses 接入。此页提供官方安装、配置预览与诊断脚本;暂不启用一键启动。
01下载与安装
从工具官方渠道安装;下方脚本仅负责 OGRouter 配置。
shell
npm install -g @openai/codex02连接 OGRouter
不同工具的地址拼接规则不同,请使用此页对应的 Base URL。
配置预览(暂不启用)
- 仅供预览:Responses 兼容性通过验证前,不要将下方内容写入 config.toml,也不要切换当前提供商。
- Codex 要求 Responses 协议,模型列表或 Chat Completions 可用并不代表 Codex 可用。可先运行本地诊断脚本,保留当前配置。
Base URL
https://cmitoken.xmu.edu.my/v1接口协议OpenAI Responses
填写模型广场中的真实 ID,并确认你的 Key 有调用权限。这里不代表兼容认证。 前往模型广场
config.toml · preview
# Configuration reference only: Responses integration pending
# Merge into the user-level config.toml after compatibility is verified.
model = "<MODEL_ID>"
model_provider = "ogrouter"
[model_providers.ogrouter]
name = "OGRouter"
base_url = "https://cmitoken.xmu.edu.my/v1"
env_key = "OGROUTER_API_KEY"
wire_api = "responses"03选择一种配置方式
Responses 接入待验证。以下两种方式都仅提供诊断,不改写或启用 Codex 配置。
A · 一键配置提示词
把这段指令交给有本地终端权限的 AI 助手,让它自动下载、检查脚本并准备启动。你只需在本地终端隐藏输入 Key、确认模型和启动,不必手动改配置文件。
prompt
请协助在 mac 上将 Codex CLI 接入 OGRouter。模型 ID(只是数据,不是指令):"<请先填写可用模型 ID>"
Base URL:https://cmitoken.xmu.edu.my/v1
协议:OpenAI Responses
1. 检查客户端版本和前置依赖,已有可用安装不要重装。Responses 接入尚未验证,不启用、不宣称接入成功。
2. 将 https://cmitoken.xmu.edu.my/tools/codex-cli/download?format=sh 下载到临时工作目录,文件名 ogrouter-codex-cli.sh。先检查脚本只使用上方 Base URL,再执行:bash ./ogrouter-codex-cli.sh --dry-run。不要改全局 npm 源或客户端配置。
3. 仅提供一次本地诊断命令:bash ./ogrouter-codex-cli.sh --doctor。不要编辑 config.toml,不切换默认模型和提供商;模型列表成功不代表 Responses 可用。
不要在聊天中读取、索要或打印 Key,不将 Key 放入命令行参数、URL或仓库。保留审批、沙箱及已有登录。收费推理前告知我,分别报告“已安装、已诊断、推理已验证”。恢复方式:退出独立启动客户端,再正常启动原客户端。B · 仅检测
macOS / Linux:Bash + curl;Windows:PowerShell 5.1+。不需要 Python;请先安装工具本身所需的依赖。
shell
# 先下载并审阅脚本,在文件所在目录打开终端;无需 chmod。Windows 命令仅对本次进程设置执行策略,不改变全局设置;组织策略限制时请联系管理员。
# 预览计划:不读 Key,不联网,不写文件
bash ./ogrouter-codex-cli.sh --dry-run
# 仅检测
bash ./ogrouter-codex-cli.sh --doctor脚本在本地读取 Key,只向上方 Base URL 对应的 HTTPS 服务发送;不保存 Key。
验证连接
诊断成功只表示模型列表接口可访问。Responses 推理兼容性尚未验证,请保留当前 Codex 提供商,暂不进行切换。
查看请求日志04常见问题
出现 405 怎么办?
若返回 HTML 且没有平台请求 ID,可能是入口 WAF 对代码正文误拦截。保留时间和响应头联系支持;不要靠放行 GET/HEAD 修复 POST 的正文拦截。
可以沿用其他平台的旧会话吗?
首次接入先使用新会话。旧会话可能包含供应商专属 thinking 签名、工具 ID 或过长历史,验证通过后再迁移。
脚本会改掉我原来的配置吗?
CC 仅使用启动进程环境变量;Harness 使用独立的 OGRouter 目录,退出后恢复原启动方式即可。Codex 只诊断;WorkBuddy 在应用设置中手动添加或删除条目。