Codex 国内使用指南：安装、连接与模型选择
在国内使用 Codex 时，最容易把安装、登录和模型请求混成一个问题。实际上它们是相互独立的三层：Codex CLI 能否在本机运行、你使用什么身份或 API 提供商、该提供商是否完整兼容 Codex 所需协议。分层判断会比反复重装有效得多。
第一层：安装 CLI
只要 npm 软件源可用，就可以安装 Codex CLI：
npm install -g @openai/codex
codex --version如果安装阶段失败，问题通常在 Node.js 版本、npm 源、全局目录权限或网络下载，与后续模型 API 地址无关。先让 codex --version 正常输出，再处理登录与模型连接。
第二层：选择服务方式
常见路径有两类：
- 使用 OpenAI 官方支持的账号或 API 服务，功能与兼容性以官方地区、账号和产品政策为准。
- 使用支持 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 与工具调用的文本模型。
模型名称说明
上述名称是 APIBest 暴露的服务商侧模型 ID。它们不等同于本站对模型来源、底层版本或 OpenAI 官方可用性的声明，具体映射以 APIBest 控制台和文档为准。
画图模型通常不能直接作为 Codex 的主编程模型。Claude、Gemini 或 Grok 模型即使能通过统一 API 调用，也需要 APIBest 将 Codex 的请求、流式输出和工具调用正确转换，才能用于完整代理任务。
最小连通性检查
先把密钥放入环境变量：
export APIBEST_API_KEY="你的 API Key"再测试模型列表端点：
curl https://apibest.org/v1/models \
-H "Authorization: Bearer $APIBEST_API_KEY"这个请求只能证明域名、TLS 和鉴权基本可用，不能证明 Codex 的 Responses 流式协议完整兼容。下一步应按 APIBest 配置教程 启动 Codex，并从只读的小任务开始测试。
合规与数据安全
选择任何第三方 API 时，都要判断代码是否允许发送到外部服务。公司源码、客户数据、访问令牌和生产日志可能受到保密协议或行业规则限制。对敏感项目，应确认服务商的数据保留、日志、训练使用、地域和删除政策。
不要让“能够连接”替代安全审查。密钥使用独立环境变量，按用途分配额度，定期轮换，并避免把完整生产数据作为调试提示发送。
推荐开始方式
完成配置后，先运行只读任务：
读取当前项目的 README 和 package.json，告诉我安装、测试和构建命令。不要修改文件。
如果能稳定读取项目并返回结果，再测试一次小文件修改和本地命令。出现 401、模型不存在、流式解析或工具调用错误时，按 自定义 API 排错指南 分层处理。