在 Claude Code 中使用 Yi-AI Router

通过 Yi-AI Router 连接 Claude Code，无需 Anthropic 官方 API Key 即可使用 Claude 模型。所有请求自动路由，用量和费用在 Yi-AI 后台统一管理。

快速开始

前提条件

已注册 Yi-AI 账户

手动配置（推荐）

将以下环境变量添加到 ~/.zshrc 或 ~/.bashrc：

export ANTHROPIC_AUTH_TOKEN="sk-yi-你的key"
export ANTHROPIC_BASE_URL="https://www.yiairouter.com/api"
export ANTHROPIC_API_KEY=""  # 必须显式置空，防止冲突

保存后重启终端，直接运行 claude 即可。

一键安装与配置

网络不稳定时可尝试此方式，自动安装 Claude Code 并配置 API Key：

# macOS, Linux, WSL
curl -fsSL https://www.yiairouter.com/mirrors/install.sh | bash

# Windows PowerShell
irm https://www.yiairouter.com/mirrors/install.ps1 | iex

终端小贴士： 提示符带 PS C:\ 前缀的是 PowerShell，不带 PS 的是 CMD。CMD 用户请使用 Git for Windows 提供的 Bash 终端运行上述 macOS/Linux 命令。

完成后重启终端或执行 source ~/.zshrc，即可通过专属命令一键启动：

yi-claude

将以下环境变量添加到 ~/.zshrc 或 ~/.bashrc：

export ANTHROPIC_AUTH_TOKEN="sk-yi-你的key"
export ANTHROPIC_BASE_URL="https://www.yiairouter.com/api"
export ANTHROPIC_API_KEY=""  # 必须显式置空，防止冲突

保存后重启终端，直接运行 claude 即可。

验证连接

在 Claude Code 中执行 /status 确认连接状态：

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://www.yiairouter.com/api

也可以运行 /model 查看当前可用模型列表。

清除之前的登录缓存

如果之前曾使用 Anthropic 账户登录过 Claude Code，需要先清除缓存会话：

> /logout

然后退出重新启动 claude，否则可能出现认证冲突导致的模型不可用错误。

工作原理

Yi-AI Router 兼容 Anthropic Messages API。Claude Code 以其原生协议直接与 Yi-AI Router 通信，无需本地代理。平台负责模型映射、用量计费和请求路由。

配置模型

Claude Code 使用多个环境变量决定不同任务的模型。可以通过以下变量分别指定：

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-20250514"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-20250514"

变量	说明
`ANTHROPIC_DEFAULT_OPUS_MODEL`	复杂推理任务使用的模型
`ANTHROPIC_DEFAULT_SONNET_MODEL`	通用编程任务使用的模型
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	快速补全任务使用的模型

将以上变量添加到 ~/.zshrc 或与 ANTHROPIC_BASE_URL 相同的配置文件中。

费用与 Prompt Caching (输入缓存)

Claude Code 属于高吞吐智能体，每次对话均会读取大量本地文件作为上下文。

一折省钱通道： Yi-AI Router 的 messages 端点原生支持 Anthropic 的 Prompt Caching（提示词缓存）技术。
计费逻辑： 只要你的本地文件没有大面积改动，重复发送的上下文将自动命中缓存，输入费用直接暴降 90%（例如 Sonnet 模型的缓存输入仅按原价的 10% 计费）。
计费透明： 你可以登录 Yi-AI 控制台查看最直观的 Token 账单与用量统计。

常见问题

输入内容后终端一直显示 Cerebrating... 且无字符流式输出？
原因：ANTHROPIC_BASE_URL 结尾多带了 /v1，导致 SDK 将请求合并为 /api/v1/v1/messages 触发了 404 死锁；或本地代理层拦截并缓冲了流。
解决：确保 ANTHROPIC_BASE_URL 以 /api 结尾，绝对不要带 /v1。若使用自建网关，请确保路由层启用零阻塞透传。

遇到 There's an issue with the selected model 报错？
原因：99% 的情况下不是模型不存在，而是本地残留了 Anthropic 官方的全局 API Key 或 OAuth 登录态，导致 SDK 发生鉴权冲突。
解决：执行 export ANTHROPIC_API_KEY="" 强行清空官方 Key，并进入 CLI 执行 /logout 清理缓存，然后使用 yi-claude 重新进入。

认证错误
确保 ANTHROPIC_API_KEY 已设为空字符串（""）。如果该变量未设置（null），Claude Code 可能回退到默认 Anthropic 认证方式，导致认证冲突。

上下文长度超限
如遇到上下文限制，可将任务拆分为多个小步骤，或开启新会话。