客户端接入指南

Codex

准备 Codex 的 Inferway 自定义服务商配置。

暂未开放

Codex 需要 Responses API，Inferway 目前暂不支持。现在可使用 Pi 或 Hermes 接入。

使用现有 API

接口开放后的配置参考

开始之前

先按官方说明安装客户端。本文的 Pi 指 pi-mono coding agent；Hermes 指 Nous Research 的 Hermes Agent。

Inferway 账户激活后，从控制台 → API keys 获取 Key。建议为该客户端使用独立 Key，并确认允许的模型和消费上限。live、test 前缀共用推理与计费流程；test 是环境标签，不代表免费或模拟推理。

Inferway 地址需要 Inferway Key；OpenRouter Key 用于 OpenRouter，不能直接用于此地址。

将 Key 保存在客户端凭证存储或本机环境中，不要粘贴到提示词、截图或提交到仓库的配置文件。终端示例适用于 macOS / Linux 的 bash、zsh。

在当前终端设置 Key

下面的交互输入会隐藏 Key，并避免将其写入命令历史。请从同一个终端启动客户端；另外打开的应用可能无法继承该变量。

INFERWAY_API_KEYbash
printf 'Inferway API key: '
IFS= read -r -s INFERWAY_API_KEY
printf '\n'
export INFERWAY_API_KEY

保存自定义服务商模板

合并到用户级 ~/.codex/config.toml，保留其他设置。model 和 model_provider 放在所有表头之前的顶层；已有同名字段时更新，不要重复添加。此配置会将默认服务商设为 Inferway。服务商设置不要放进仓库内的 .codex/config.toml。

base_url 只包含一次 /v1。env_key 填环境变量名，不加美元符号。当前 Codex 的 wire_api 只支持 responses；改为 chat 不能启用 Chat Completions。

~/.codex/config.tomltoml
model = "inferway/qwen3.8-27b"
model_provider = "inferway"

[model_providers.inferway]
name = "Inferway"
base_url = "https://api.inferway.ai/v1"
env_key = "INFERWAY_API_KEY"
wire_api = "responses"
requires_openai_auth = false

启动 Codex CLI

从设置了 INFERWAY_API_KEY 的终端启动。自定义服务商使用 Inferway 凭证，无需 OpenAI 登录。下面的命令启动 CLI；单独打开的桌面应用可能无法继承变量。

Codex CLIbash
codex

Responses 开放后验证