客户端接入指南

Claude Code

准备 Claude Code 的 Inferway 配置文件。

暂未开放

Claude Code 需要 Anthropic Messages 接口，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

保存配置模板

保存为 inferway.claude.json。ANTHROPIC_BASE_URL 不带末尾的 /v1，客户端会追加 /v1/messages。文件不包含凭证；下方启动命令从环境变量读取 Key。

inferway.claude.jsonjson
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.inferway.ai"
  },
  "model": "inferway/qwen3.8-27b"
}

使用此配置文件启动

--settings 将此文件用于当前会话，ANTHROPIC_AUTH_TOKEN 通过 Bearer 认证传递 Inferway Key。不要将 $INFERWAY_API_KEY 原样写入 JSON；下面的命令由 shell 展开变量。已有设置或管理策略可能影响最终配置，可通过 /status 和所选模型核对。

Claude Code CLIbash
ANTHROPIC_AUTH_TOKEN="$INFERWAY_API_KEY" claude --settings ./inferway.claude.json

Messages 开放后验证