---
title: "通过 Fireworks FireConnect 连接模型服务"
summary: "用户 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。"
category: config
level: intermediate
surfaces: [cli, app]
tags: ["model_providers", "Fireworks", "FireConnect", "wire_api", "FIREWORKS_API_KEY"]
canonical: /tips/fireworks-fireconnect-codex/
---

# 通过 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`，并写成整机默认）：

```bash
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`：

```toml
# ~/.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]`（源码已当旧表剥掉）：

```toml
# ~/.codex/fireworks.config.toml
model_provider = "fireworks-ai"
model = "kimi-fast-latest"
```

```bash
codex --profile fireworks
```

`on` 还会写 `~/.codex/fireworks-model-catalog.json`，并用顶层 `model_catalog_json` 指过去。目录键启动时加载，改完必须新开会话。续写旧会话要带着供应商，否则会退回 OpenAI：

```bash
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` 能对上，说明供应商和密钥都进了这一进程。

## 来源

- [Fireworks · Codex](https://docs.fireworks.ai/ecosystem/fireconnect/codex)
- [fw-ai/fireconnect](https://github.com/fw-ai/fireconnect)
- [OpenAI · Advanced configuration](https://learn.chatgpt.com/docs/config-file/config-advanced)