Codex 客户端接入

手动安装

1. 下载 Codex Desktop

请先在 FlyHub 控制台创建 API Key，后续步骤中会将 <FLYHUB_API_KEY> 替换为你的密钥。

若本机尚未安装 Codex Desktop，请从 OpenAI 官网下载对应系统版本并完成安装。Linux 用户目前建议使用 Codex CLI，参见 Codex 命令行接入页。

已安装 Codex Desktop 可跳过本节，直接进入配置 config.toml。

2. 配置 config.toml

Codex Desktop 读取 ~/.codex/config.toml。将 FlyHub 注册为 model provider，默认模型为 gpt-5.6-sol，使用 OpenAI Responses API 协议；凭据直接内联在 provider 里（experimental_bearer_token），不需要设置环境变量。

mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "flyhub"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.flyhub]
name = "FlyHub"
base_url = "https://api.flyhub.com.cn/v1"
experimental_bearer_token = "<FLYHUB_API_KEY>"
wire_api = "responses"
EOF

手动写入会整份覆盖 config.toml。已有其他 provider 时请用上面的「推荐安装」（CLI 会保留），或先备份再改。

写入完成后，配置文件内容应类似：

toml

model_provider = "flyhub"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.flyhub]
name = "FlyHub"
base_url = "https://api.flyhub.com.cn/v1"
experimental_bearer_token = "<FLYHUB_API_KEY>"
wire_api = "responses"

3. 填入 API Key

把控制台复制的 FlyHub Key 写进 config.toml 的 experimental_bearer_token（替换掉 <FLYHUB_API_KEY> 占位符）。Key 直接保存在配置里，不需要设置 OPENAI_API_KEY 等环境变量：

macOS：

bash

printf '粘贴 FlyHub Key 后回车: '; read -r KEY && sed -i '' "s|<FLYHUB_API_KEY>|$KEY|" ~/.codex/config.toml

Linux：

bash

printf '粘贴 FlyHub Key 后回车: '; read -r KEY && sed -i "s|<FLYHUB_API_KEY>|$KEY|" ~/.codex/config.toml

Windows（PowerShell）：

powershell

$key = Read-Host "粘贴 FlyHub Key"; if (-not $key) { throw "没有输入 Key" }; (Get-Content "$HOME\.codex\config.toml" -Raw) -replace [regex]::Escape("<FLYHUB_API_KEY>"), $key | Set-Content "$HOME\.codex\config.toml" -NoNewline

config.toml 里是明文 Key，请保持文件仅当前用户可读（macOS/Linux 可执行 chmod 600 ~/.codex/config.toml）。改完 Key 后重启 Codex Desktop 生效。

4. 启动 Codex Desktop

打开 Codex Desktop。若应用已在运行，请先完全退出再重新启动，以确保加载最新 config.toml。

连接成功后，可在 FlyHub 控制台查看各次请求的用量与计费明细。

5. 切换模型

修改 ~/.codex/config.toml 中的 model 字段即可切换默认模型，例如 gpt-5.6-sol、deepseek-v4-pro：

toml

model_provider = "flyhub"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

可用模型 ID 与下表一致，也可以调用 GET /v1/models 核对。

常用对话模型（完整清单以 GET /v1/catalog/models 为准；生图/生视频/音频/向量走各自模型详情页）：

OpenAI

gpt-5.6-lunagpt-5.6-solgpt-5.6-terra

Anthropic

claude-opus-5claude-sonnet-5claude-fable-5-1claude-haiku-4-5

Google

gemini-3.1-progemini-3.7-flash

Kimi

kimi-k3

智谱

glm-5.3glm-5.3-flash

DeepSeek

deepseek-v4-prodeepseek-v4-flash

厂商	模型 ID
OpenAI	`gpt-5.6-lunagpt-5.6-solgpt-5.6-terra`
Anthropic	`claude-opus-5claude-sonnet-5claude-fable-5-1claude-haiku-4-5`
Google	`gemini-3.1-progemini-3.7-flash`
Kimi	`kimi-k3`
智谱	`glm-5.3glm-5.3-flash`
DeepSeek	`deepseek-v4-prodeepseek-v4-flash`

6. 故障排查

401 / invalid_bearer_token：确认 config.toml 的 experimental_bearer_token 是完整 Key（sk- 开头、无空格、未被删除）。改完 Key 后需完全退出 Codex Desktop 再启动。

Missing environment variable: `OPENAI_API_KEY`：说明 config 里还留着旧的 env_key 写法（旧版文档/旧版一键安装写入的）。Codex 只要看到 env_key 就强制要求该环境变量存在，而 Windows 用户级环境变量不会自动刷新到已打开的终端 / Codex Desktop。删掉 env_key 那一行，改成 experimental_bearer_token = "<FLYHUB_API_KEY>"（当前文档与一键安装都已这样写），就不用再设环境变量。

模型不可用：检查 config.toml 中 model 拼写，并对照 GET /v1/models 返回结果。

配置未生效：确认 ~/.codex/config.toml 路径正确，且 model_provider 设为 flyhub。

准备好了？登录控制台 · 充值 · 创建 API Key

获取 API Key 查看定价

接入 FlyHub · Codex 桌面客户端