Claude Code

开始之前

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

账户开通后，在控制台的「API 密钥」页创建密钥。建议给这个客户端单独建一把；花费上限可以用项目的月度预算来控制。live 和 test 两种前缀走的是同一套推理和计费流程，test 只是环境标签，不代表免费，也不是模拟推理。

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

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

在当前终端设置 Key

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

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

让 Claude Code 指向 Inferway

在启动 Claude Code 的终端中导出以下变量。ANTHROPIC_BASE_URL 只填地址前缀，不带 /v1，客户端会自行追加 /v1/messages。ANTHROPIC_AUTH_TOKEN 以 Bearer 方式传递 Inferway Key；Key 保留在环境中，不写入任何文件。

请使用环境变量，不要写进配置文件。配置文件中的 env 不会在会话认证之前改写地址，客户端仍会访问 Anthropic 并报 bearer token 无效——这看起来像 Key 错误，实际是地址没生效。

该模型 ID 不在 Claude Code 内置目录中，客户端会给出提示并按较小的上下文窗口估算。CLAUDE_CODE_MAX_CONTEXT_TOKENS 用于填写该模型已公布的窗口。

export ANTHROPIC_BASE_URL='https://api.inferway.ai'
export ANTHROPIC_AUTH_TOKEN="$INFERWAY_API_KEY"
export ANTHROPIC_MODEL='minimax/minimax-m3.1-flash'
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1048576
claude

思考模式

Claude Code 默认请求思考模式，Inferway 会为这些请求开启模型思考：回复更慢，推理 token 计费。如需关闭思考，启动 claude 前再导出 CLAUDE_CODE_DISABLE_THINKING=1。

验证接入

先发一条短消息，再试一次只读工具调用。请求有没有被记录，可以在控制台的「请求」页查看。

常见问题

设置文件中的 env 段为什么不生效？如果写进设置文件的 env 没生效，最稳妥的做法是在启动 claude 的终端里 export ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN（见上文『设置环境变量』一节）。

如何切回默认服务商？在导出过变量的终端中执行 unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL CLAUDE_CODE_MAX_CONTEXT_TOKENS（如果还导出过 CLAUDE_CODE_DISABLE_THINKING，也一并 unset），或重新打开终端即可恢复默认设置。只清前两个变量的话，留下的 ANTHROPIC_MODEL 会让 Claude Code 拿 Inferway 的模型 ID 去请求默认服务商，留下的 CLAUDE_CODE_MAX_CONTEXT_TOKENS 会让它按错误的上下文窗口估算。

工具调用与流式传输支持情况如何？未验证。Inferway 的 /v1/messages 接口在协议层支持流式 SSE 输出与客户端自定义工具调用（见 app/anthropic_compat/constants.py），但 Claude Code 客户端对特定模型的工具调用与端到端交互在本仓库尚未记录生产环境验证回执（未验证），待后续版本发布并实测后更新。

费用与用量

实际用量由 Inferway 记录：控制台的「请求」页能看到每次请求的状态和 Token 用量，「用量」页是汇总。客户端本地显示的数字只是它自己的估算，不是实际扣费，一切以控制台为准。

请求失败时

认证失败：检查 Key 是否存在、有效且获准使用该模型，并从设置变量的终端重新打开客户端。排错时不要输出完整 Key。

地址或模型错误：检查是否重复添加 /v1，使用公布的完整模型 ID，并确认客户端选择 Chat Completions。请求发往 /responses 或 /completions 时，换 Key 无法解决。

额度或超时：检查钱包余额和 Key 限额，按 Retry-After 等待，并缩短输入或降低输出上限。长输出保持流式传输，排错期间避免 Agent 连续重试。

联系支持时提供客户端版本、模型 ID、请求时间和可用的 request ID；请遮盖凭证和源码。