Skip to content

Claude Code 接入

Claude Code 是 Anthropic 官方的命令行编程助手。接上 Aivisx Link 后,你可以用平台额度直接驱动它。

前置条件

分组必须是 claude

Claude Code 走 Anthropic 协议,只有 claude 分组的 Key 能用。用 gpt-* 分组的 Key 会报错。

安装 Claude Code

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

验证安装:

bash
claude --version

配置接入

Claude Code 通过两个环境变量来指定服务地址和凭据。

Windows(PowerShell)

临时生效(当前窗口):

powershell
$env:ANTHROPIC_BASE_URL = "https://aivisx.link"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的KEY"
claude

永久生效(写入用户环境变量):

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aivisx.link", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的KEY", "User")

设置后需要重新打开终端

macOS / Linux

临时生效:

bash
export ANTHROPIC_BASE_URL="https://aivisx.link"
export ANTHROPIC_AUTH_TOKEN="sk-你的KEY"
claude

永久生效,把这两行加到 ~/.zshrc(macOS)或 ~/.bashrc(Linux):

bash
echo 'export ANTHROPIC_BASE_URL="https://aivisx.link"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的KEY"' >> ~/.zshrc
source ~/.zshrc

关键配置说明

变量说明
ANTHROPIC_BASE_URLhttps://aivisx.link不要带 /v1,Claude Code 会自己拼路径
ANTHROPIC_AUTH_TOKENsk-你的KEY你的 API Key

两个最常见的错误

  1. Base URL 写成 https://aivisx.link/v1 → 请求变成 /v1/v1/messages,返回 404。正确写法不带 /v1
  2. 用了 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN → 前者是给官方 API 用的,接入第三方网关必须用后者。

指定模型

Claude Code 默认会用某个 Claude 模型。如果你想固定用某个模型,可以在启动时指定:

bash
claude --model claude-sonnet-4-7

或者在配置文件里写死。可用模型见 模型选择

推荐搭配:

场景模型
日常编码、重构claude-sonnet-4-7
复杂推理、架构设计claude-opus-5
简单改动、省成本claude-haiku-4-5

验证是否接通

启动 Claude Code:

bash
claude

然后随便输入一句:

用一句话说明这个项目是做什么的

如果能正常流式返回内容,说明已经接上 Aivisx Link 了。

如果报鉴权错误,按 疑难杂症 逐项排查。

常见问题

Q:怎么确认当前用的是中转站而不是官方? 在 Claude Code 里执行 /status,查看 API 地址。显示 https://aivisx.link 就对了。

Q:能不能同时保留官方订阅? 可以。用 CC-Switch 管理两套配置,一键切换。

Q:响应很慢怎么办? 高峰期 gpt-pro 分组比 gpt-plus 更稳(倍率也更高)。Claude 侧建议优先用 claude-sonnet-4-7 而不是 opus。

Q:提示上下文超限? 换用上下文窗口更大的模型,或者用 /compact 压缩会话历史。

下一步

Aivisx Link · AI API 网关平台