Skip to Content

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] 块保留官方配置, 通过 --providerprofile 按需切换。

Q: 公司账单与个人使用怎么区分? A: 在控制台为”个人试验”和”公司项目”分别创建两把 owo- Key, 通过 TTTTT_API_KEY / TTTTT_PERSONAL_KEY 两个变量切换。 控制台的审计日志也会按密钥聚合,便于月底对账。

Q: 模型路由是怎样的? A: gpt-5.5 / gpt-5.4 会按 Channel 优先级路由到具体上游; 出现 5xx 自动重试 + 降级到同型号其它 Channel。详见 模型清单

Last updated on