Codex CLI 接入
Codex CLI 是 OpenAI 官方的本地 Agent。
默认走 api.openai.com,通过配置可以把它切到任意兼容 OpenAI 协议的网关。
ttttt.ai 实现了 /v1/chat/completions 与 /v1/responses 两条路径,
可以直接作为 Codex 的上游。
1. 准备 API Key
登录 app.ttttt.ai → API 密钥 → 创建密钥。
密钥以 owo- 开头,确保授权范围覆盖 gpt-5.5 / gpt-5.4
(当前测试阶段仅公开这两款)。
2. 配置 Codex
方式 A:环境变量(最快)
export OPENAI_BASE_URL="https://api.ttttt.ai/v1"
export OPENAI_API_KEY="owo-..."
codex方式 B:~/.codex/config.toml(推荐)
Codex CLI 的官方配置目录是 ~/.codex/。新建或编辑 config.toml:
model_provider = "ttttt"
model = "gpt-5.5"
[model_providers.ttttt]
name = "ttttt.ai"
base_url = "https://api.ttttt.ai/v1"
env_key = "TTTTT_API_KEY"
wire_api = "chat"然后把密钥写进环境:
export TTTTT_API_KEY="owo-..."
codex这样 Codex 的默认模型就是 gpt-5.5,所有请求走 ttttt.ai,
并通过 TTTTT_API_KEY 与其他厂商密钥隔离。
方式 C:按任务覆盖
单次临时使用:
codex --model gpt-5.4 --provider ttttt "重构这个文件"3. 验证链路
codex --version
codex "写一个 hello world"回到控制台 用量 页,能看到模型 = gpt-5.5、耗时、token 消耗等明细。
4. 常见问题
Q: 要用 Responses API 吗?
A: wire_api = "chat" 足够覆盖 Codex 目前的用法;
若需要函数调用 / 多轮 tool 使用,改成 wire_api = "responses",
网关会自动映射到 /v1/responses。
Q: 可以同时配置 OpenAI 官方和 ttttt.ai 吗?
A: 可以。在 config.toml 里加一个 [model_providers.openai] 块保留官方配置,
通过 --provider 或 profile 按需切换。
Q: 公司账单与个人使用怎么区分?
A: 在控制台为”个人试验”和”公司项目”分别创建两把 owo- Key,
通过 TTTTT_API_KEY / TTTTT_PERSONAL_KEY 两个变量切换。
控制台的审计日志也会按密钥聚合,便于月底对账。
Q: 模型路由是怎样的?
A: gpt-5.5 / gpt-5.4 会按 Channel 优先级路由到具体上游;
出现 5xx 自动重试 + 降级到同型号其它 Channel。详见 模型清单。