Codex CLI / App

Codex 通过自定义 Provider 使用 Responses 协议接入 XSI。完成 ~/.codex/config.toml 与环境变量配置后,Codex CLI 与 Codex App 共用同一套连接参数。
配置
配置文件位置:Linux / macOS 为 ~/.codex/config.toml,Windows 为 %USERPROFILE%\.codex\config.toml。
model_provider = "xsi"
model = "gpt-6.2-sol"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
[model_providers.xsi]
name = "XSI"
base_url = "https://api.xsicontrol.com/v1" # 或你自己的 API 域名
wire_api = "responses"
requires_openai_auth = false
env_key = "XSI_API_KEY"
supports_websockets = false设置 Key 并启动:
export XSI_API_KEY="sk-Xvs..."
codex$env:XSI_API_KEY="sk-Xvs..."
codex验证:
codex exec "请用一句话回答:连接正常"model 可以是价格表中任意支持 Responses 协议的模型;账户管理控制台的“配置说明”页提供一键配置脚本,会自动填入当前账号的 Key。
Responses WebSocket
把 supports_websockets 改为 true 即使用 Responses WebSocket 模式:同一连接内只发送新增输入,长会话的延迟与流量更低。部署方需确保反向代理支持 WebSocket,见《反向代理》。
中途打断时的计费:
- HTTP 模式:Codex 断开连接并携带完整历史重发。被打断的那次请求如果没有拿到上游用量,XSI 参考同一会话最近一次的真实用量估算缺失部分,会话中已缓存的部分按缓存价计费。
- WebSocket 模式:输入新内容打断时,Codex 会等待上游返回真实用量;按 Esc 时,XSI 请求上游中断,上游支持中断的模型按返回的真实用量计费,否则同样按会话用量估算。
长会话、频繁打断的场景建议开启 WebSocket;网络或代理不支持 WebSocket 时保持 HTTP。
会话粘性
Codex 会携带会话标识,XSI 据此把同一会话固定到同一个上游 Key,以提高提示缓存命中率并降低成本,无需额外配置。