LinkAGI

Claude Code 中转站 · LinkAGI 实操

Claude Code 接中转
根地址不要带 /v1

LinkAGI 提供 Anthropic Messages 兼容路由。Claude Code 的 ANTHROPIC_BASE_URL 填 https://api.linktoagi.com，再用独立 API Key 鉴权。

复制完整配置查看 Claude 模型
Base URL根地址，不加 /v1
最终路由/v1/messages
鉴权变量ANTHROPIC_AUTH_TOKEN

推荐：用 settings.json 长期保存

该文件对终端中的 Claude Code 持续生效。请保持 JSON 语法完整，不要留下尾逗号。

macOS / Linux / WSL

~/.claude/settings.json

mkdir -p ~/.claude
$EDITOR ~/.claude/settings.json

Windows

%USERPROFILE%\.claude\settings.json

notepad $env:USERPROFILE\.claude\settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-替换成你创建的API Key",
    "ANTHROPIC_BASE_URL": "https://api.linktoagi.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Claude Code 当前网关文档支持通过 ANTHROPIC_BASE_URL 与凭证变量连接自定义网关，并可在 ~/.claude/settings.json 的 env 中持久保存。LinkAGI 当前采用 Bearer token 形式，因此教程使用 ANTHROPIC_AUTH_TOKEN。

临时测试：先用环境变量启动

还不确定配置是否正确时，可以先只影响当前终端。验证成功后再写入 settings.json。

Bash / Zsh

export ANTHROPIC_BASE_URL="https://api.linktoagi.com"
export ANTHROPIC_AUTH_TOKEN="sk-替换为你的Key"
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.linktoagi.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-替换为你的Key"
claude
关键规则

Claude Code 会从根地址继续请求 /v1/messages。如果 Base URL 已经带 /v1，常见结果是重复路径或 404。

三层验证，不要直接反复重装

01

路由层

无 Key POST /v1/messages 应到达 JSON 鉴权响应，而不是 HTML 页面。

02

配置层

在 Claude Code 输入 /status，核对 Base URL 与凭证来源。

03

业务层

发送一条短消息，再到 LinkAGI 使用日志核对模型、Token 和扣费。

# 路由可达性检查：不带 Key，不消耗模型额度
curl -i https://api.linktoagi.com/v1/messages \
  -X POST \
  -H "content-type: application/json" \
  -d '{}'
2026-07-23 实测

上面的无 Key POST 返回 JSON 401，说明域名、TLS、Nginx 和 Messages 路由已到达鉴权层。真实模型成功与否仍由 Key、余额、分组和模型状态决定。

Claude Code 报错对照表

仍出现登录向导

先检查 settings.json 路径与 JSON 格式，再确认没有只把配置写在项目文件中；完全关闭终端和编辑器后重启。

401 / 403

检查 ANTHROPIC_AUTH_TOKEN 是否为空、Key 是否有效、余额是否充足，以及令牌分组是否支持 Claude。

404 / Invalid URL

将 Base URL 改回域名根地址，删除末尾的 /v1 或 /v1/messages。

model not found

在模型广场复制完整模型 ID。当前可用模型和分组会变化，不要照抄旧教程中的名称。

429 / 限速

降低并发、暂停高频脚本，检查是否触发令牌或上游限流，再按日志时间定位请求。

5xx / timeout

先用短请求判断是否只在长任务出现；查看系统公告与号池状态，必要时切换可用分组。

在 CC Switch 中启用 LinkAGI Claude Code 中转配置
不想手动编辑 JSON 时，可用 CC Switch 保存并启用 LinkAGI 提供方。

不想手改配置文件

LinkAGI 文档提供 CC Switch 图形化流程。选择 Claude，自定义提供方填写 LinkAGI，API 地址仍然使用不带 /v1 的根地址。

查看 CC Switch 教程

用一条短消息完成首次验证

创建 Claude Code 分组 Key，复制实时模型名，成功后再迁移正式项目。

注册 LinkAGI