在 Codex CLI 中使用 Token搭子

简介

Codex CLI 是 OpenAI 推出的开源终端编程智能体，可以在命令行中直接读写文件、运行命令、修复 Bug 并完成完整的编码任务。通过接入 Token搭子，您可以在 Codex CLI 中自由使用包括 GPT、Claude 在内的多种模型，并享受更灵活、更优惠的计费方式。

获取 API Key

如果还没有 Token搭子账户，请先在控制台注册。

配置方式

一键配置
自主配置

macOS / Linux - Codex

请在终端中运行以下脚本。将 YOUR_API_KEY 替换为您的 API Key。

curl -fsSL https://tokendazi.com/setup-codex.sh | bash -s -- --url https://console.tokendazi.com/v1 --key YOUR_API_KEY

脚本会验证 API Key，备份并合并现有配置，并在需要时安装 Node.js 和 Codex CLI。脚本执行成功后，请重新打开终端。

Windows - Codex

请在 PowerShell 中运行以下命令。将 YOUR_API_KEY 替换为您的 API Key。

& { $url='https://console.tokendazi.com/v1'; $key='YOUR_API_KEY'; iwr -useb https://tokendazi.com/setup-codex.ps1 | iex }

脚本会验证 API Key，备份并合并现有配置，并在需要时安装 Node.js 和 Codex CLI。脚本执行成功后，请重新打开 PowerShell。

如果 PowerShell 阻止脚本运行，请执行以下命令，然后重新打开 PowerShell：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

自主配置

第一步：安装 Codex CLI

选择以下任一方式安装：

npm（推荐）
Homebrew (macOS)

使用 npm 全局安装，适用于所有操作系统：

npm install -g @openai/codex

如果遇到权限问题，请在命令前加 sudo（macOS / Linux）。

macOS 用户也可以通过 Homebrew 安装：

brew install codex

验证安装

安装完成后，运行以下命令确认安装成功：

codex --version

如果输出版本号，说明安装成功。

第二步：配置 Token搭子 API

Codex CLI 通过 ~/.codex/ 目录下的配置文件管理模型供应商。我们只需新增一个指向 Token搭子的自定义供应商即可。

2.1 找到配置目录

macOS / Linux： ~/.codex/
Windows： C:\Users\<用户名>\.codex\

如果目录不存在，先在终端运行一次 codex 再按 Ctrl + C 退出，会自动生成该目录。

2.2 配置 API 密钥

在配置目录下创建或编辑 auth.json 文件，填入您的 Token搭子密钥：

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

字段	说明
`OPENAI_API_KEY`	您的 Token搭子 API 密钥（以 `sk-` 开头）

2.3 配置模型供应商

在配置目录下创建或编辑 config.toml 文件，添加 Token搭子供应商：

# 默认使用的模型
model = "gpt-5.4"
# 默认使用的供应商，对应下方 [model_providers.tokendazi]
model_provider = "tokendazi"

# Token搭子 供应商配置
[model_providers.tokendazi]
name = "Token搭子"
base_url = "https://console.tokendazi.com/v1"
wire_api = "responses"
requires_openai_auth = true

字段	说明
`model`	默认使用的模型 ID，可从下方模型列表中选择
`model_provider`	默认供应商，需与 `[model_providers.xxx]` 中的 ID 一致
`name`	供应商显示名称，可自定义
`base_url`	Token搭子的 OpenAI 兼容地址，固定为 `https://console.tokendazi.com/v1`
`wire_api`	通信协议，新版 Codex 需使用 `responses`（Responses API）
`requires_openai_auth`	设为 `true`，使用 `auth.json` 中的密钥进行认证

保存两个文件后，重新启动 Codex CLI 即可生效。

请确保 auth.json 是合法的 JSON 格式、config.toml 是合法的 TOML 格式，不要使用中文引号，否则配置不会生效。

第三步：开始使用

验证配置

在任意项目目录下运行以下命令，确认配置是否正确：

codex "用一句话介绍你自己"

如果收到 AI 回复，说明配置成功。如果出现登录界面或 401、403 等错误，请参考下方常见问题排查。

交互模式

直接运行 codex 进入交互式界面，适合处理完整的编码任务：

codex

进入后即可用自然语言描述需求，例如：

帮我创建一个 Express.js 服务器，包含一个返回 JSON 的健康检查接口

Codex 会自动分析项目、生成代码、运行命令，并在执行敏感操作前请求您确认。

审批模式

首次运行时，Codex 会让您选择操作审批级别：

模式	说明
只读	仅允许读取文件，任何修改和命令都需确认
自动	可在工作目录内自主读写文件、运行命令（推荐）
完全访问	无需确认即可执行任何操作，请谨慎使用

建议从自动模式开始使用，在交互界面中输入 /approvals 可随时调整。

切换模型

在交互界面中输入 /model 命令即可快速切换模型，或修改 config.toml 中的 model 字段后重启。

支持的模型

在 Codex CLI 中，推荐使用以下 GPT-5 系列模型：

模型 ID	特点	推荐场景
`gpt-5.5`	最新旗舰，代码能力最强	复杂工程任务
`gpt-5.4`	平台默认模型，能力强劲	Codex 首选、复杂编码和架构设计
`gpt-5.4-mini`	轻量版，速度快、性价比高	日常编码、快速迭代
`gpt-5.3-codex`	专为 Codex 优化的编码模型	智能体式编码任务
`gpt-5.2`	稳定均衡	常规编码任务

模型选择建议： Token搭子默认使用 gpt-5.4。您也可以选择 gpt-5.5，或使用专为智能体编码场景优化的 gpt-5.3-codex。

常用命令

以下是 Codex CLI 中常用的命令和快捷操作：

命令	说明
`codex`	进入交互式界面
`codex "任务描述"`	带初始指令启动
`codex exec "任务描述"`	非交互模式，直接执行后退出
`codex --model gpt-5.4`	指定模型启动
`codex --version`	查看版本号
`/model`	在交互界面中切换模型
`/approvals`	在交互界面中调整审批模式
`Ctrl + C`	退出交互界面

常见问题

Q1: 启动后弹出 ChatGPT 登录界面？

如果启动后显示 “Sign in with ChatGPT” 等登录提示，说明配置未生效。 排查步骤：

确认 config.toml 和 auth.json 都位于 ~/.codex/ 目录下
检查 config.toml 中的 model_provider 是否为 tokendazi
检查 auth.json 的 JSON 格式是否正确，密钥是否完整填入

Q2: 出现 401 / 403 错误？

错误码	含义	解决方案
`401 Unauthorized`	API 密钥缺失或无效	检查 `auth.json` 中的密钥是否正确，是否以 `sk-` 开头
`403 Forbidden`	权限不足或密钥过期	前往控制台确认密钥状态

同时确保 base_url 设置为 https://console.tokendazi.com/v1，而非 OpenAI 官方地址。

Q3: 提示连接失败？

检查网络连接是否正常
确认 config.toml 中的 base_url 配置正确
如果使用了代理，确保代理设置允许访问 console.tokendazi.com

Q4: 提示 `wire_api = "chat"` 不再支持？

新版 Codex CLI（0.84.0 及以后）已移除 chat 协议，请将 config.toml 中的 wire_api 改为 responses：

wire_api = "responses"

Token搭子已提供 Responses API，修改后重新启动 Codex 即可。

Q5: 工具调用或运行报错？

确认 config.toml 中的 wire_api 设置为 responses。如果遇到兼容性问题，建议优先使用默认模型 gpt-5.4，或切换到 gpt-5.3-codex。

Q6: 想使用环境变量而非 auth.json？

也可以通过环境变量配置密钥。将 config.toml 中供应商配置改为：

[model_providers.tokendazi]
name = "Token搭子"
base_url = "https://console.tokendazi.com/v1"
wire_api = "responses"
env_key = "TOKEN_DAZI_API_KEY"

然后设置环境变量 TOKEN_DAZI_API_KEY 为您的 Token搭子密钥即可，此时无需 auth.json。

Q7: 如何切换模型？

两种方式：

交互界面中：输入 /model 命令即可切换
修改配置：更改 config.toml 中的 model 字段，重启 Codex CLI

Q8: 如何查看使用情况和费用？

支持与帮助

技术支持：support@tokendazi.com

开始使用 Token搭子

立即注册 Token搭子，获取您的 API 密钥，在 Codex CLI 中体验多模型编程助手！

开发工具

聊天应用

应用平台

开始使用

在 Codex CLI 中使用 Token搭子

简介

获取 API Key

配置方式

macOS / Linux - Codex

Windows - Codex

查看自主配置步骤

自主配置

第一步：安装 Codex CLI

验证安装

第二步：配置 Token搭子 API

2.1 找到配置目录

2.2 配置 API 密钥

2.3 配置模型供应商

第三步：开始使用

验证配置

交互模式

审批模式

切换模型

支持的模型

常用命令

常见问题

Q1: 启动后弹出 ChatGPT 登录界面？

Q2: 出现 401 / 403 错误？

Q3: 提示连接失败？

Q4: 提示 `wire_api = "chat"` 不再支持？

Q5: 工具调用或运行报错？

Q6: 想使用环境变量而非 auth.json？

Q7: 如何切换模型？

Q8: 如何查看使用情况和费用？

支持与帮助

开始使用 Token搭子

​简介

​获取 API Key

​配置方式

​macOS / Linux - Codex

​Windows - Codex

查看自主配置步骤

​自主配置

​第一步：安装 Codex CLI

​验证安装

​第二步：配置 Token搭子 API

​2.1 找到配置目录

​2.2 配置 API 密钥

​2.3 配置模型供应商

​第三步：开始使用

​验证配置

​交互模式

​审批模式

​切换模型

​支持的模型

​常用命令

​常见问题

​Q1: 启动后弹出 ChatGPT 登录界面？

​Q2: 出现 401 / 403 错误？

​Q3: 提示连接失败？

​Q4: 提示 wire_api = "chat" 不再支持？

​Q5: 工具调用或运行报错？

​Q6: 想使用环境变量而非 auth.json？

​Q7: 如何切换模型？

​Q8: 如何查看使用情况和费用？

​支持与帮助

开始使用 Token搭子

简介

获取 API Key

配置方式

macOS / Linux - Codex

Windows - Codex

自主配置

第一步：安装 Codex CLI

验证安装

第二步：配置 Token搭子 API

2.1 找到配置目录

2.2 配置 API 密钥

2.3 配置模型供应商

第三步：开始使用

验证配置

交互模式

审批模式

切换模型

支持的模型

常用命令

常见问题

Q1: 启动后弹出 ChatGPT 登录界面？

Q2: 出现 401 / 403 错误？

Q3: 提示连接失败？

Q4: 提示 `wire_api = "chat"` 不再支持？

Q5: 工具调用或运行报错？

Q6: 想使用环境变量而非 auth.json？

Q7: 如何切换模型？

Q8: 如何查看使用情况和费用？

支持与帮助