🎯 完整图文教程

Claude Code 中转 API 使用教程

通过 qxy.dlapi.xyz 中转站,快速配置 Claude Code,无需梯子,国内直连,支持 VIP 会员折扣

🏠

一、API 中转站点介绍

了解 qxy.dlapi.xyz 中转站的基本信息

🔥 VIP 热门

本教程基于 qxy.dlapi.xyz 中转站,它是一个基于 NewAPI 构建的 AI 模型 API 聚合与分发平台,支持 OpenAI、Claude、Gemini 等多种大模型接口的中转服务。

🌏
国内直连
无需梯子,开箱即用
🔄
格式兼容
OpenAI / Claude / Gemini
💰
VIP 折扣
单次充300,全部分组打折
高速稳定
低延迟,高可用性
💡
什么是 API 中转?
中转站帮你把请求转发到目标 API 服务器,适合没有原生 API 访问权限的用户使用,同时具备聚合多模型、统一调用格式的便利性。
⚠️
VIP 升级条件:单次充值满 300 余额,自动升级为 VIP 会员,所有分组全部享折扣,无需手动申请,永久生效!

站点基本信息

项目 内容
站点地址https://qxy.dlapi.xyz
API 格式OpenAI 兼容 / Claude 兼容 / Gemini 兼容
国内访问✅ 直连,无需代理
VIP 升级单次充值 ≥ 300 余额,自动升级
VIP 权益所有分组享折扣优惠
📊

二、额度用量查询

查看账户余额与用量统计

登录站点后,可在个人中心查看账户余额、用量明细以及各分组的调用统计。

查询方式

⚠️
注意事项:
  • 如遇输入输出响应缓慢,请尝试关闭梯子后重试。
  • 不同分组的倍率可能不同,请在分组列表中查看具体倍率信息。
  • 建议定期查看用量统计,避免余额耗尽影响使用。
⚙️

三、安装 Node.js 环境

Claude Code 依赖 Node.js 运行,Windows 详细安装指南

Windows

Claude Code 是基于 Node.js 的命令行工具,运行前需要先安装 Node.js 环境(建议版本 ≥ 18)。以下是 Windows 系统上的三种安装方式:

方式一:官网安装(推荐)

  1. 1
    下载 Node.js

    访问 https://nodejs.org/,下载 LTS(长期支持版),版本号需大于 18。

  2. 2
    运行安装程序

    双击下载的 .msi 安装文件,按安装向导逐步操作,建议保持默认安装路径。

  3. 3
    完成安装

    安装程序会自动配置 PATH 环境变量,无需手动设置。

方式二:Chocolatey 安装

如果你已安装 Chocolatey 包管理器(官网),在 PowerShell(管理员)中运行:

PowerShell
choco install nodejs

方式三:Scoop 安装

如果你已安装 Scoop(官网),在 PowerShell 中运行:

PowerShell
scoop install nodejs
💡
建议使用 PowerShell 而非 CMD,PowerShell 功能更强大,兼容性更好。如果遇到权限问题,请右键选择「以管理员身份运行」

验证安装

打开 PowerShell,执行以下命令确认安装成功:

PowerShell
node --version
npm --version

如果显示版本号(如 v18.x.x9.x.x),说明安装成功。

🚨
杀毒软件提示:部分杀毒软件可能将 npm 全局安装的包误报为威胁,请在安装时添加白名单或临时关闭杀毒软件。
🔧

四、环境变量配置

让 Claude Code 连接到中转站

Claude Code 默认连接官方 Anthropic API,需要手动配置两个环境变量,将其指向 qxy.dlapi.xyz 中转站。

⚠️
重要:配置环境变量后,需要重新打开 PowerShell(或重启终端)使变量生效。配置期间不要关闭当前终端。

需要配置的两个变量

变量名 说明
ANTHROPIC_BASE_URL https://qxy.dlapi.xyz/v1 API 请求地址(中转站)
ANTHROPIC_API_KEY 你的 API Key 个人密钥,登录站点获取

配置步骤(Windows)

  1. 1
    打开环境变量设置

    右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。

  2. 2
    新建系统变量

    在「系统变量」区域点击「新建」,分别创建上表中的两个变量。

  3. 3
    确认保存

    一路点击「确定」保存设置,然后重新打开 PowerShell

验证配置

在新打开的 PowerShell 中执行以下命令,确认变量已生效:

PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY
如果输出为 https://qxy.dlapi.xyz/v1 和你的 API Key,则配置成功!

如何获取 API Key?

  1. 1
    登录站点

    访问 https://qxy.dlapi.xyz,登录你的账号。

  2. 2
    进入 API Keys 页面

    点击顶部「个人中心」→「API Keys」。

  3. 3
    创建并复制 Key

    点击「创建 API Key」,复制生成的密钥(不支持查看完整 Key,请首次复制时妥善保存)。

💡
提示:你可以创建多个 API Key 管理不同的用途。如果某个 Key 泄露或丢失,直接删除该 Key 并重新创建一个即可。
📦

五、安装 Claude Code

通过 npm 全局安装 Claude Code

Claude Code 是 Anthropic 官方提供的命令行工具,用于在终端中与 Claude 进行 AI 对话协作。安装前请确保已完成 Node.js 安装和环境变量配置。

安装命令

PowerShell
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
💡
这里使用了国内镜像源 registry.npmmirror.com,可以大幅提升下载速度。如果不用镜像,直接运行 npm install -g @anthropic-ai/claude-code 即可(需要梯子)。

安装提示

验证安装

PowerShell
claude-code --version

如果显示版本号(如 @anthropic-ai/claude-code x.x.x),说明安装成功。

⚠️
权限问题:如果遇到 EACCES 权限错误,请以管理员身份运行 PowerShell,或者修复 npm 权限,参考:官方文档
🚀

六、使用 Claude Code

启动 Claude Code 并开始 AI 协作

完成以上所有配置后,现在可以启动 Claude Code 了。它会自动读取环境变量,连接到 qxy.dlapi.xyz 中转站。

启动命令

PowerShell
claude-code

首次使用流程

  1. 1
    运行命令

    在 PowerShell 中输入 claude-code 并回车,首次运行会显示 Claude Code 的使用协议和简介。

  2. 2
    输入你的请求

    直接在终端中输入你想让 Claude 完成的任务,比如:"帮我写一个 Python 脚本自动备份文件"。

  3. 3
    Claude 协作完成

    Claude 会根据你的需求创建文件、编写代码、执行命令,你可以在终端中查看进度并与它交互。

完成!享受使用 Claude Code 通过 qxy.dlapi.xyz 中转站进行 AI 协作的体验吧!如有问题,参考下面的常见问题。
🤖

七、VSCode Claude 插件教程

在 VSCode 中使用 Claude 无需 CLI

在 VSCode 中安装 Claude 官方插件,再配合 CC Switch 集中配置 API 地址和 Key,无需手动填写配置,重启 VSCode 即可使用。适合习惯图形界面开发的用户。

前提条件

操作步骤

  1. 在 VSCode 中安装 Claude 插件
    打开 VSCode,按 Ctrl+Shift+X 打开扩展市场,搜索 Claude,找到由 Anthropic 官方提供的 Claude Official 插件,点击安装
  2. 在 CC Switch 中配置 API
    打开 CC Switch,在设置页面填入以下信息:
    • API 地址:https://qxy.dlapi.xyz
    • API Key:你的 API Key(形如 sk-xxxx...
    • 默认分组:选择要使用的分组
  3. 重启 VSCode
    配置完成后,完全退出 VSCode(确保 CC Switch 保持运行),重新启动 VSCode。
  4. 开始使用
    VSCode 重启后,点击左侧的 Claude 图标,打开侧边栏即可与 Claude 对话。所有请求会自动经过 CC Switch 路由到指定分组。

VSCode Claude 插件功能一览

功能说明
🤖 实时对话在侧边栏与 Claude 连续对话,支持代码块高亮渲染
📝 代码生成选中代码片段,让 Claude 解释、改写或优化
🔍 代码审查让 Claude 审查选中代码的问题和优化建议
📄 文件问答直接询问当前打开文件的相关问题
🔧 多模型切换在 CC Switch 中切换分组即可改变使用的模型
⚠️
注意:VSCode 插件本身不保存 API 配置,所有配置由 CC Switch 统一管理。如果 CC Switch 未运行或配置有误,插件将无法连接。
💡
提示:VSCode 插件默认使用 claude-3-5-sonnet 模型,速度快且成本低。在 CC Switch 中切换到其他分组即可使用不同的模型。
🔀

八、CC Switch 教程

Claude Code 可视化分组路由工具

CC Switch 是一个基于 Claude Code 的可视化分组路由桌面工具,可以在多个 API 分组之间一键切换、监控用量、设置默认分组。支持分组隔离、重试机制、流量控制等功能,适合多分组管理和高可用场景。

下载地址

软件在群文件中提供下载,加入用户群后即可获取安装包(Windows 版为 .exe 安装程序)。

界面功能一览

启动 CC Switch 后,界面分为以下几个区域:

区域功能说明
🔝 顶栏(Header)显示当前 Claude Code 的运行状态、API 连接状态
📂 分组列表(Group List)左侧显示所有可用的 API 分组,点击即可一键切换当前分组
⚙️ 设置(Settings)配置 API 地址、API Key、默认分组、超时时间等
📊 用量监控(Usage)显示各分组的调用量、Token 消耗、余额预警
🛡️ 分组隔离(Group Isolation)开启后指定分组只允许特定请求访问,防止跨组污染

使用步骤

  1. 下载并安装
    在群文件中下载 CC Switch 安装包,双击运行完成安装。
  2. 首次配置
    启动 CC Switch 后,在设置页面填入以下信息:
    • API 地址:https://qxy.dlapi.xyz
    • API Key:你的 API Key(从站点控制台获取)
    • 默认分组:选择要默认使用的分组
  3. 启动 Claude Code
    配置完成后,点击主界面的"启动 Claude Code"按钮,CC Switch 会自动将 Claude Code 的请求路由到当前选中的分组。
  4. 切换分组
    在分组列表中点击目标分组,Claude Code 会立即切换路由,无需重启。

CC Switch 设置项说明

设置项说明推荐值
API 地址中转站的 base URLhttps://qxy.dlapi.xyz
API Key你的个人 API Keysk-xxxx...
默认分组启动时默认使用的分组选一个负载低的分组
超时时间单次请求最大等待时间(毫秒)60000(60秒)
自动重试请求失败是否自动切换分组重试建议开启
分组隔离防止请求串组高并发时建议开启

注意事项

💡
适用场景:当某个分组响应慢或负载过高时,无需修改 Claude Code 配置,直接在 CC Switch 中切换分组即可改善体验。

九、常见问题

FAQ - 遇到问题先看这里

Q: 提示 API Key 无效怎么办?
+
请检查以下几点:① 环境变量 ANTHROPIC_API_KEY 是否正确设置(注意不要有多余空格);② 是否重新打开了 PowerShell(环境变量需要新窗口才能生效);③ API Key 是否在站点内有效(可登录站点在 API Keys 页面查看)。如果 Key 已过期或被删除,请重新创建一个。
Q: 调用速度很慢怎么办?
+
尝试以下方法:① 关闭梯子后再试,国内直连通常更快;② 检查当前分组的负载情况,可以尝试切换至其他分组;③ 查看是否当前用量较大,余额不足也可能影响响应速度。
Q: 如何升级 VIP?
+
qxy.dlapi.xyz 进行充值,单次充值金额达到 300 余额,系统自动将账户升级为 VIP,无需额外申请。VIP 生效后,所有分组均享折扣优惠。
Q: npm 安装失败怎么解决?
+
常见解决方案:① 确认 Node.js 已正确安装(运行 node --version 验证);② 建议以管理员身份运行 PowerShell;③ 尝试使用国内镜像:npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com;④ 检查杀毒软件是否拦截了 npm。
Q: 环境变量配置在哪?
+
Windows 系统:右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。需要创建两个系统变量:ANTHROPIC_BASE_URL(值为 https://qxy.dlapi.xyz/v1)和 ANTHROPIC_API_KEY(值为你的 API Key)。
Q: 可以同时使用多个 API Key 吗?
+
可以的。你可以在站点内创建多个 API Key,通过修改 ANTHROPIC_API_KEY 环境变量的值来切换使用不同的 Key。每个 Key 是独立计费的。
💻

十、代码调用示例

不使用 Claude Code,也可直接通过 API 调用

如果你不需要 Claude Code 的交互式协作,也可以直接通过 API 调用来使用 Claude 模型。以下是几种常用语言的调用示例:

cURL 调用

Bash
curl https://qxy.dlapi.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {"role": "user", "content": "你好,介绍你自己"}
    ]
  }'

Python(OpenAI SDK)

Python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://qxy.dlapi.xyz/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[
        {"role": "user", "content": "你好,介绍你自己"}
    ]
)

print(response.choices[0].message.content)

Python(requests)

Python
import requests

url = "https://qxy.dlapi.xyz/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "model": "claude-sonnet-4-20250514",
    "messages": [
        {"role": "user", "content": "你好,介绍你自己"}
    ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

JavaScript / Node.js

JavaScript
const axios = require('axios');

async function callAPI() {
  const response = await axios.post('https://qxy.dlapi.xyz/v1/chat/completions', {
    model: 'claude-sonnet-4-20250514',
    messages: [
      { role: 'user', content: '你好,介绍你自己' }
    ]
  }, {
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });
  
  console.log(response.data.choices[0].message.content);
}

callAPI();
💡
model 参数说明:请根据 qxy.dlapi.xyz 站点内实际提供的模型名称填写,常见的 Claude 模型名如 claude-sonnet-4-20250514claude-opus-4-20250514 等,以站点分组列表中的模型 ID 为准。