文档概览

Air Router 为 Claude Code、Codex 和 Grok Build 提供统一的 API Key 管理、模型分组和用量计费。你可以继续使用各客户端原有的配置方式，只需替换 API Key 与 Base URL。

你需要准备什么

• 一个可登录的 Air Router 账户
• 一个已创建且状态正常的 API Key
• 对应模型包或分组的可用额度
• Node.js、终端或目标客户端所要求的运行环境

三种客户端的差异

客户端	推荐协议	Base URL	关键配置
Claude Code	Anthropic Messages	https://www.air-router.com	不附加 /v1
Codex	OpenAI Responses	https://www.air-router.com/v1	wire_api = "responses"
Grok Build	OpenAI Responses	https://www.air-router.com/v1	api_backend = "responses"

Base URL 很重要

Claude Code 会自行拼接 /v1/messages，因此它的 Base URL 不应包含 /v1。Codex 与 Grok Build 的配置则需要包含 /v1。

推荐阅读顺序

1. 按照快速开始完成注册、充值、创建 API Key 和 CLI 安装。
2. 选择 Claude Code、Codex 或 Grok Build 完成官方客户端配置。
3. 需要使用其他 Agent 时，阅读第三方接入。
4. 遇到问题时，根据常见问题与排错定位原因。