注册账号

1

访问官网

打开浏览器，访问 https://api.vanylo.top

2

点击注册

点击页面右上角的「注册」按钮

3

填写信息

输入你的邮箱地址和密码，完成注册

充值

注册完成后，需要充值才能调用 API。

添加令牌

令牌使用说明

创建令牌后，将其配置到对应工具的环境变量或配置文件中：

系统要求

• Windows 10 / 11（64位）
• Git 2.23+
• Node.js 18+

安装 Git

git -v

安装 Node.js

方式一：使用 fnm 安装 推荐

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，支持轻松安装和切换多个 Node.js 版本。

fnm install --lts
node -v

方式二：官网下载安装包

访问 Node.js 官网 下载 Windows 安装包，运行后按提示完成安装，重启终端验证：

node -v

安装 Claude Code

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

配置 API

手动配置方式：按 Win + R，输入 %userprofile%\.claude，打开配置目录，找到或创建 settings.json，写入以下内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.vanylo.top",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

系统要求

• macOS 10.15 (Catalina) 或更高版本
• Git（macOS 通常已预装，终端运行 git -v 检查）
• Node.js 18+

安装 Node.js

方式一：使用 fnm 安装 推荐

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 安装最新 LTS 版本
fnm install --lts
node -v

方式二：使用 Homebrew

brew install node

安装 Claude Code

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

配置 API

Zsh 用户（macOS 默认）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.vanylo.top"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.vanylo.top"' >> ~/.bash_profile
source ~/.bash_profile

验证启动

打开终端，进入任意项目目录，输入 claude 启动。

系统要求

• Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版
• Git 2.23+（运行 git -v 检查）
• Node.js 18+

安装 Git（如未安装）

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y git

# CentOS / RHEL
sudo yum install -y git

安装 Node.js

方式一：使用 fnm 安装 推荐

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装最新 LTS 版本
fnm install --lts
node -v

方式二：使用 NodeSource（Ubuntu/Debian）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

安装 Claude Code

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

配置 API

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.vanylo.top"' >> ~/.bashrc
source ~/.bashrc

验证启动

claude --version
claude

功能特点

• 一键切换 API 配置，在多个提供商之间快速切换
• 可视化配置管理，通过图形界面轻松管理 API Key
• MCP 服务器管理
• 系统托盘快捷操作

下载安装

访问 CC-Switch 下载页面，Windows 用户推荐下载 .msi 安装包。

配置 Vanylo API

系统要求

• Windows 10 / 11（64位），同时支持原生 Windows 和 WSL2（WSL2 更稳定）
• Node.js 24（推荐）或 22.14+

推荐安装方式：官方安装脚本

在 PowerShell 中运行：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果不需要运行新手引导：

([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

其他安装方式

使用 npm 安装

如果你已自行管理 Node.js：

npm install -g openclaw@latest
openclaw onboard --install-daemon

配置 Vanylo API

在 PowerShell 中设置环境变量（临时，关闭终端后失效）：

$env:OPENCLAW_API_KEY="sk-你的令牌"
$env:OPENCLAW_BASE_URL="https://api.vanylo.top"

持久化配置（写入用户配置文件）：

[System.Environment]::SetEnvironmentVariable("OPENCLAW_API_KEY", "sk-你的令牌", "User")
[System.Environment]::SetEnvironmentVariable("OPENCLAW_BASE_URL", "https://api.vanylo.top", "User")

验证安装

openclaw --version
openclaw doctor

系统要求

• macOS 系统
• Node.js 24（推荐）或 22.14+

推荐安装方式：官方安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash

如果不需要运行新手引导：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

其他安装方式

使用 npm 安装

npm install -g openclaw@latest
openclaw onboard --install-daemon

配置 Vanylo API

Zsh 用户（macOS 默认）：

echo 'export OPENCLAW_API_KEY="sk-你的令牌"' >> ~/.zshrc
echo 'export OPENCLAW_BASE_URL="https://api.vanylo.top"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export OPENCLAW_API_KEY="sk-你的令牌"' >> ~/.bash_profile
echo 'export OPENCLAW_BASE_URL="https://api.vanylo.top"' >> ~/.bash_profile
source ~/.bash_profile

验证安装

openclaw --version
openclaw doctor
openclaw gateway status

系统要求

• Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版，同时支持 WSL2
• Node.js 24（推荐）或 22.14+

推荐安装方式：官方安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash

其他安装方式

使用 npm 安装

npm install -g openclaw@latest
openclaw onboard --install-daemon

本地前缀安装（不污染系统环境）

curl -fsSL https://openclaw.ai/install-cli.sh | bash

配置 Vanylo API

echo 'export OPENCLAW_API_KEY="sk-你的令牌"' >> ~/.bashrc
echo 'export OPENCLAW_BASE_URL="https://api.vanylo.top"' >> ~/.bashrc
source ~/.bashrc

验证安装

openclaw --version
openclaw doctor
openclaw gateway status

前置条件

• Node.js 18+（安装方式参考 Claude Code Windows 安装）
• Git 2.23+

安装 Codex

npm install -g @openai/codex

配置 Vanylo API

在 PowerShell 中设置（临时）：

$env:OPENAI_API_KEY="sk-你的令牌"
$env:OPENAI_BASE_URL="https://api.vanylo.top/v1"

持久化配置：

[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的令牌", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.vanylo.top/v1", "User")

前置条件

• Node.js 18+
• Git

安装 Codex

npm install -g @openai/codex

配置 Vanylo API

Zsh 用户：

echo 'export OPENAI_API_KEY="sk-你的令牌"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://api.vanylo.top/v1"' >> ~/.zshrc
source ~/.zshrc

前置条件

• Node.js 18+
• Git 2.23+

安装 Codex

npm install -g @openai/codex

配置 Vanylo API

echo 'export OPENAI_API_KEY="sk-你的令牌"' >> ~/.bashrc
echo 'export OPENAI_BASE_URL="https://api.vanylo.top/v1"' >> ~/.bashrc
source ~/.bashrc

前置条件

• Node.js 18+（安装方式参考 Claude Code Windows 安装）

安装 Gemini CLI

npm install -g @google/gemini-cli

配置 Vanylo API

在 PowerShell 中设置（临时）：

$env:GEMINI_API_KEY="sk-你的令牌"
$env:GEMINI_BASE_URL="https://api.vanylo.top"

持久化配置：

[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-你的令牌", "User")
[System.Environment]::SetEnvironmentVariable("GEMINI_BASE_URL", "https://api.vanylo.top", "User")

前置条件

• Node.js 18+

安装 Gemini CLI

npm install -g @google/gemini-cli

配置 Vanylo API

Zsh 用户：

echo 'export GEMINI_API_KEY="sk-你的令牌"' >> ~/.zshrc
echo 'export GEMINI_BASE_URL="https://api.vanylo.top"' >> ~/.zshrc
source ~/.zshrc

前置条件

• Node.js 18+

安装 Gemini CLI

npm install -g @google/gemini-cli

配置 Vanylo API

echo 'export GEMINI_API_KEY="sk-你的令牌"' >> ~/.bashrc
echo 'export GEMINI_BASE_URL="https://api.vanylo.top"' >> ~/.bashrc
source ~/.bashrc

安装扩展

启动方式

常用命令

基础命令

会话管理

高级选项

无法连接到服务

如果出现连接错误，请按以下步骤排查：

解决方案（Windows）

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

解决方案（macOS / Linux）

node -e "const f=require('os').homedir()+'/.claude.json';const j=JSON.parse(require('fs').readFileSync(f));j.hasCompletedOnboarding=true;require('fs').writeFileSync(f,JSON.stringify(j))"

令牌无效或余额不足

• 检查令牌是否正确复制（包含 sk- 前缀）
• 登录 api.vanylo.top 检查账户余额
• 确认令牌所选分组是否支持你使用的模型
• 检查令牌是否已过期或被禁用

响应速度慢

• 检查网络连接是否稳定
• 尝试切换到速度更快的模型（如 Gemini Flash、claude-haiku）
• 减少单次请求的上下文长度
• 避免在高峰时段进行大批量请求

推荐配置

建议在 Claude Code 的配置文件中添加以下环境变量，以获得更稳定的使用体验：

打开配置文件 settings.json（位于 ~/.claude/settings.json，Windows 路径为 %userprofile%\.claude\settings.json），在 env 中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.vanylo.top",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

常用模型推荐

计费方式

Vanylo API 采用按量计费模式，根据实际使用的 Token 数量收费，无月费、无最低消费。

什么是缓存？

缓存是一种优化机制，可以显著降低重复上下文的费用：

• 首次请求：发送内容时会创建缓存（有额外写入费用）
• 命中缓存：后续相似请求从缓存读取，价格极低
• 5 分钟缓存：适合频繁切换话题的场景
• 1 小时缓存：适合专注同一项目的长时间工作

什么是上下文长度？

上下文是模型在一次对话中能处理的内容总量：

• 200K tokens：约 10 万汉字，适合大型项目代码库
• 1M tokens：约 70 万汉字，适合超长文档或大型代码库
• Claude Code 会自动管理上下文，超出时会压缩历史记录