Claude Code 接入 927AI

Claude Code 可以通过 Anthropic Messages 协议连接 927AI。国内用户使用 https://vip.927ai.ai，该地址末尾不要添加 /v1，Claude Code 会自行请求 /v1/messages。

安装 Claude Code

macOS、Linux 或 WSL 推荐使用官方安装脚本：

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

也可以通过 npm 安装：

临时配置并启动

macOS、Linux 或 WSL：

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://vip.927ai.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-替换为你的927AI_API_Key"
$env:ANTHROPIC_MODEL = "claude-fable-5"

claude --model claude-fable-5

ANTHROPIC_AUTH_TOKEN 会把 API Key 作为 Authorization: Bearer ... 发送。927AI 同时兼容 x-api-key，但 Claude Code 接入建议使用上面的 Bearer Token 方式。

添加到模型选择器

如果 /model 中没有显示 claude-fable-5，可在启动 Claude Code 前增加以下环境变量：

也可以直接使用 claude --model claude-fable-5，无需依赖模型选择器。

先验证 API

在同一个终端执行：

收到包含 id、content 和 usage 的 JSON 响应，说明节点、API Key 和模型均可用。

检查 Claude Code 当前配置

启动 Claude Code 后执行：

/status

状态页应显示：

Anthropic base URL 为 https://vip.927ai.ai。

鉴权来源为 ANTHROPIC_AUTH_TOKEN。

当前模型为 claude-fable-5。

如果 Claude Code 仍然使用之前保存的 claude.ai 登录，可先执行 /logout，关闭终端后重新设置环境变量并启动。

持久化配置

可将 Base URL 和模型写入用户级 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://vip.927ai.ai",
    "ANTHROPIC_MODEL": "claude-fable-5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION": "claude-fable-5",
    "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "Claude Fable 5"
  },
  "model": "claude-fable-5"
}

API Key 建议继续通过 ANTHROPIC_AUTH_TOKEN 环境变量提供，不要写入项目级 .claude/settings.json。

常见问题

返回 401 Unauthorized

确认 ANTHROPIC_AUTH_TOKEN 中只填写 API Key 本身。环境变量中不要手动添加 Bearer 前缀，Claude Code 会自动生成完整的 Authorization 请求头。

返回 404 Not Found

确认 ANTHROPIC_BASE_URL 是 https://vip.927ai.ai，不要填写成 https://vip.927ai.ai/v1，否则客户端可能请求错误的重复路径。

返回 No available channel

说明请求已经到达 927AI，但当前 API Key 分组没有可用于当前使用模型的渠道。请在模型与价格页面切换到该分组可用的模型，或更换 API Key 分组。

官方参考

Claude Code：连接 LLM 网关

Claude Code：模型配置

Claude Code：安装说明

Claude Code

Claude Code 接入 927AI#

安装 Claude Code#

临时配置并启动#

添加到模型选择器#

先验证 API#

检查 Claude Code 当前配置#

持久化配置#

常见问题#

返回 401 Unauthorized#

返回 404 Not Found#

返回 No available channel#

官方参考#