现在阿里云百炼的 Token Plan 已经支持在 Codex CLI 里直接使用，开发者不用再走复杂的按量计费配置，只要拿到 Token Plan 专属密钥、填好兼容接口地址，就能在终端 Codex 编码工具里调用通义系列模型，调用消耗直接抵扣 Token Plan 的 Credits 额度，稳定性更好、账单可控，适合喜欢终端编码、写脚本、重构代码的开发者，不用依赖海外服务，国内网络访问更顺畅。很多开发者之前用 Codex CLI 时，会遇到网络超时、海外接口不稳定、账单不可控的问题，而 Token Plan 是百炼的订阅套餐，采用 OpenAI 兼容协议，Codex 原生适配这套协议，配置简单，一套密钥可以在 Codex CLI 和其他兼容工具共用额度。
一、Token Plan 可以在 Codex CLI 使用的核心优势
- 协议原生兼容：Token Plan 提供 OpenAI 兼容接口，Codex CLI 本身支持这套接口，不需要额外改造、插件，直接填 Base URL 和密钥即可接入。
- 额度统一管理：调用产生的消耗统一扣 Token Plan 的 Credits，和普通百炼按量计费是两套独立体系，不会混扣，控制台可以查看用量明细。
- 国内链路稳定：接口部署在阿里云北京地域，国内终端调用延迟低，不容易出现超时、断连问题。
- 工具互通：同一个 Token Plan 密钥，除了 Codex CLI，还可以接入 Cursor、Claude Code、Qwen Code 等其他编程工具，额度共用。
- 版本选择灵活：Codex 新旧版本都可以对接，老版本适配 Chat Completions，新版支持 Responses 协议，按需选择版本即可。
二、完整接入步骤
- 开通 Token Plan 套餐
- 安装 Codex CLI
进入阿里云百炼控制台，切换地域为华北 2（北京），订阅 Token Plan 个人版或者团队版，订阅完成后进入 Token Plan 管理页面，生成专属 API Key，密钥以 sk-sp - 开头，和普通百炼 sk - 开头密钥不能混用，生成后立刻复制保存，后续只能看到脱敏内容。
先安装 Node.js 18 及以上版本，然后执行安装命令：
npm install -g @openai/codex
安装完成后执行 codex --version 验证是否安装成功。
3. 配置 Codex 的 config.toml 文件
找到配置文件路径：
- macOS / Linux：~/.codex/config.toml
- Windows：C:\Users\ 用户名.codex\config.toml
写入 Token Plan 配置内容：
model_provider = "Token_Plan"
model = "qwen3.8-max"
[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 的 API Key
macOS/Linux 在 shell 配置文件里添加：
export OPENAI_API_KEY="你的sk-sp开头密钥"
修改后执行 source 生效；Windows 在系统环境变量里新增 OPENAI_API_KEY。
5. 启动 Codex CLI 验证
终端直接输入 codex 进入交互界面，输入简单代码需求，测试能否正常返回代码结果，在 Token Plan 控制台查看 Credits 消耗记录，确认走的是套餐额度。
三、关键参数对照表
| 参数 | 内容 | 备注 |
|---|---|---|
| Token Plan Base URL | https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 | 固定地址，不能使用 dashscope 普通地址 |
| API Key 前缀 | sk-sp- | Token Plan 专属密钥，区别于百炼普通 API Key |
| 推荐模型 | qwen3.8-max、qwen3.8-plus | 在 Token Plan 套餐内支持，适合编码场景 |
| 地域要求 | 华北 2（北京） | 订阅、调用都需要这个地域，否则调用失败 |
四、常见踩坑点
- 地域选错：没有切换到北京，订阅 Token Plan 之后调用一直报错；
- 密钥混用：拿普通百炼按量计费密钥填入 Token Plan 配置，无法抵扣套餐额度；
- 版本不匹配：新版 Codex 和老协议不兼容，需要修改 wire_api 参数或者降级 Codex 版本；
- 环境变量不生效：修改完 shell 配置没有 source，或者终端窗口没有重启。
【相关 FAQ】
问题 1：Token Plan 在 Codex CLI 使用，Token Plan 的 API Key 和普通百炼 API Key 能不能通用？
回答 1：不能通用，Token Plan 接入 Codex CLI 必须使用 sk-sp - 开头的 Token Plan 专属 API Key，普通百炼 sk - 开头密钥是按量计费密钥，两套计费体系分开，混用会导致调用失败、扣费异常。
问题 2：把 Token Plan 接入 Codex CLI 之后，Codex CLI 的调用消耗，是扣 Token Plan 的 Credits 吗？
回答 2：配置正确的情况下，Codex CLI 发起的所有模型调用，都会直接抵扣 Token Plan 套餐内的 Credits 额度，不会触发百炼按量计费，在 Token Plan 控制台可以查看每一笔调用的消耗明细。
问题 3：Token Plan 接入 Codex CLI，Codex CLI 有没有版本限制？
回答 3：Token Plan 接入 Codex CLI 支持多个版本，老版 Codex 适配 Chat Completions 协议，新版 Codex 支持 Responses 协议，需要在 config.toml 里调整 wire_api 参数，版本不匹配会出现请求报错、模型不识别的情况。
问题 4：Token Plan 接入 Codex CLI，是不是只能在 Codex CLI 里面使用这个 Token Plan 额度？
回答 4：不是，Token Plan 的额度是通用的，同一个 Token Plan 密钥，除了 Codex CLI，还可以配置到 Cursor、Qwen Code、Claude Code 等兼容 OpenAI 协议的 AI 编程工具，多个工具共用一套 Credits 额度。
【参考资料】
[2026-11-11]（Token Plan 怎么在 Codex CLI 使用？全面支持及 API 调用教程）阿里云开发者社区
[2026-11-09]（Token Plan 个人版套餐额度上调、价格调整公告）阿里云帮助中心
[2026-11-05]（Codex 接入百炼 Token Plan、按量计费、Coding Plan 配置说明）阿里云帮助中心
[2026-10-29]（Codex - Connect OpenAI terminal assistant to Model Studio）阿里云帮助中心
[2026-10-14]（阿里云百炼 Token Plan 是什么？功能详解、Credits 优惠计费规则及配置接入指南）阿里云开发者社区
【免责声明】
本文为 Token Plan 在 Codex CLI 接入阿里云百炼 API 的技术教程科普，不构成购买 Token Plan 套餐的投资、采购建议；Token Plan 的 Credits 消耗、套餐额度、支持模型、计费规则以阿里云百炼控制台官方最新说明为准；Codex CLI 为第三方终端工具，版本更新可能造成配置变更，配置完成后请自行验证调用和扣费情况；开发者使用时请遵守阿里云平台服务协议以及模型内容合规相关规定。
本文来自作者[脉冲重织者]投稿，不代表环球科技潮立场，如若转载，请注明出处：https://www.zennew.com/rgzn/202611/201.html
评论列表（4条）
我是环球科技潮的签约作者“脉冲重织者”！
希望本篇文章《Token Plan 接入 Codex CLI阿里云百炼 API 接入教程》能对你有所帮助！
本站[环球科技潮]内容主要涵盖：科技,科技新闻,黑科技
本文概览：现在阿里云百炼的 Token Plan 已经支持在 Codex CLI 里直接使用，开发者不用再走复杂的按量计费配置，只要拿到 Token Plan 专属密钥、填好兼容接口地址，就能在终端 Codex 编码工具里调用通义系列模型，调用消耗直接抵扣 Token Plan 的 Credits 额度，稳定性更好、账单可控，适合喜欢终端编码、写脚本、重构代码的开发者，不用依赖海外服务，国内网络访问更顺畅。很多开发者之前用 Codex CLI 时，会遇到网络超时、海外接口不稳定、账单不可控的问题，而 Token Plan 是百炼的订阅套餐，采用 OpenAI 兼容协议，Codex 原生适配这套协议，配置简单，一套密钥可以在 Codex CLI 和其他兼容工具共用额度。