ApiFluxAI | 使用 ApiFlux 配置 Codex CLI

安装 Codex CLI，设置 ApiFlux 自定义 Provider 与 API Key，并验证第一个请求。

本指南介绍如何将 Codex CLI 连接到 ApiFlux。配置完成后，Codex CLI 的模型请求会通过 ApiFlux 发送，用户可以在 ApiFlux 控制台统一查看用量和记录。

适用场景

适合希望在终端中使用 Codex CLI，并通过 ApiFlux 统一管理模型接入、余额、记录和模型切换的用户。

如果用户还没有安装终端或 Node.js，建议先阅读：

ApiFlux 使用前准备：安装终端和基础环境

准备工作

开始前，请准备：

一个 ApiFlux API Key
一个 ApiFlux 支持的模型 ID
ApiFlux Base URL：

https://apiflux.ai/v1

模型 ID 请从 ApiFlux Models 页面复制，不建议手动猜测。

1. 安装 Codex CLI

Windows

打开 PowerShell，执行：

irm https://chatgpt.com/codex/install.ps1 | iex

也可以使用 npm 安装：

npm install --global @openai/codex

如果使用 WSL，请在 WSL 终端中按 macOS / Linux 命令安装。

macOS / Linux

打开终端，执行：

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

也可以使用 npm 安装：

npm install --global @openai/codex

安装完成后，关闭终端并重新打开。

2. 确认 Codex CLI 已安装

在终端中执行：

codex --version

如果能看到版本号，说明 Codex CLI 已安装成功。

如果提示 command not found 或「不是内部或外部命令」，请重新打开终端；如果仍然失败，请重新执行安装命令。

3. 打开 Codex 配置文件

Codex CLI 的个人配置文件通常位于用户目录下。

macOS / Linux / WSL：

~/.codex/config.toml

可以执行：

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows PowerShell：

C:\Users\你的用户名\.codex\config.toml

可以执行：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
notepad "$env:USERPROFILE\.codex\config.toml"

如果用户习惯使用 VS Code，也可以用 VS Code 打开配置文件。

4. 新增 ApiFlux Provider

在 config.toml 中加入以下配置：

model = "YOUR_MODEL_ID"
model_provider = "apiflux"

[model_providers.apiflux]
name = "ApiFlux"
base_url = "https://apiflux.ai/v1"
env_key = "APIFLUX_API_KEY"

将 YOUR_MODEL_ID 替换为 ApiFlux Models 页面中显示的模型 ID。

示例：

model = "gpt-5.4-mini"
model_provider = "apiflux"

[model_providers.apiflux]
name = "ApiFlux"
base_url = "https://apiflux.ai/v1"
env_key = "APIFLUX_API_KEY"

[!NOTE] gpt-5.4-mini 仅作为示例模型。实际可用模型请以 ApiFlux Models 页面为准。

5. 配置 API Key 环境变量

建议通过环境变量提供 API Key，而不是把真实 Key 直接写入 config.toml。

Windows PowerShell

当前窗口暂时生效：

$env:APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

检查是否生效：

echo $env:APIFLUX_API_KEY

长期生效：

[Environment]::SetEnvironmentVariable("APIFLUX_API_KEY","YOUR_APIFLUX_API_KEY","User")

设置长期环境变量后，请关闭 PowerShell，再重新打开。

macOS / Linux

当前窗口暂时生效：

export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

检查是否生效：

echo $APIFLUX_API_KEY

macOS 默认通常是 zsh，长期生效可以写入 ~/.zshrc：

echo 'export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux 常见是 bash，长期生效可以写入 ~/.bashrc：

echo 'export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.bashrc
source ~/.bashrc

[!WARNING] 不要在公开截图、屏幕录屏或代码仓库中展示包含真实 API Key 的 Shell 配置文件。

6. 启动 Codex CLI 并发出测试请求

在终端中执行：

codex

启动 Codex CLI 后，可以输入一个简单问题：

用一句话介绍 ApiFlux 是什么

如果 Codex CLI 正常回复，请回到 ApiFlux 控制台，打开 Logs 确认是否出现请求记录。

常见问题

找不到 API Key

Windows PowerShell 检查：

echo $env:APIFLUX_API_KEY

macOS / Linux 检查：

echo $APIFLUX_API_KEY

如果没有输出，请重新配置环境变量。

401 或 Unauthorized

通常由以下原因导致：

API Key 填写错误
Key 已被删除或失效
复制 Key 时包含多余空格
当前终端没有加载环境变量

处理方式：

在 ApiFlux 控制台确认 Key 是否有效
重新配置 APIFLUX_API_KEY
关闭并重新打开终端后再次测试

模型不存在

请检查配置中的：

model = "YOUR_MODEL_ID"

模型 ID 必须来自 ApiFlux Models 页面。