推荐安装
先安装 FlyHub CLI，再用它写入配置文件与环境变量（含 ~/.codex/config.toml 与 OPENAI_API_KEY）。将 Key 换成控制台里的密钥即可。
# 安装 FlyHub CLI
curl -fsSL https://flyhub.cn/install.sh | bash
export PATH="$HOME/.flyhub/bin:$PATH"
# 一键配置（将 Key 替换为控制台密钥）
flyhub setup codex --key <FLYHUB_API_KEY>若已安装过 CLI，可只执行 flyhub setup codex --key <FLYHUB_API_KEY>。已设置 FLYHUB_API_KEY 时可省略 --key。更多工具：flyhub setup list
手动安装
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 协议。
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.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF写入完成后，配置文件内容应类似：
model_provider = "flyhub"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
[model_providers.flyhub]
name = "FlyHub"
base_url = "https://api.flyhub.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"3. 设置 API Key
config.toml 中 env_key 指向 OPENAI_API_KEY 环境变量。请将 <FLYHUB_API_KEY> 替换为控制台复制的 FlyHub Key：
macOS（zsh）：
echo 'export OPENAI_API_KEY="<FLYHUB_API_KEY>"' >> ~/.zshrc
source ~/.zshrcLinux（bash）：
echo 'export OPENAI_API_KEY="<FLYHUB_API_KEY>"' >> ~/.bashrc
source ~/.bashrcWindows：
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<FLYHUB_API_KEY>", "User")Windows 用户：设置环境变量后，需完全退出 Codex Desktop 再重新打开，客户端才会读取新 Key。
4. 启动 Codex Desktop
打开 Codex Desktop。若应用已在运行，请先完全退出再重新启动，以确保加载最新配置与环境变量。
连接成功后，可在 FlyHub 控制台查看各次请求的用量与计费明细。
5. 切换模型
修改 ~/.codex/config.toml 中的 model 字段即可切换默认模型，例如 deepseek-v4、gpt-5.6-sol 等：
model_provider = "flyhub"
model = "deepseek-v4"
model_reasoning_effort = "high"可用模型 ID 请调用 GET /v1/models 获取实时列表，或在能力广场查看已上架模型。
6. 故障排查
401 / invalid_bearer_token：确认 OPENAI_API_KEY 已正确写入环境变量，Key 完整且无多余空格。Windows 需重启 Codex Desktop。
模型不可用：检查 config.toml 中 model 拼写，并对照 GET /v1/models 返回结果。
配置未生效：确认 ~/.codex/config.toml 路径正确，且 model_provider 设为 flyhub。
准备好了？登录控制台 · 充值 · 创建 API Key