Codex CLI 接入指南

Codex CLI 是 OpenAI 推出的 AI 编程代理终端工具。TopsDyne 提供 OpenAI 兼容协议，可直接接入。

配置方法

Codex CLI 支持 OpenAI 兼容 API，配置自定义 Base URL 与 API Key：

方式一：环境变量

export OPENAI_BASE_URL=https://api.topsdyne.com/v1
export OPENAI_API_KEY=sk-xxx    # 你的 TopsDyne API Key

启动 Codex：

codex

方式二：配置文件

编辑 Codex 配置文件（~/.codex/config.toml）：

model = "your-model-id"
model_provider = "TOPSDYNE"

[model_providers.TOPSDYNE]
name = "TopsDyne"
base_url = "https://api.topsdyne.com/v1"
env_key = "TOPSDYNE_API_KEY"

并在 shell 环境设置 Key：

export TOPSDYNE_API_KEY="sk-xxx"

协议说明

Codex 使用 OpenAI 兼容协议：

• Base URL：https://api.topsdyne.com/v1（必须带 /v1）
• 鉴权：Authorization: Bearer sk-xxx

模型配置

Codex 默认使用 OpenAI 系模型名，需替换为我们的模型 ID：

• 在售模型与型号以控制台模型广场实时展示为准（示例占位：your-model-id）
• 在配置中设置 model = "your-model-id"（替换为实际在售模型 ID）即可

验证

codex "用 Python 写一个快速排序，并解释"

故障排查

现象	处理
401	API Key 错误，或 Base URL 少了 /v1 后缀
404	Base URL 拼写错误（如多了 /chat/completions）
model not found	配置的模型名不在可用列表，改用控制台模型广场在售模型 ID

下一步

• Claude Code 接入 — Anthropic 系工具
• 接入协议 — OpenAI 兼容协议
• 常见问题 — 更多问答