阿里云百炼正式开放 Token Plan 在 Codex CLI 里的适配能力，开发者可以直接在 Codex CLI 这个终端编码工具上调用百炼通义系列模型，采用 OpenAI 兼容接口，不用改动大量原有代码，先装好 Node.js 环境和 Codex CLI，再去百炼控制台开通 Token Plan 套餐、拿到专属 API Key，接着修改 Codex 的 config.toml 配置文件、设置环境变量，确认接口地址和参数无误之后，就能在终端直接跑代码生成、工程重构、查 bug 等编码任务，这套方案适合服务器、轻量开发环境，不用依赖厚重 IDE，使用 Token Plan 额度来抵扣调用费用，个人版和团队版都支持接入 Codex CLI。
一、前置准备清单
| 项目 | 要求说明 |
|---|---|
| Node.js 版本 | 18 及以上 |
| 工具 | Codex CLI（@openai/codex） |
| 套餐 | 阿里云百炼 Token Plan（个人版 / 团队版） |
| API Key | sk-sp 开头，Token Plan 专属密钥，和普通百炼 key 不通用 |
| 兼容接口地址 | https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
二、分步接入操作
- 安装 Codex CLI
- 获取 Token Plan API Key
- 编辑 Codex 配置文件
- 配置环境变量
- 启动并测试
打开终端执行全局安装命令：npm install -g @openai/codex，安装完成输入 codex --version，验证是否安装成功。
登录阿里云百炼控制台，进入 Token Plan 页面，个人版直接创建密钥；团队版先分配席位，再生成 API Key，密钥只展示一次，记得及时保存。
macOS/Linux 路径：~/.codex/config.toml；Windows 路径：C:\Users <用户名>.codex\config.toml，写入 Token Plan 服务商配置内容。
把 Token Plan 的 API Key 设置为 OPENAI_API_KEY 环境变量，修改完 shell 配置文件后 source 生效。
终端输入 codex，进入交互界面，直接下发编码指令，验证模型调用是否正常。
三、config.toml 参考配置
model_provider = "Token_Plan"
model = "auto"
[model_providers.Token_Plan]
name = "Token_Plan"
base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
四、Token Plan 在 Codex CLI 的适用场景
- 服务器环境下直接写代码、调试脚本
- 批量代码重构、漏洞扫描、单元测试生成
- 阅读项目代码、生成开发文档
- 运维脚本编写、自动化任务开发
五、常见踩坑点
- API Key 类型不对：普通 DashScope 的 sk 密钥不能用于 Token Plan，必须 sk-sp 开头。
- Node 版本过低：会出现 Codex 安装或者运行报错，建议用 nvm 管理版本。
- 配置文件路径写错：找不到 config.toml 会导致一直走默认服务商。
- 网络问题：base_url 为国内阿里云地址，不需要境外网络。
【常见问题】
问题 1：Token Plan 在 Codex CLI 可用是什么意思，Token Plan 和 Codex CLI 是什么关系？
回答 1：Token Plan 是阿里云百炼的模型订阅套餐，现在支持 Codex CLI 接入，Codex CLI 是终端 AI 编码工具，开发者配置 Token Plan 的 API 和兼容地址后，就可以在 Codex CLI 里调用百炼通义模型，消耗 Token Plan 额度。
问题 2：接入 Codex CLI 的 Token Plan API Key，和普通百炼 DashScope 密钥能混用吗？
回答 2：不可以，Token Plan 接入 Codex CLI 使用的 API Key 是以 sk-sp 开头的专属密钥，普通百炼密钥格式不一样，不能直接放到 Codex CLI 的 Token Plan 配置里使用。
问题 3：个人版 Token Plan 能不能接入 Codex CLI，还是只能团队版？
回答 3：个人版 Token Plan、团队版 Token Plan 都支持接入 Codex CLI，两者只是密钥生成方式不同，Codex CLI 的配置模板完全一致。
问题 4：接入 Token Plan 之后，Codex CLI 还能切换其他计费方案吗？
回答 4：可以，Codex CLI 支持切换服务商，除了 Token Plan，也可以切换成 Coding Plan、按量计费模式，修改 config.toml 里的 model_provider 和对应地址即可。
【参考资料】
[2026-11-11]（Codex - 大模型服务平台百炼）阿里云帮助中心
[2026-11-10]（Token Plan 支持 Codex CLI 啦！阿里云百炼 AI 模型接入教程）阿里云开发者社区
[2026-11-06]（Token Plan 概览）阿里云帮助中心
[2026-10-29]（Codex Connect OpenAI terminal assistant to Model Studio）阿里云英文帮助文档
【免责声明】
本文仅为阿里云百炼 Token Plan 对接 Codex CLI 的教程资讯整理，配置参数、接口地址、套餐权限以阿里云百炼官方文档和控制台最新规则为准；API Key 属于敏感凭证，泄露会带来额度消耗风险，本文不构成开发、付费采购建议。