通过 Flatkey 使用 OpenAI Codex CLI 终端智能体

OpenAI Codex CLI 是一款在终端中运行的 AI 编程助手。设置两个环境变量，即可将 Codex CLI 的全部请求路由到 Flatkey，并按 Flatkey 的优惠价格计费，GPT 模型用量通常可节省 40% 以上。

前置条件

运行 Codex CLI 前，设置以下环境变量：

export OPENAI_BASE_URL="https://router.flatkey.ai/v1"
export OPENAI_API_KEY="sk-fk-your-flatkey-key"

也可以将它们添加到 shell 配置文件（~/.bashrc、~/.zshrc），使设置永久生效：

~/.zshrc

export OPENAI_BASE_URL="https://router.flatkey.ai/v1"
export OPENAI_API_KEY="sk-fk-your-flatkey-key"

CC Switch 是面向编程助手的第三方桌面配置管理器，也可以从其官方 GitHub 仓库下载。

如果你的 CC Switch 版本没有 Flatkey 预设，请使用自定义供应商。Flatkey 直接支持 Responses 路由，因此无需为此配置启用 CC Switch 本地路由。

设置环境变量后，照常使用 Codex：

codex "Refactor this function to use async/await"

或进入交互模式：

codex

所有请求都会通过 Flatkey 路由，并按 Flatkey 优惠价格从预付余额中扣费。

Codex CLI 默认使用 GPT 模型。你可以通过 --model 参数指定其他模型：

codex --model gpt-4o "Write unit tests for this module"
codex --model gpt-4o-mini "Add docstrings to this file"  # cheaper for simple tasks

模型目录中任何可用的 GPT 模型都能通过 Flatkey 与 Codex CLI 配合使用。

运行 Codex 命令后，查看用量日志。你应当能看到包含模型和 token 数量的请求记录。如果没有记录，请确认当前供应商以及当前 shell 会话中的 OPENAI_BASE_URL。

如果持续使用 Codex，可选择 $200 充值档位获得更优惠的实际费率。叠加奖励后，费用最低可至 GPT 官方价格的 5 折。

问题	解决方法
`Authentication error`	确认 `OPENAI_API_KEY` 已设为以 `sk-fk-` 开头的 Flatkey 密钥
`Model not found`	在模型目录中核对模型 ID
`Insufficient balance`	前往 console.flatkey.ai充值余额
控制台中没有请求记录	确认当前 shell 中已设置 `OPENAI_BASE_URL`