Codex CLI

Codex CLI 使用 OpenAI API。将其指向 OpenAI 兼容网关即可。

快速入门

本指南将帮助您在几分钟内运行由平台提供支持的Codex CLI。

步骤1: 安装 Codex CLI

请按照 Codex CLI 安装说明 在您的系统上安装 CLI。

步骤2: 配置Codex

Codex 使用一个config.toml文件，通常位于~/.codex/config.toml。请使用以下配置创建或编辑此文件，文件内容如下。

model_provider = "llmpool"
model_reasoning_effort = "high"
model="~openai/gpt-latest"

[model_providers.llmpool]
name = "llmpool"

base_url="openai url"
env_key="LLMPOOL_API_KEY"

步骤3: 设置密钥

# Add to ~/.zshrc, ~/.bashrc, or ~/.config/fish/config.fish
export LLMPOOL_API_KEY="..."

步骤4: 开始编写代码

cd /.../project
codex

步骤5: 验证

您可以通过/status在 Codex CLI 中运行命令来确认您的连接。

> /status
Model provider: llmpool - ...

连接失败时诊断

如果通过 CC Switch 导入后 Codex 仍不可用，请在“接入指南”页面下载 check-codex-integration.sh，在下载目录打开终端并运行：

chmod +x check-codex-integration.sh && ./check-codex-integration.sh

脚本会检查 Codex CLI、CC Switch 当前 Codex Provider 数据库记录、~/.codex/config.toml、认证来源和 /models 响应，然后默认发送一次最小 Responses API 请求和一次真实 codex exec 请求。它不会输出 API 密钥。codex exec 请求通过，代表当前 Codex 配置到该中转网关和所选模型的基础请求流程是通的；本检测没有覆盖所有流式输出、工具调用或 MCP 场景。

两次请求都可能产生费用，需要时可分别跳过：

./check-codex-integration.sh --skip-responses
# 只跳过 Codex 端到端请求：
./check-codex-integration.sh --skip-codex-exec