推荐安装
先安装 FlyHub CLI，再用它写入配置文件与环境变量（与 Codex Desktop 共用 ~/.codex/config.toml）。将 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 CLI
请先在 FlyHub 控制台创建 API Key，并将 <FLYHUB_API_KEY> 替换为你的密钥。
按 OpenAI 官方文档安装 Codex CLI。Linux 用户通常使用 CLI 版本而非桌面客户端。
桌面版 Codex 配置方式相同，参见 Codex 客户端接入页。
2. 配置 config.toml
与 Codex Desktop 相同，写入 FlyHub provider 配置：
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"
EOF3. 设置 API Key
macOS（zsh）：
bash
echo 'export OPENAI_API_KEY="<FLYHUB_API_KEY>"' >> ~/.zshrc
source ~/.zshrcLinux（bash）：
bash
echo 'export OPENAI_API_KEY="<FLYHUB_API_KEY>"' >> ~/.bashrc
source ~/.bashrcWindows：
powershell
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<FLYHUB_API_KEY>", "User")4. 验证连接
在新终端中运行 codex，发送一条简单指令。若正常返回，说明已通过 FlyHub 成功调用模型。
bash
codex若提示找不到命令，请确认 Codex CLI 已加入 PATH，或重新打开终端加载环境变量。
5. 故障排查
API 返回 401 或 invalid_bearer_token：确认 Key 完整、无多余空格、未被删除。若仍失败，请在控制台重新创建 Key 并重试。
模型不可用：先调用 GET /v1/models 获取实时列表，核对模型 ID 拼写。
准备好了？登录控制台 · 充值 · 创建 API Key