在 Codex 中使用 ZhiFlo

这是一条手工配置路径，适合你想长期保留一套独立的 ZhiFlo 配置，又不想覆盖 Codex 默认设置的时候。

如果你只是第一次接入，先走 CC Switch 快速路径，会更省事。

准备好三个值

• 已按照 Codex 官方说明安装 Codex 0.134.0 或更高版本。运行 codex --version 检查；版本较低时先更新 Codex。
• 已创建一枚当前设备专用的 Token。
• 已从账户列表复制完整的 模型 ID。

Windows 用户可在开始菜单打开 PowerShell；macOS 或 Linux 用户打开 Terminal。下面的 ~ 表示当前用户主目录，Windows 中对应 %USERPROFILE%。

1. 创建独立 profile 文件

1. 在用户主目录下打开 .codex 文件夹；不存在时先创建它。
2. 新建 zhiflo.config.toml，完整路径为 ~/.codex/zhiflo.config.toml。
3. 写入下面的内容，把 <MODEL_FROM_ZHIFLO> 替换为账户显示的完整模型 ID。

model_provider = "zhiflo"
model = "<MODEL_FROM_ZHIFLO>"

[model_providers.zhiflo]
name = "ZhiFlo"
base_url = "https://api.zhiflo.com/v1"
env_key = "ZHIFLO_API_TOKEN"
wire_api = "responses"

保存文件。不要把 Token 写进这个 TOML 文件，也不要把用户级提供方配置复制到项目仓库。

2. 在当前终端载入 Token

Token 只进入当前终端环境，关闭窗口后会消失。

macOS、Linux 或 Bash

运行命令后粘贴 Token 并按 Enter。输入不会显示在屏幕上。

read -s ZHIFLO_API_TOKEN
export ZHIFLO_API_TOKEN

PowerShell

运行以下命令，在提示出现后粘贴 Token：

$secureToken = Read-Host "Paste your ZhiFlo Token" -AsSecureString
$env:ZHIFLO_API_TOKEN = [System.Net.NetworkCredential]::new("", $secureToken).Password

不要在共享终端记录、命令历史或截图中展示 Token。

3. 启动 ZhiFlo profile

在设置环境变量的同一个终端运行：

codex --profile zhiflo

然后发送：

不要修改任何文件，只回答 OK。

Codex 返回 OK，说明这条手工路径已经配置完成：profile 文件被读取、Token 已载入、模型 ID 正确，而且请求确实通过 ZhiFlo 发出。

没有得到回复

• 提示找不到 profile 或配置：确认文件名是 zhiflo.config.toml，位置是当前 CODEX_HOME；若未设置 CODEX_HOME，默认是 ~/.codex。仍不识别时更新 Codex 后再启动，不要改用旧的 [profiles.zhiflo] 写法。
• 提示缺少 ZHIFLO_API_TOKEN：在当前终端重新执行载入 Token 的两条命令，再从同一窗口启动 Codex。
• 返回 404：核对 base_url 为 https://api.zhiflo.com/v1，wire_api 为 responses。
• 提示模型不可用：重新复制账户当前可用模型的完整 ID，更新 model 后重开 Codex。

下一步：查看 Token 用量与额度的区别。