集成

Codex CLI

用 Lovely Router API 密钥使用 Codex CLI：在 config.toml 中添加模型供应商，选择 GPT 模型，提示缓存照常生效。

Codex CLI 是 OpenAI 推出的终端编程智能体。它通过 OpenAI Responses API 调用模型，Lovely Router 为 GPT 模型提供该 API，因此只需在 ~/.codex/config.toml 中把 Lovely Router 添加为模型供应商，其余配置照旧。开始前，你需要先有一个 API 密钥。

一键配置#

在 API 密钥页面，依次点击 接入客户端 → Codex CLI。对话框会显示下面的配置，并已填入你的密钥；用 CC Switch 一键导入 会把 Lovely Router 作为供应商添加到 CC Switch 桌面应用中，模型已预先设好。需已安装 CC Switch。

刚创建密钥时，对话框中已经包含该密钥。对于已有的密钥，请把完整密钥粘贴到对话框中：Lovely Router 只保存哈希，无法再次显示密钥。

添加模型供应商#

把 Lovely Router 添加为模型供应商：

~/.codex/config.toml

model = "gpt-6.1-sol"
model_provider = "lovely"

[model_providers.lovely]
name = "Lovely Router"
base_url = "https://lovelyrouter.com/v1"
env_key = "LOVELY_API_KEY"
wire_api = "responses"

Codex 从 env_key 指定的变量中读取密钥：

Shell

export LOVELY_API_KEY="lr-..."
codex

当前版本的 Codex 已不再接受 wire_api = "chat"；如果你沿用了旧版配置，请把它改为 "responses"。

选择模型#

请使用 GPT 模型（gpt-*）：Responses API 提供的就是这些模型。config.toml 中的 model 设置默认模型，codex -m <model> 则以另一个模型启动会话。模型列表中有全部 ID。

提示缓存#

Codex 会为每个会话发送 prompt_cache_key，因此会话的每一轮都固定在持有其提示缓存的渠道上。请参阅提示缓存。

通过 MCP 添加数据工具#

位于 https://lovelyrouter.com/mcp 的 MCP 服务器可以为 Codex 提供数据工具和浏览器智能体，费用从同一余额中扣除。它使用同一个密钥进行身份验证：

Shell

codex mcp add lovely --url https://lovelyrouter.com/mcp --bearer-token-env-var LOVELY_API_KEY

这会把服务器写入 ~/.codex/config.toml。Codex 在启动时从 LOVELY_API_KEY 读取密钥，因此文件中不会保存密钥：

~/.codex/config.toml

[mcp_servers.lovely]
url = "https://lovelyrouter.com/mcp"
bearer_token_env_var = "LOVELY_API_KEY"

运行 codex mcp list 进行检查。完整的工具列表请参阅 MCP 服务器。

故障排查#

现象	解决方法
`401`，消息为 `Missing API key`	Codex 没有发送密钥。在启动 `codex` 的 Shell 中 export `LOVELY_API_KEY`，并确认 `env_key` 填的就是这个变量名。
`401`，消息为 `Invalid or revoked API key`	密钥输错、被截断或已吊销。重新粘贴，或创建一个新密钥。
`404`，消息为 `not served in responses format`	Responses API 只提供 GPT 模型。请把 `model` 设为 `gpt-*` 模型 ID。
`404`，消息为 `Unknown endpoint /responses`	`base_url` 缺少 `/v1`。请将其设为 `https://lovelyrouter.com/v1`。
Codex 拒绝 `wire_api = "chat"`	把它改为 `wire_api = "responses"`。
`402`	余额已用完，或密钥已达到消费上限。请参阅额度与计费。

其他所有状态码请参阅错误。