FastAIToken

Appearance

OpenAI Codex ​

文档说明

一份配置，三处通用：在 Codex 桌面客户端、IDE 插件（VSCode/Cursor）和命令行 CLI 中，通过 FastAiToken 接入 gpt-5.5 / gpt-5.4 / gpt-5.4-mini 等模型。推荐写 config.toml + auth.json，不折腾环境变量。

概述 ​

OpenAI Codex 是 OpenAI 官方的 AI 编程助手，有三种用法：桌面客户端、IDE 插件（VSCode / Cursor 等）、以及命令行 CLI。三者在底层共用同一份配置（~/.codex/ 目录下的 config.toml 与 auth.json）。

通过 FastAiToken接入，本质只有一句话：

把 OpenAI 的入口换成 FastAiToken

FastAiToken是 OpenAI 兼容接口（透明代理）——配好一次，桌面客户端、插件、终端三处都能用。

桌面 / 插件 / CLI 共用 ~/.codex/，配一次全通 支持 gpt-5.5 / gpt-5.4 / gpt-5.4-mini，还可用国产模型 与 OpenAI 官方计费方式一致，价格更优 Windows / Mac / Linux 通用 先理解再上手：Codex 接第三方 API（如 FastAiToken）的关键，是在 ~/.codex/config.toml 里把"模型供应商"指向 FastAiToken，并在 ~/.codex/auth.json 里放你的 Key。桌面客户端和 IDE 插件都靠这份文件生效——所以本文以"写配置文件"为主，不推荐折腾环境变量。

一、准备工作：拿到 FastAiToken Key ​

访问 api.fastaitoken.com 注册或登录你的账号。 进入「令牌管理」页面（api.fastaitoken.com/token），点击「创建新令牌」。 复制生成的 API Key（格式：sk-***），妥善保存，后面要填进配置文件。

选择你的入口 ​

三种入口都可以，配置完全一样，按习惯挑一个即可：

独立 App，开箱即用，最推荐新手 VSCode / Cursor 扩展，边写代码边用 终端工作流，适合脚本与自动化

二、核心配置（推荐：写配置文件，不折腾环境变量） ​

下面三种配置方式，任选其一。推荐顺序：手动写文件（最稳）→ 可视化 → 环境变量。

方式一 · 手动写 auth.json + config.toml（推荐、最稳） ​

进入 Codex 的配置目录（没有就新建），在里面放/改两个文件：

配置目录：%USERPROFILE%\.codex\（即 C:\Users\你的用户名\.codex\）。

text
用文件资源管理器进入该目录。

配置目录：~/.codex/。

text
可在终端执行 `mkdir -p ~/.codex` 进入。

如果 config.toml 已经存在，不要整体覆盖！ 它里面可能已有你之前设置的模型偏好、审批策略、MCP 服务器等。正确做法是先备份、再合并（见下方「如何安全地改已有 config.toml」），只把 FastAiToken 需要的几行加进去。auth.json 同理，已有就改 OPENAI_API_KEY 的值即可。

1）auth.json——把 Key 放进去：

json
{
  "OPENAI_API_KEY": "sk-你的FASTAITOKEN密钥"
}

2）config.toml——把模型供应商指向 FastAiToken：

如果是全新文件，直接写入下面内容；如果已有文件，把"全局键"加到文件最顶部、把 [model_providers.fastaitoken] 整段加到文件最末尾（原因见下方提示）。

text
# === 全局（放在文件最顶部）===

model = "gpt-5.4"                 # 默认模型，可按需改成 gpt-5.5 等

model_provider = "fastaitoken"          # 使用下面定义的 fastaitoken 供应商

preferred_auth_method = "apikey"  # 用 API Key 认证（不要用 chatgpt 登录）

# === FastAiToken 供应商定义（放在文件最末尾）===

[model_providers.fastaitoken]
name = "fastaitoken"
base_url = "https://fastaitoken.com/v1"
env_key = "OPENAI_API_KEY"
requires_openai_auth = true
wire_api = "responses"

先把 sk-你的FASTAITOKEN密钥 换成你的真实 Key 再保存（就是上一步在 api.fastaitoken.com/token 复制的那串 sk- 开头的字符）。两个文件里的 Key 要一致。 第 1 步：先备份。 改任何配置前，把原文件复制一份，出问题随时能还原：

text
# Mac / Linux

cp ~/.codex/config.toml ~/.codex/config.toml.bak

# Windows PowerShell

Copy-Item $env:USERPROFILE\.codex\config.toml $env:USERPROFILE\.codex\config.toml.bak

第 2 步：合并，而不是覆盖。 只往已有文件里加 FastAiToken 需要的内容：把 model / model_provider / preferred_auth_method 三行放到文件最顶部，把 [model_providers.fastaitoken] 整段追加到文件最末尾。原有的其它配置原样保留。

TOML 顺序陷阱：在 TOML 里，所有"裸键值对"（如 model = "..."）必须出现在任何 [xxx] 表头之前，否则它会被算进上一个表里。所以全局键放最上面、[model_providers.fastaitoken] 放最下面，是最不容易出错的写法。

第 3 步：如果只是想临时试一下、又不想动主配置，可以用 profile：新建 ~/.codex/fastaitoken.config.toml 放上面这套内容，运行时 codex --profile fastaitoken 即可，互不影响（详见进阶配置）。

字段说明：

  • base_url：固定写 https://fastaitoken.com/v1，必须带 /v1，否则 404。
  • wire_api = "responses"：Codex 默认且首选的协议，FastAiToken 已支持。个别模型若报 404 / unknown endpoint，改成 "chat" 兜底（见进阶配置）。
  • 不要在本文件里写形如 C:\Users\xxx\.codex\... 的绝对路径，换台机器会断。

方式二 · cc-switch 可视化配置（图形界面，免手动编辑） ​

不想手动编辑文件，可以用 CC Switch——一个图形界面工具，点几下就能把 FastAiToken 的地址、Key、模型写进 Codex 配置，还能统一管理 Claude Code、Codex、Gemini CLI 等多款工具，一键切换。它也会自动处理上面的备份/合并，新手可优先考虑。

详见 CC Switch 可视化配置。配好后，Codex 的桌面客户端 / 插件 / CLI 都会自动读到这份配置。

方式三 · 环境变量（可选，较复杂，不推荐为主路径） ​

Codex CLI 也能读 OPENAI_BASE_URL / OPENAI_API_KEY 两个环境变量：

bash
export OPENAI_BASE_URL="https://fastaitoken.com/v1"
export OPENAI_API_KEY="sk-你的FASTAITOKEN密钥"

不推荐作为主路径：环境变量方式在新版 Codex 上经常不生效，且桌面客户端 / IDE 插件不读这两个变量——它们只认 config.toml + auth.json。环境变量仅适合 CLI 临时测试，长期使用请用方式一或方式二。

三、三处怎么用（优先桌面客户端） ​

配好上面的 ~/.codex/ 后，下面三种入口任选。改完配置都要重启对应程序（Codex 只在启动时读一次配置）。

1. Codex 桌面客户端（最推荐） ​

  1. 安装并打开 Codex 桌面客户端。
  2. 首次打开时选择认证方式：选 apikey（不要选 chatgpt 登录）。
  3. 在模型 / 供应商选择处，选中配置里的 fastaitoken 供应商与目标模型（如 gpt-5.4）。
  4. 重启客户端生效。
  5. 跑一个最小任务验证（见第四节）。

2. IDE 插件（VSCode / Cursor） ​

  1. 打开扩展市场（VSCode 按 Ctrl+Shift+X / Cmd+Shift+X），搜索 Codex — OpenAI's coding agent，点 Install。
  2. 安装后左侧边栏出现 Codex 图标，点击打开面板。
  3. 首次打开按提示三连：①认证方式选 apikey；②Key 来源选「配置文件 / 环境变量」；③是否启用 AGENTS.md（推荐开启）。
  4. 重启编辑器生效。
  5. 在 Codex 面板跑最小任务验证。

3. 命令行 CLI ​

先全局安装官方 CLI（需要 Node.js 18+）：

bash
npm install -g @openai/codex
codex --version

进入项目直接启动，或一句话执行任务：

text
cd /your/project
codex                                  # 交互模式

codex "帮我写一个 Python HTTP Server"   # 直接带任务

codex -q "修复当前项目的构建错误"        # 非交互/静默模式

Mac 用户若遇到全局安装权限问题，推荐用 nvm / fnm 管理 Node 版本，避免 sudo。

四、最小验证 ​

配好并重启后，在任一入口里输入一个最小任务：

text
请用中文在当前项目中创建一个 hello 接口，并附上调用示例。

CLI 用户也可以直接：

text
codex -q "hello"

能正常返回并给出可执行代码，就说明 FastAiToken 链路已经打通。

五、模型说明（FastAiToken 推荐） ​

在 config.toml 的 model 字段、或运行时切换即可选用以下模型：

模型特点适用场景
gpt-5.5最新主力模型复杂代码任务、工程分析、Agent 工作流
gpt-5.4稳定常用大多数代码开发、调试、重构（默认推荐）
gpt-5.4-mini便宜的 5.4 变体中小规模任务、批量处理、省钱

怎么选：日常 → gpt-5.4；重活 / Agent → gpt-5.5；省钱 → gpt-5.4-mini。 也支持国产 / 任意 OpenAI 兼容模型：FastAiToken 聚合了大量模型，凡是支持 OpenAI 兼容调用方式的都能在 Codex 里用——例如智谱 glm-5.2。只需把 config.toml 的 model 字段（或运行时 -m）换成对应模型 ID 即可。

切换模型的 4 种方式 ​

① 启动时临时指定（CLI）：

text
codex -m gpt-5.5
codex --model gpt-5.4 "帮我检查这个项目的代码结构"

② 非交互模式指定（CLI）：

text
codex -q -m gpt-5.4 "修复当前项目里的构建错误"

③ 会话内切换：在交互面板里输入 /model，按提示选择。

④ 配置默认模型（永久生效）：编辑 ~/.codex/config.toml，把 model 改成想要的，保存后重启：

text
model = "gpt-5.5"

六、进阶配置 ​

编辑 ~/.codex/instructions.md，定义编码风格、输出语言、项目规范，例如：

text
- 代码注释使用中文
- 遵循项目的 ESLint 配置
- 提供详细的解释说明
在项目里运行 `codex /init` 会生成 `AGENTS.md`，记录项目结构与规范。如需 Codex 默认用中文交流，加一行：
markdown
本项目请始终用中文跟用户交流。

    `wire_api = "responses"` 是 Codex 默认且首选的协议，多数模型直接可用。若某个模型返回 404 / unknown endpoint，把 `config.toml` 里对应供应商的 `wire_api` 改成 `"chat"`（走 `/chat/completions`）再试。

    在 `~/.codex/` 下新建 `.config.toml`（例如 `openai.config.toml` 放官方配置），运行时用 `codex --profile ` 切换。便于在 FastAiToken 与其它供应商之间快速切换。

```bash
codex -h          # 查看完整帮助

codex -m    # 指定模型

codex -q          # 非交互/静默模式

codex --full-auto # 自动执行（谨慎使用）

七、排障

  • auth.json 必须是合法 JSON，且 OPENAI_API_KEY 是你真实的 sk- 开头 Key。
  • config.toml 必须能被 TOML 正确解析（注意引号、缩进）。
  • 路径在 Windows %USERPROFILE%\.codex、Mac/Linux ~/.codex/。

去 FastAiToken 控制台确认 Key 没过期、账户有余额 / 额度。

最常见的连接错误 / 超时 / 404 都是因为漏了 /v1。正确：https://fastaitoken.com/v1。其次排查本地代理与 DNS。

Codex（CLI / 插件 / 桌面客户端）都只在启动时读一次配置。改完 auth.json / config.toml 一定要重启对应程序。

个别模型在 responses 协议下不兼容时，把对应供应商的 wire_api 改成 "chat" 再试。

八、常见问题

因为 FastAiToken完全兼容 OpenAI API 协议——Codex 看到的 https://fastaitoken.com/v1 和 https://api.openai.com/v1 在请求/响应格式上一致，仅替换 Base URL 即可。

这通常是正常现象：Codex 启动时会读取你当前项目的部分文件做初始化（目录结构、AGENTS.md、相关源码等），把它们作为上下文一起发给模型。所以即使你只说一句 hello，输入 tokens 也可能上万。

怎么减少？

  • 在空目录或一个很小的项目里测试最小任务，上下文自然就小。
  • 给明确的小任务并指定具体文件（如「只看 app.py，加一个 hello 接口」），缩小 Codex 主动扫描的范围。
  • 验证性的小任务用更便宜的模型（如 gpt-5.4-mini）来跑。

确认已正确安装：

bash
 install -g @openai/codex
codex --version

若仍报错，检查 npm bin -g 路径是否在 PATH 中。

  1. 确认用的是 FastAiToken Key（以 sk- 开头），不是 OpenAI 官方 Key。
  2. 确认 auth.json 里的 Key 没填错、没多空格。
  3. 改完配置重启对应程序。

最常见原因：Base URL 没带 /v1。正确写法：https://fastaitoken.com/v1。其次排查本地代理与 DNS。

  • OpenAI 系列：✅ 完整支持（推荐 gpt-5.5 / gpt-5.4 / gpt-5.4-mini）。
  • 国产 / 其它 OpenAI 兼容模型：FastAiToken 支持，如 glm-5.2，改 model 字段即可。
  • 注意：Codex 偏向 OpenAI 协议，非 OpenAI 模型在工具调用 / function call 上可能有差异。想用 Claude / Gemini 做编程，建议用对应原生工具（如 Claude Code）。

桌面客户端和 IDE 插件只读 ~/.codex/config.toml + auth.json，不读环境变量。请确认这两个文件配置正确，认证方式选了 apikey，并重启程序。

  • CLI / 客户端：适合开发期效率工具。
  • 生产：建议直接调用 API（更可控、可监控、可灰度）。

卸载 CLI：

bash
 uninstall -g @openai/codex

停用 FastAiToken 配置：删除或还原 ~/.codex/config.toml 与 auth.json 即可（卸载桌面客户端 / 插件则在各自界面操作）。

九、总结这类接入本质就一句话： 把 OpenAI 的入口换成 FastAiToken 核心就是在 ~/.codex/ 配好一次：auth.json 放 Key，config.toml 把 base_url 指向 https://fastaitoken.com/v1。配好后，桌面客户端、IDE 插件、命令行三处都能用。剩下都是锦上添花——选模型、写提示词、自定义 instructions.md / AGENTS.md。 相关资源

管理 API 密钥与查看用量

图形界面一键配置 Codex / Claude Code

用 Claude 系列做命令行编程

所有可用模型与定价

text