通过 Fireworks FireConnect 连接模型服务
用户 config 写 [model_providers.fireworks-ai],base_url 是 https://api.fireworks.ai/inference/v1,env_key = FIREWORKS_API_KEY,wire_api = responses。官方 CLI 是 fireconnect login 再 fireconnect codex on。
Fireworks 官方 Codex 网关:用户层 [model_providers.fireworks-ai],base_url 是 https://api.fireworks.ai/inference/v1,env_key 读 FIREWORKS_API_KEY。这是换 Codex 使用的模型,不是添加 MCP 服务,也不是插件。官方 Codex 页要求 CLI 0.134+,密钥必须是标准 fw_...。Fire Pass fpk_... 不能走 Codex 的 Responses 入口。
官方一键(会改用户 ~/.codex/config.toml 的顶层 model_provider / model,并写成整机默认):
fireconnect login
fireconnect codex on
fireconnect codex status
换模型:fireconnect codex on --model glm-5p2。关掉并还原备份:fireconnect codex off。快照在 ~/.fireconnect/codex/。fireconnect chatgpt 是同一份 config,开/关前先退出 ChatGPT 桌面,模型列表才会刷新。
现行 CLI 会把 fw_ 密钥写成 experimental_bearer_token 字面量(文件模式 0600)。OpenAI 标明这一项不推荐,手写时改用 env_key:
# ~/.codex/config.toml
[model_providers.fireworks-ai]
name = "Fireworks"
base_url = "https://api.fireworks.ai/inference/v1"
env_key = "FIREWORKS_API_KEY"
wire_api = "responses"
requires_openai_auth = false
env_key 是变量名。密钥必须出现在启动 Codex 的那个进程里。不要把 fw_ 写进 TOML。从已经 export FIREWORKS_API_KEY 的终端启动;Dock 打开的桌面不会读你刚改的 zshrc。
不要一上来把顶层 model_provider = "fireworks-ai" 写成整机默认,除非你就是要把所有会话都改走 Fireworks。CLI on 会写成默认。更稳妥是独立 profile,不要再写 [profiles.fireconnect](源码已当旧表剥掉):
# ~/.codex/fireworks.config.toml
model_provider = "fireworks-ai"
model = "kimi-fast-latest"
codex --profile fireworks
on 还会写 ~/.codex/fireworks-model-catalog.json,并用顶层 model_catalog_json 指过去。目录键启动时加载,改完必须新开会话。续写旧会话要带着供应商,否则会退回 OpenAI:
codex resume -c model_provider="fireworks-ai"
MiniMax 不能走 Codex:Responses 可能在 tool_calls 和 tool_results 之间插入 assistant 消息,MiniMax 模板会拒。Foundry 是另一张表 [model_providers.fireworks-azure],不是这条网关。
配置说明:
- 不要抄
fireconnect claude的ANTHROPIC_BASE_URL/settings.json。 - 不要写进项目
.codex/config.toml。项目文件无法修改model_provider/model_providers。 - 不要覆盖内置 ID
openai、ollama、lmstudio。fireworks-ai是新 ID,可以。 - 不要把安装器
curl …/fw-ai/fireconnect/…/install.sh当成 Codex 插件。 - 不要用
fpk_Fire Pass。
改完新开会话。codex --profile fireworks 或 fireconnect codex status 能对上,说明供应商和密钥都进了这一进程。