跳至主要內容

手动配置 Codex

2026/8/11大约 4 分钟

手动配置 Codex

这页只给需要手动管理本地配置的用户。第一次接入 Token404 时，优先使用 快速开始 中的 Codex 桌面端 + CC Switch 路线，那里不需要编辑任何文件。

先判断是否真的需要本页

以下情况才需要手动配置：你在 Linux 或 WSL 终端中使用 Codex CLI、无法使用 CC Switch，或者需要自行维护多个服务配置。已经通过 CC Switch 配置成功的用户不要继续覆盖文件。

先理解 Codex 桌面端和 Codex CLI

在 Windows 原生环境中，Codex 桌面端和 Codex CLI 会读取同一个 Codex 主目录，因此改一次配置就会同时影响两边。它们不是两套独立的 Token404 配置。

普通使用选择桌面端就够了。CLI 适合希望在终端里工作、需要脚本化，或者在 Linux 中使用 Codex 的用户。

使用环境Codex 配置目录这意味着什么
Windows 原生桌面端或 CLI%USERPROFILE%\\.codex桌面端和 CLI 共用同一套 config.toml 与密钥配置，不要分别设置两次。
Linux CLI~/.codexLinux 有自己的本地配置目录。
WSL CLI~/.codex它不会自动读取 Windows 的 %USERPROFILE%\\.codex，需要单独配置或显式共享。

这一点与 OpenAI 官方 Windows 文档 的说明一致：Windows 应用和 Windows 原生 Codex 使用相同的 Codex 主目录，而 WSL 的 CLI 默认使用 Linux 主目录。

配置前准备

  1. 在 Token404 管理面板 创建 API Key。下面的 YOUR_API_KEY 只是占位符，写入自己电脑时再替换为真实值。
  2. 退出正在运行的 Codex 桌面端和终端中的 codex 会话，避免它们继续使用旧配置。
  3. 如果 .codex 目录里已有 config.toml 或 auth.json，先复制一份备份。不要直接覆盖你原来的 provider、MCP 或其他个性化设置。

你真正需要配置的只有两件事：config.toml 告诉 Codex“通过哪个服务调用模型”，auth.json 保存“使用哪一把 API Key”。

Windows：手动接入桌面端和 CLI

第 1 步：打开配置目录

按 Win + R，粘贴下面的路径后按回车：

%USERPROFILE%\\.codex

如果目录还不存在，创建名为 .codex 的文件夹。之后在这里创建或编辑下面两个文件。

第 2 步：配置 Token404 服务

在 .codex 目录中创建或编辑 config.toml。如果文件已有其他内容，只增加 Token404 相关段落，并保留你已有的设置。

model_provider = "token404"
model = "gpt-5.6-sol"

[model_providers.token404]
name = "Token404"
base_url = "https://sub.token404.cc/v1"
wire_api = "responses"
requires_openai_auth = true

这段内容会把 Token404 设为当前使用的服务，并将推荐模型设为 gpt-5.6-sol。不需要逐项修改其他高级参数。

第 3 步：保存 API Key

在同一目录中创建或编辑 auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

仅在你自己的电脑上把 YOUR_API_KEY 替换为 Token404 主站创建的真实密钥。auth.json 是私密文件，不要上传到 GitHub，也不要贴进聊天记录、截图或日志。

第 4 步：重启并验证

重新打开 Codex 桌面端，选择一个项目文件夹并发送一条简单任务。若你也安装了 CLI，打开终端运行：

codex

两边都会读取刚才相同的配置。能收到正常回复就说明接入完成。

Linux 或 WSL：使用 CLI

Linux 没有 Windows 桌面端的共享目录概念，通常直接使用 Codex CLI。若尚未安装 CLI：

npm i -g @openai/codex@latest

第 1 步：创建配置目录

mkdir -p "$HOME/.codex"

第 2 步：写入服务和密钥

在 ~/.codex/config.toml 写入与 Windows 步骤 2 相同的 config.toml 内容；在 ~/.codex/auth.json 写入与 Windows 步骤 3 相同的 auth.json 内容。

第 3 步：启动并验证

codex

如果你同时使用 Windows 桌面端和 WSL CLI，它们默认是两套目录。希望 WSL 使用 Windows 已有配置时，可以在 WSL 中设置 CODEX_HOME 指向 Windows 的 .codex 目录；否则请把两边分别维护，不要误以为改了一边就会自动同步到另一边。

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

完成后仍未生效

完全退出 Codex 桌面端和 CLI 后再重新打开。若配置来自 CC Switch，请回到 CC Switch 确认 Token404 供应商显示为“使用中”，不要同时手动覆盖它管理的文件。

如果仍有 401、404、模型不存在、超时或余额不足提示，请阅读 常见问题。对于充值、退款和账户问题，请按页面提供的支持方式联系管理员。

Token404 文档
© 2026 Token404