Claude CLI与VSCode插件：cc-switch第三方中转

配置 Claude CLI 与 VSCode 插件（兼容 Trae/Cursor）——通过 cc-switch 对接第三方 API 中转

开始前先理清脉络：下面六步均经过实测排雷。直接进入正题。

1. 安装 Claude CLI

• 官方文档参见：Claude Code overview - Claude Code Docs
• 前置要求：确认已安装 Git，且终端能正常执行 git --version 获取版本号。

1. Windows 环境：

   • PowerShell（推荐，避免使用 CMD）执行：
     irm https://claude.ai/install.ps1 | iex
   • 若坚持用 CMD，运行：
     curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2. macOS、Linux 或 WSL 用户：
   curl -fsSL https://claude.ai/install.sh | bash

3. 安装完成后输入 claude --version，看到版本号即成功。

4. 跳过默认的 Anthropic 账户登录——此步骤为关键：新版本首次启动时登录页可能卡死，需手动绕过。找到 ~/.claude.json（Windows 路径 C:\Users\你的用户名\.claude.json；macOS/Linux/WSL 路径 /你的用户名/.claude.json）。若文件不存在则新建。添加一行配置："hasCompletedOnboarding": true，保存即可。

2. 安装 VSCode 系 Claude 插件（兼容 Trae/Cursor）

1. 按下 Ctrl+Shift+X（Mac 用 Cmd+Shift+X）或点击侧栏扩展图标，进入扩展面板。
2. 搜索 “Claude”，找到官方插件并安装。若已安装则显示已启用。
3. 关闭登录弹窗：按下 Ctrl+,（Mac 下 Cmd+,）打开设置，搜索 Claude code login，勾选 Disable login prompt。

至此，插件配置完成，每次启动不再要求登录。

3. 下载 cc-switch

cc-switch 是专为 Claude CLI、Code X、opencode 及 Gemini CLI 设计的 API 配置管理工具，支持灵活切换多个中转站或直连端点，无需反复修改环境变量。

下载地址：Releases · farion1231/cc-switch。找到对应系统的最新版，下载安装。

4. 中转站准备

以“哈基米中转站”为例——支持 QQ 邮箱注册，每日签到赠送 50 额度，注册即送 500 额度。若注册时邮箱注册不可用，刷新页面即可解决。

1. 登录后进入控制台，点击“新增令牌”。
2. 名称可任意，过期时间选择“永不过期”，额度设“无限额度”。生成后务必复制并妥善保存 API Key。
3. 每日签到入口在“个人设置 - 每日签到”。

获取 API Key 后，下一步配置 cc-switch。

5. 在 cc-switch 中配置中转站地址

1. 启动 cc-switch，点击右上角“新增”按钮。
2. 输入中转站提供的 API 端点地址以及刚才复制的 API Key。其余参数保持默认。
3. 添加后点击“启用”激活该配置。
4. 若需在 VSCode 插件中使用，进入 cc-switch 的“设置→通用”，勾选“应用到 Claude Code 插件”选项。

6. 测试

1. 任意文件夹终端输入 claude，确认能否正常启动对话。
2. 发送一条消息，检查返回内容是否正常。
3. 打开 VSCode，在文件夹中按 Ctrl+Shift+P 执行 “Claude: Start”，或点击侧栏 Claude 插件图标。启动后发送测试消息，确认插件端通信正常。

至此整套配置流程完成。后续如需更换中转站，只需在 cc-switch 中新增并切换，无需重复安装或修改环境变量，简洁高效。