Codex CLI 接入 CCSub：OpenAI Base URL 与模型选择完整教程

Codex CLI 是 OpenAI 推出的命令行编程工具，但默认配置需要官方 API Key，且网络访问受限。通过 CCSub（https://ccsub.xyz）提供的 OpenAI 兼容接口，你可以轻松让 Codex CLI 使用 Claude、GPT 等模型，同时享受更灵活的计费。本文将一步步带你完成接入，并解决常见问题。

为什么选择 CCSub 接入 Codex CLI？

CCSub 是一个统一的 AI API 聚合平台，提供 OpenAI 兼容的 Base URL 和 Anthropic 兼容接口。你只需要一个 CCSub 的 API Key，就能在 Codex CLI 中调用多种模型，例如 Claude Sonnet 4.6、Claude Opus 4.8、GPT-5.6 等。无需为每个模型单独注册账号，而且支持国内网络直连，无需科学上网，价格也更加友好。

准备工作：注册 CCSub 并获取 API Key

1. 访问 https://ccsub.xyz 注册账号。
2. 登录后进入“API 密钥”页面，创建一个新的密钥，格式如 sk-你的CCSub密钥。
3. 根据需要充电，保证账户有足够余额。CCSub 支持按量付费，1 元 = 1 美元额度，性价比很高。

配置 Codex CLI 使用 CCSub

Codex CLI 支持通过环境变量配置 OpenAI 兼容的 Base URL。你需要设置以下两个变量：

• OPENAI_BASE_URL 设为 https://ccsub.xyz/v1
• OPENAI_API_KEY 设为你的 CCSub API Key

具体操作取决于你的系统：

MacOS / Linux 临时配置

export OPENAI_API_KEY="sk-你的CCSub密钥"
export OPENAI_BASE_URL="https://ccsub.xyz/v1"
codex

Windows PowerShell 临时配置

$env:OPENAI_API_KEY="sk-你的CCSub密钥"
$env:OPENAI_BASE_URL="https://ccsub.xyz/v1"
codex

永久配置（推荐）

在你的 shell 配置文件（如 ~/.zshrc、~/.bashrc）中追加以上两行，然后执行 source ~/.zshrc 或重新打开终端。

验证配置是否成功

启动 Codex CLI 后，可以运行一个简单命令，例如 codex "say hello"，如果正常返回，说明配置成功。如果失败，请检查 API Key 是否有效，以及网络是否能访问 CCSub。

查看可用模型列表

CCSub 提供 GET /v1/models 接口，你可以通过以下命令查看所有可用的模型 ID：

curl https://ccsub.xyz/v1/models -H "Authorization: Bearer sk-你的CCSub密钥"

返回的 JSON 中包含模型 ID，例如 claude-sonnet-4-6、gpt-5.6-sol 等。你可以将这些 ID 用于 Codex CLI 的模型配置。

在 Codex CLI 中指定模型

Codex CLI 默认使用 OpenAI 的模型，但通过 CCSub，你可以切换到其他模型。例如，使用 --model 参数：

codex --model claude-sonnet-4-6 "解释这段代码"

你也可以在配置文件中设置默认模型。具体请参考 Codex CLI 的文档。

常见错误与排查

连接错误（connect_error）

如果出现网络连接问题，请检查你的网络能否访问 https://ccsub.xyz。CCSub 支持国内直连，但可能需要关闭代理或添加白名单。

空响应（empty_response）

可能因为模型负载过高导致超时，请稍后重试，或尝试切换其他模型。

模型不可用（model_unavailable）

你指定的模型 ID 可能不存在或已下线，请通过 /v1/models 查询当前可用模型。

上游客户端错误（upstream_client_error）

如果出现 401 或 403，请检查 API Key 是否正确，或账户余额是否充足。可在 CCSub 控制台查看余额。

成本控制与充值提醒

CCSub 按 token 计费，不同模型价格不同。例如 Claude Sonnet 4.6 输入 12 美元/百万 token，输出 60 美元/百万 token。你可以在 CCSub 的价格页面查看所有模型定价。建议先小笔充值（如 10 元）测试下载量，再根据使用情况追加。

CCSub 提供 Token 明细查询，方便你监控每个请求的消耗。在控制台的“用量明细”中可以看到每次调用的输入/输出 token 数和费用。

支持更多工具

除了 Codex CLI，CCSub 还支持 Claude Code、Cursor、VS Code、Windsurf、CherryStudio 等常用 AI 编程工具。配置方法类似：

• Claude Code：设置 ANTHROPIC_BASE_URL 为 https://ccsub.xyz 和 ANTHROPIC_AUTH_TOKEN 为你的密钥。
• 其他 OpenAI 兼容工具：设置 Base URL 为 https://ccsub.xyz/v1，模型列表通过 /v1/models 获取。

立即开始

现在你已经知道如何将 Codex CLI 接入 CCSub。前往 CCSub 官网 注册并获取 API Key，按照本文步骤配置，即可享受多模型、低成本、稳定的 AI 编程体验。如果在配置过程中遇到问题，可查阅 故障排查文档 或联系客服。