快速接入 Agent

Claude Code 命令行

Claude Code 是运行在终端里的 AI 编程助手。设置几个环境变量，即可让它通过 Yomi API 调用 claude-sonnet-5 与 claude-opus-4-8。

前置准备

Node.js：18 或更高版本。
Windows 用户：另需安装 Git for Windows。
API 密钥：在控制台「秘钥管理」创建并复制保存，密钥仅创建时可见。

安装

通过 npm 全局安装，macOS、Linux 与 Windows 命令相同：

npm install -g @anthropic-ai/claude-code

执行以下命令，输出版本号即安装成功：

claude --version

配置 Yomi API

Claude Code 通过环境变量读取接入信息：

ANTHROPIC_BASE_URL：平台接入地址，固定为 https://api.yomiapi.com，注意不带 /v1。
ANTHROPIC_AUTH_TOKEN：您的 API 密钥。
ANTHROPIC_MODEL：默认主模型，示例用 claude-sonnet-5，可按需换成 claude-opus-4-8。
其余三项：将 Opus、Sonnet 与子代理场景分别固定到平台目录内的模型。

ANTHROPIC_BASE_URL 必须设置。缺少该变量时，Claude Code 会把请求发往 Anthropic 官方服务器，而不是 Yomi API。

macOS / Linux

将以下内容追加到 ~/.zshrc（使用 bash 的系统为 ~/.bashrc）：

export ANTHROPIC_BASE_URL=https://api.yomiapi.com
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export CLAUDE_CODE_SUBAGENT_MODEL=claude-sonnet-5

保存后运行 source ~/.zshrc，或重开终端使配置生效。

Windows

在终端中依次执行，setx 会把变量写入用户环境变量：

setx ANTHROPIC_BASE_URL "https://api.yomiapi.com"
setx ANTHROPIC_AUTH_TOKEN "YOUR_API_KEY"
setx ANTHROPIC_MODEL "claude-sonnet-5"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-4-8"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-5"
setx CLAUDE_CODE_SUBAGENT_MODEL "claude-sonnet-5"

setx 设置的变量只对新终端生效，执行完毕后请关闭并重新打开终端。

开始使用与验证

进入您的项目目录，启动 Claude Code：

claude

输入一个简单任务，例如「介绍一下这个项目的目录结构」，能正常返回即说明链路可用。
登录控制台，在用户中心「用量统计」中看到对应调用记录，说明请求确实经由 Yomi API。

常见问题

启动后提示 401 认证失败怎么办？

检查 ANTHROPIC_AUTH_TOKEN 是否为「秘钥管理」中的有效密钥，是否完整复制（以 sk- 开头）。密钥被删除或禁用后，需重新创建并更新环境变量。

为什么请求仍发往 Anthropic 官方？

通常是 ANTHROPIC_BASE_URL 未生效。macOS / Linux 执行 echo $ANTHROPIC_BASE_URL，Windows 重开终端后执行 echo %ANTHROPIC_BASE_URL%，输出应为 https://api.yomiapi.com；为空则说明配置未写入或终端未重开。

提示模型不可用怎么办？

确认模型 id 为平台目录值（如 claude-sonnet-5、claude-opus-4-8），且您的密钥所属分组包含该模型。分组在「秘钥管理」创建密钥时选择，可用模型见控制台「模型服务」。