准备工作

注册 OpusVIP 控制台（支持使用 Google 登录）。充值方式即将开放。
打开令牌页面，创建一个 API Key（以 sk- 开头）并复制。密钥等同于你的余额，不要提交到代码仓库或发给他人。
安装 Claude Code。已经装好的可以跳过：

安装 Claude Code

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

OpusVIP 只需要这两个值：

环境变量	值
`ANTHROPIC_BASE_URL`	`https://api.opusvip.dev`（不要加 `/v1`）
`ANTHROPIC_AUTH_TOKEN`	你在控制台创建的 `sk-` 密钥

macOS / Linux

临时生效（只对当前终端）

zsh / bash

export ANTHROPIC_BASE_URL=https://api.opusvip.dev
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥
claude

长期生效

写进 shell 配置文件，之后打开的每个终端都会自动带上：

写入 ~/.zshrc

# zsh（macOS 默认）；bash 用户把 ~/.zshrc 换成 ~/.bashrc
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.opusvip.dev
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥
EOF
source ~/.zshrc

Windows

PowerShell，临时生效

PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.opusvip.dev"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude

PowerShell，长期生效

写入用户环境变量

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.opusvip.dev", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")

命令提示符（CMD），长期生效

CMD

setx ANTHROPIC_BASE_URL "https://api.opusvip.dev"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

setx 和 SetEnvironmentVariable 只对新打开的终端生效。设置完成后关闭当前窗口，重新打开再运行 claude。

写入 settings.json（推荐）

也可以把配置写进 Claude Code 自己的设置文件，对所有终端和 IDE 插件都生效：

macOS / Linux：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.opusvip.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5"
  }
}

如果文件里已经有其他设置，把 env 中的几项合并进去即可，不需要覆盖整个文件。

OpusVIP 可选的模型只有 Opus 系列。上面的配置把 opus、sonnet 两个模型别名都指向 claude-opus-5-5，这样无论 Claude Code 默认选哪个别名，主对话都会使用 Opus。Claude Code 自动发起的后台辅助请求（例如生成会话标题）会使用 Haiku，按 Haiku 官方价计费，通常只占很小一部分用量。

选择 Opus 型号

OpusVIP 提供以下五个型号。充值 ¥2.5 = $1 额度，按 Anthropic 官方价扣费；下表已折算为人民币（元 / 百万 token）：

模型 ID	输入	输出	缓存读取
`claude-opus-5-5`	¥10.00	¥50.00	¥0.50
`claude-opus-5`	¥12.50	¥62.50	¥1.25
`claude-opus-4-8`	¥12.50	¥62.50	¥1.25
`claude-opus-4-7`	¥12.50	¥62.50	¥1.25
`claude-opus-4-6`	¥12.50	¥62.50	¥1.25

想用其他型号，可以在启动时或会话中指定：

切换型号

# 启动时指定
claude --model claude-opus-4-8

# 或在会话中切换
/model claude-opus-4-8

如果希望默认就用某个型号，把 settings.json 里的 ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 改成对应的模型 ID 即可。缓存写入价格见模型与价格。

验证配置

在终端运行：

一次性提问

claude -p "hello"

能收到 Opus 的回复，就说明接入成功。之后还可以：

运行 claude 进入交互模式，输入 /status，确认 Anthropic base URL 显示为 https://api.opusvip.dev，认证来源为 ANTHROPIC_AUTH_TOKEN。
输入 /model 确认当前使用的是 Opus。
回到控制台的使用日志，可以看到刚才的请求和对应的 token 用量。

故障排查

现象	原因与处理
请求被拒绝，提示客户端不受支持	OpusVIP 只接受官方 Claude Code CLI 的请求。请使用官方 Claude Code，并保持较新版本；其他客户端、SDK 和 curl 请求会被拒绝。
启动后仍然要求登录 Anthropic 账号	确认环境变量在当前终端已生效（`echo $ANTHROPIC_BASE_URL`）。首次安装时，可以在 `~/.claude.json` 中加入下方的 `hasCompletedOnboarding` 跳过引导。
401 / 认证失败	密钥复制不完整或已被删除，请到控制台重新复制。如果之前登录过 claude.ai，运行 `/logout` 清除旧登录；如果设置了 `ANTHROPIC_API_KEY`，请删除它。
404 / 路径不存在	`ANTHROPIC_BASE_URL` 末尾多写了 `/v1` 或其他路径，只填 `https://api.opusvip.dev`。
模型不存在 / 无可用渠道	请求了不提供的模型，例如 Sonnet。按 settings.json 一节把 opus、sonnet 两个别名都指向 Opus 型号。
余额不足	充值比例为 ¥2.5 = $1 额度，充值方式即将开放。失败的请求不会扣费。
连接超时或 TLS 错误	检查 `HTTPS_PROXY`、`HTTP_PROXY`、`ALL_PROXY` 等代理变量和代理软件的规则，确认它们没有拦截或错误转发 `api.opusvip.dev`。
Windows 上设置后不生效	`setx` 只影响新窗口。关闭所有终端和 IDE 后重新打开再试。

~/.claude.json（只需添加这一项）

{
  "hasCompletedOnboarding": true
}

以上方法都试过仍有问题，请在控制台查看该请求的日志，带上请求时间和错误信息发邮件到 zxzxy1988@gmail.com。

注册控制台模型与价格

Claude Code 接入 OpusVIP