Codex CLI 国内配置教程

Codex CLI 国内配置教程

Codex CLI 的搜索需求很集中:怎么填 Base URL、Key 放在哪里、模型名怎么选、失败后怎么排查。这个页面用 OpenAI 兼容协议视角讲清楚配置顺序。

内容更新:2026-10-02 · 以当前模型目录、服务状态和结算页面为准

先看关键事实

入口类型OpenAI 兼容 /v1 入口
配置方式统一安装器写入 config.toml、auth.json 和模型目录
Key 来源智码 Code 控制台生成的 ck_ Key
适用范围本教程针对 Codex CLI;SDK 使用对应协议文档

怎么接入

  1. 1

    选择客户端和模型

    打开 /dashboard/access-docs 的统一 CLI 安装指南,选择 Codex 和模型,复制生成的安装命令。

  2. 2

    运行统一安装器

    执行安装命令,并在终端中私密输入控制台生成的 ck_ Key。安装器统一写入 Base URL、认证和模型目录;无需手动配置环境变量。

  3. 3

    用最小提示词测试

    先执行一个小任务,例如“解释当前目录结构”。成功后到控制台确认这次请求已经进入调用日志。

常见问题

Codex CLI 必须使用 OPENAI_BASE_URL 吗?

不需要。统一安装器将入口写入 ~/.codex/config.toml,将 Key 写入 ~/.codex/auth.json,并下载模型目录;按 /dashboard/access-docs 的命令完成配置即可。

Codex 和 OpenAI SDK 能共用同一个 Key 吗?

可以。只要都走智码 Code 的 OpenAI 兼容入口,就能使用同一个 ck_ Key,并在同一账本里查看用量。

模型名填错会怎样?

通常会返回模型不可用或权限不足。先使用控制台推荐模型验证,再按套餐权限切换。