VToken
接入 Claude Code
在 Claude Code 中接入 VToken。
Claude Code 是一个运行在终端内的 AI 编程助手。VToken 通过 Anthropic Messages 兼容接口接入 Claude Code。
从现有安装中迁移到 VToken
如果你已经安装了 Claude Code，只需修改以下环境变量，其中 API Key 在 VToken Platform 获取。
ANTHROPIC_BASE_URL 填写 VToken 网关根地址即可。Claude Code 会请求 Anthropic Messages 格式的 /v1/messages，不要额外追加 /anthropic。
Linux / Mac 用户，直接执行：
export ANTHROPIC_BASE_URL=https://api.vtoken.cc
export ANTHROPIC_AUTH_TOKEN=<你的 VToken API Key>
export ANTHROPIC_MODEL=gpt5.5
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt5.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt5.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt5.5
export CLAUDE_CODE_SUBAGENT_MODEL=gpt5.5
export CLAUDE_CODE_EFFORT_LEVEL=high
Windows 用户在 PowerShell 中执行：
$env:ANTHROPIC_BASE_URL="https://api.vtoken.cc"
$env:ANTHROPIC_AUTH_TOKEN="<你的 VToken API Key>"
$env:ANTHROPIC_MODEL="gpt5.5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="gpt5.5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="gpt5.5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt5.5"
$env:CLAUDE_CODE_SUBAGENT_MODEL="gpt5.5"
$env:CLAUDE_CODE_EFFORT_LEVEL="high"
配置完成后执行：
cd /path/to/my-project
claude
需要更深推理时，可以把 CLAUDE_CODE_EFFORT_LEVEL 改为 max，但这会增加 token 消耗。
从零安装 Claude Code
1. 安装 Claude Code
推荐使用 Claude Code 官方安装方式：
macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
也可以使用 npm 安装，此方式需要 Node.js 18+：
npm install -g @anthropic-ai/claude-code
claude --version
2. 配置环境变量
同上，配置 VToken Anthropic API 兼容环境变量，VToken API Key 来自 VToken Platform。
3. 进入项目目录，执行 claude 命令
cd /path/to/my-project
claude
常见问题
404或找不到接口：确认ANTHROPIC_BASE_URL是https://api.vtoken.cc，不要额外追加/anthropic。401或鉴权失败：确认ANTHROPIC_AUTH_TOKEN填写的是 VToken API Key。如果之前设置过ANTHROPIC_API_KEY，建议先清理旧值后重新启动终端。- 模型不存在：以 VToken Platform 中展示的模型 ID 为准。