跳至主要內容

Codex 配置

2026/8/11大约 2 分钟

Codex 配置

本文介绍如何手动把 Codex 接入 Token404。Token404 当前只提供 Codex 接入，不支持 Claude Code。

提示

Codex 客户端和 Codex CLI 共用同一套配置文件。初学者推荐使用 CC Switch 配置，由图形界面管理供应商和密钥；本页内容只给需要手动编辑配置文件的用户使用。

安装 Codex

如果尚未安装 Codex CLI：

npm i -g @openai/codex@latest

准备 API Key

从 Token404 管理面板 登录并创建 API Key。文档示例始终使用占位符 YOUR_API_KEY。

Token404 的 Codex 端点是：

https://sub.token404.cc/v1

Codex 配置文件路径

Codex 客户端和 Codex CLI 共用以下目录和文件：

系统配置目录主要文件
Windows%USERPROFILE%\\.codexconfig.toml、auth.json
Linux~/.codexconfig.toml、auth.json

如果使用 CC Switch 配置，就不需要手动编辑这些文件。只有在希望自行控制 provider、模型或高级参数时，才继续阅读下面的手动编辑步骤。

打开 Codex 配置目录

Windows CMD：

start "" "%USERPROFILE%\\.codex"

macOS：

open "$HOME/.codex"

Linux 或 WSL：

mkdir -p "$HOME/.codex"

如果目录不存在，请先创建它。

创建 config.toml

在 .codex 目录下创建或编辑 config.toml：

model_provider = "token404"
model = "gpt5.6-sol"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

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

本页示例使用推荐模型 gpt5.6-sol。如果要更换模型，将 model 和命令行参数中的值改成目标模型 ID 即可。

创建 auth.json

在 .codex 目录下创建或编辑 auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

将 YOUR_API_KEY 替换成管理面板创建的真实密钥，但不要把真实值提交到 Git。

启动 Codex

保存 config.toml 和 auth.json 后，重新打开终端并运行：

codex

如果可以正常对话，说明配置已经生效。

模型提醒

  • CLI 启动后，尽量不要在会话中频繁切换模型。
  • 切换模型后，建议退出当前会话再重新启动。
  • 修改配置文件后，需要重启 Codex 才会生效。

也可以通过命令行临时指定模型：

codex -m gpt5.6-sol -c model_reasoning_effort="xhigh"

常见问题

401 或鉴权失败

检查 auth.json 中的 OPENAI_API_KEY 是否完整，前后是否有多余空格，密钥是否仍然有效。

404 或接口不存在

检查 base_url 是否为：

https://sub.token404.cc/v1

修改后没有生效

先按 Ctrl + C 退出当前 Codex，再重新运行 codex。

不要泄露密钥

不要把 auth.json 上传到公开仓库，也不要在截图或日志中展示完整 API Key。

截图占位

  • Codex 安装完成后的终端：不要包含账号或 Key。
  • .codex 配置目录：只展示文件名和路径。
  • config.toml 与 auth.json：截图前将 Key 替换为 YOUR_API_KEY。
  • Codex 成功启动后的首屏：不要显示隐私数据。
Token404 文档
© 2026 Token404