Codex 接入指南

推荐使用 CC Switch 配置 TokenPlus，通过本地路由在 Codex 中调用模型。

本文介绍如何通过 CC Switch 为 Codex 配置 TokenPlus 供应商，选择模型并开始对话。推荐使用 CC Switch 管理地址、密钥和模型，无需手动编辑 Codex 配置文件。

Codex 原生使用 OpenAI Responses API。本指南通过 CC Switch 本地路由将请求转换为 OpenAI Chat Completions，再发送到 TokenPlus。仅填写 Base URL 并不代表接口协议兼容，使用过程中需要保持 CC Switch 和本地路由运行。

第一步：安装 Codex 和 CC Switch

按照 Codex 官方安装说明安装 Codex CLI。安装完成后，在终端检查：

codex --version

按照 CC Switch 接入指南安装 CC Switch。本指南按 CC Switch 4.x 的界面说明；如果找不到上游格式或本地路由选项，请先更新 CC Switch。

第二步：准备 TokenPlus API 密钥和模型

开始配置前，请按照 TokenPlus 快速入门完成注册、实名认证和充值。

进入项目空间的“API 密钥”页面，创建并复制完整密钥。

在模型广场选择支持 OpenAI Chat Completions 和工具调用的模型，并在项目空间开通对应模型。
从模型详情复制完整模型调用标识，保留平台提供的前缀，不要用展示名称代替。

第三步：在 CC Switch 中添加 TokenPlus 供应商

打开 CC Switch，在左侧栏选择 Codex；旧版界面可能位于顶部应用切换器。
点击“添加供应商”（加号），选择“自定义配置”。
填写以下参数：

设置项	填写内容
名称	`TokenPlus`
请求地址	`https://api.tokenplus.cn/v1`
API Key	TokenPlus 项目空间的完整密钥
默认模型	从 TokenPlus 复制的完整模型 ID
上游格式	`Chat Completions（需开启路由）`

上游格式位于高级选项中。不要沿用 Claude Code 的 Anthropic 配置，也不要在请求地址后追加 /chat/completions 或 /responses。

配置模型映射

在“模型映射”中新增一行：

设置项	填写内容
菜单显示名	便于识别的模型名称，例如 `TokenPlus 模型`
实际请求模型	从 TokenPlus 复制的完整模型 ID
上下文窗口	可选，按所选模型详情填写
思考等级	可选，仅填写模型实际支持的等级

默认模型与实际请求模型填写同一个完整模型 ID。需要使用多个模型时，可以增加映射行；不要仅凭名称推断模型支持的上下文长度或思考能力，也不要直接启用不符合模型能力的 1M 上下文选项。

确认配置后点击“添加”。密钥和包含密钥的配置文件不要提交到代码仓库或分享给他人。

第四步：开启本地路由并启用供应商

在 Codex 供应商列表中选择 TokenPlus，按提示选择“开始路由并使用它”。如果已经开启路由，在“路由”页点击 TokenPlus 卡片的“路由到此”。

确认 Codex 页面显示路由已生效，且 TokenPlus 是当前路由目标。

仅点击“路由”标签只是查看该页面，不会启用路由。必须执行“开始路由”等操作，让 Codex 请求经过 CC Switch。使用 Chat Completions 上游时，不要切回直连。

首次配置、修改模型映射或切换模型后，请退出已运行的 Codex CLI，再重新启动：

codex

如果使用 Codex 桌面版，请彻底退出后重新打开；使用编辑器插件时，请重新打开编辑器窗口。

第五步：验证并开始使用

在 Codex 中输入：

你好，请用一句话介绍你能帮我做什么，不要修改任何文件。

收到正常回复后，进入 TokenPlus 的调用日志，核对请求状态、实际模型和费用。普通对话成功后，再在测试项目中验证所需的工具调用和代码编辑任务。

如果配置了多个模型，可以在 Codex 会话中输入 /model，选择模型映射中填写的菜单显示名。修改映射后需要重启 Codex 才能刷新模型列表。

常见问题

返回 404 或提示接口不兼容

检查请求地址是否为 https://api.tokenplus.cn/v1，上游格式是否选择 Chat Completions，以及 Codex 本地路由是否真正启用。不要把“OpenAI 兼容”理解为所有接口都能直接互换；如果所选端点明确支持 Responses API，才考虑使用原生 Responses 直连方式。