Codex

Codex 是 OpenAI 官方的命令行编程助手，只支持 OpenAI Responses 协议。通过在配置文件里添加一个自定义「模型提供方」接入本站。

• 协议：OpenAI Responses（/v1/responses）
• 地址：https://tokenfunc.com/v1（带 /v1）
• 模型：GPT 系列，例如 gpt-5

方式一：一键配置脚本（推荐）

在终端运行下面的命令，按提示粘贴密钥、选择默认模型即可。脚本会：

• 用模型列表接口校验密钥（不扣费）
• 没装 Codex 时，用官方方式自动安装
• 在 ~/.codex/config.toml 写入本站的模型提供方：保留文件里已有的其他设置，原文件自动备份
• 把密钥保存为环境变量 TOKENFUNC_API_KEY：macOS / Linux 写进 shell 启动文件，Windows 保存为用户环境变量

curl -fsSL https://tokenfunc.com/install/codex.sh | bash

# 在 PowerShell 中运行（不是命令提示符 cmd）
irm https://tokenfunc.com/install/codex.ps1 | iex

配置完成后新开一个终端（密钥环境变量在新终端才生效），然后跳到下面的「启动并验证」一步。

方式二：CC Switch 一键导入

装好 CC Switch 后点下面的按钮，在弹窗里确认应用为 Codex、选好模型即可。

导入后在 CC Switch 里启用这个配置，然后跳到下面的「验证」一步。

方式三：手动配置

1. 安装 Codex

   macOS / Linux

   curl -fsSL https://chatgpt.com/codex/install.sh | sh

   Windows

   powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

   npm

   npm install -g @openai/codex

2. 写入配置文件

   把下面的内容写进 Codex 的配置文件。文件已有内容时注意：model 和 model_provider 两行必须放在文件最前面，在任何 [...] 小节之前，否则会被当成上一个小节的字段而不生效。

   macOS / Linux

   ~/.codex/config.toml

   model = "gpt-5"
   model_provider = "tokenfunc"
   
   [model_providers.tokenfunc]
   name = "tokenfunc"
   base_url = "https://tokenfunc.com/v1"
   env_key = "TOKENFUNC_API_KEY"
   wire_api = "responses"
   requires_openai_auth = false

   Windows

   %USERPROFILE%.codex\config.toml

   model = "gpt-5"
   model_provider = "tokenfunc"
   
   [model_providers.tokenfunc]
   name = "tokenfunc"
   base_url = "https://tokenfunc.com/v1"
   env_key = "TOKENFUNC_API_KEY"
   wire_api = "responses"
   requires_openai_auth = false

   • env_key 表示密钥从名为 TOKENFUNC_API_KEY 的环境变量读取，下一步设置它。
   • 提供方的名字（tokenfunc）可以改，但不能用 openai、ollama、lmstudio，这几个是保留名。

3. 设置密钥环境变量

   Codex 官方不建议把密钥直接写进配置文件，而是放在环境变量里。

   macOS / Linux

   # 写入 shell 配置，新开终端也生效（bash 用户把 ~/.zshrc 换成 ~/.bashrc）
   echo 'export TOKENFUNC_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
   source ~/.zshrc

   Windows

   # 永久保存，设置后需要重新打开终端
   setx TOKENFUNC_API_KEY "sk-xxxxxxxxxxxxxxxx"

4. 启动并验证

   新开一个终端，运行 codex，输入 /status，确认 provider 是 tokenfunc、model 是你设置的模型。再发一句「Reply with exactly: ok」，收到回复即接入成功。

   截图待补充Codex 中 /status 的输出，显示 provider 为 tokenfunc 与当前模型tools/codex-status.png

选择和切换模型

• 默认模型由配置文件里的 model 决定。
• 临时换模型：codex -m gpt-5，或在会话里输入 /model。
• Codex 依赖 Responses 接口和工具调用。部分非 OpenAI 模型可能不完整支持，出现异常时先换回 GPT 系列模型排查。

常见问题

其他报错见 常见问题与排错。