Codex CLI 国内配置教程

Codex CLI 国内配置教程

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

先看关键事实

入口类型OpenAI 兼容 /v1 入口
核心变量OPENAI_BASE_URL、OPENAI_API_KEY、模型名
Key 来源智码 Code 控制台生成的 ck_ Key
适用范围Codex CLI、OpenAI SDK、兼容命令行工具

怎么接入

  1. 1

    确认 Codex CLI 可运行

    先在本地确认 codex 命令可执行,再开始修改 API 配置,避免把安装问题误判为接口问题。

  2. 2

    写入 OpenAI 兼容配置

    把 OPENAI_BASE_URL 设置为智码 Code 的 OpenAI 兼容地址,把 OPENAI_API_KEY 设置为 ck_ Key。

  3. 3

    用最小提示词测试

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

常见问题

Codex CLI 必须使用 OPENAI_BASE_URL 吗?

如果工具支持自定义 OpenAI 兼容入口,就应把 Base URL 指向智码 Code;不同版本的配置文件名称以客户端实际说明为准。

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

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

模型名填错会怎样?

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