Codex 国内使用指南：安装、连接与模型选择

Codex 国内使用指南：安装、连接与模型选择

从 CLI 安装、账号登录、自定义 API 和网络连通四个层次说明 Codex 在国内的可行使用方式。

Codex 国内使用指南：安装、连接与模型选择#

在国内使用 Codex 时，最容易把安装、登录和模型请求混成一个问题。实际上它们是相互独立的三层：Codex CLI 能否在本机运行、你使用什么身份或 API 提供商、该提供商是否完整兼容 Codex 所需协议。分层判断会比反复重装有效得多。

第一层：安装 CLI#

只要 npm 软件源可用，就可以安装 Codex CLI：

bash
npm install -g @openai/codex
codex --version

如果安装阶段失败，问题通常在 Node.js 版本、npm 源、全局目录权限或网络下载，与后续模型 API 地址无关。先让 codex --version 正常输出，再处理登录与模型连接。

第二层：选择服务方式#

常见路径有两类：

  1. 使用 OpenAI 官方支持的账号或 API 服务，功能与兼容性以官方地区、账号和产品政策为准。
  2. 使用支持 Codex 所需协议的第三方 OpenAI-compatible API，并在用户级配置中定义模型提供商。

本站提供 APIBest 的自定义 API 配置示例，API 基础地址为 https://apibest.org/v1。第三方服务并非 OpenAI 官方服务，账号、数据处理、模型映射、价格和可用性由服务商负责，使用前应自行核对条款。

第三层：确认 Codex 协议兼容#

一个 API 能完成普通聊天，不代表它能完整运行 Codex。Codex 的编程任务可能需要：

  • Responses API 请求和流式事件。
  • 工具调用及工具结果回传。
  • 长上下文和多轮状态。
  • 推理相关字段与输出项。
  • 稳定的错误码、限流和超时行为。

APIBest 当前提供 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.5 等模型标识，并提供 Claude、Gemini、Grok 和画图类模型。对于 Codex，应优先选择服务商明确标注支持 Responses API 与工具调用的文本模型。

::: info 模型名称说明 上述名称是 APIBest 暴露的服务商侧模型 ID。它们不等同于本站对模型来源、底层版本或 OpenAI 官方可用性的声明，具体映射以 APIBest 控制台和文档为准。 :::

画图模型通常不能直接作为 Codex 的主编程模型。Claude、Gemini 或 Grok 模型即使能通过统一 API 调用，也需要 APIBest 将 Codex 的请求、流式输出和工具调用正确转换，才能用于完整代理任务。

最小连通性检查#

先把密钥放入环境变量：

bash
export APIBEST_API_KEY="你的 API Key"

再测试模型列表端点：

bash
curl https://apibest.org/v1/models \
  -H "Authorization: Bearer $APIBEST_API_KEY"

这个请求只能证明域名、TLS 和鉴权基本可用，不能证明 Codex 的 Responses 流式协议完整兼容。下一步应按 APIBest 配置教程 启动 Codex，并从只读的小任务开始测试。

合规与数据安全#

选择任何第三方 API 时，都要判断代码是否允许发送到外部服务。公司源码、客户数据、访问令牌和生产日志可能受到保密协议或行业规则限制。对敏感项目，应确认服务商的数据保留、日志、训练使用、地域和删除政策。

不要让“能够连接”替代安全审查。密钥使用独立环境变量，按用途分配额度，定期轮换，并避免把完整生产数据作为调试提示发送。

推荐开始方式#

完成配置后，先运行只读任务：

读取当前项目的 README 和 package.json，告诉我安装、测试和构建命令。不要修改文件。

如果能稳定读取项目并返回结果，再测试一次小文件修改和本地命令。出现 401、模型不存在、流式解析或工具调用错误时，按 自定义 API 排错指南 分层处理。