安装Claude CLI及VSCode插件并用cc-switch配置中转

时间：2026-06-22 15:07

安装ClaudeCLI与VSCode系Claude插件，通过cc-switch配置第三方中转站。需先完成CLI安装并跳过登录，禁用插件登录提示。下载cc-switch，在中转站注册获取APIKey，于cc-switch中新增中转站地址和Key并启用。最后在终端和VSCode中测试对话功能，验证通信正常。

手把手配置 Claude CLI 与 VSCode 插件：通过 cc-switch 对接第三方中转 API 服务

在开始前，请务必按照以下六个步骤顺序操作，每一步都是实践验证后的可靠流程，能有效避免常见的配置错误和登录失败问题。

1. 安装 Claude CLI 命令行工具

官方参考文档：Claude Code overview - Claude Code Docs
环境准备：请确保你的系统已经安装了 Git，并可在终端中通过执行 git --version 命令正常显示版本信息。

Windows 操作系统用户：
- 推荐使用 PowerShell（执行效率更高，兼容性更好）：
  irm https://claude.ai/install.ps1 | iex
- 如果仍需使用传统 CMD，请执行：
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
macOS、Linux 或适用于 Linux 的 Windows 子系统 (WSL) 用户：
curl -fsSL https://claude.ai/install.sh | bash
安装完成后，请务必进行验证：在终端输入 claude --version，若能正确显示 Claude CLI 版本号，则表明基础安装成功。
关键步骤：绕过 Anthropic 官方账户登录引导 —— 这是近期版本更新后出现的常见问题，官方登录页面时常无法正常跳转，需通过手动修改配置文件解决：
- 定位配置文件 ~/.claude.json（Windows 路径通常为 C:\Users\你的用户名\.claude.json；macOS/Linux/WSL 路径则为 /你的用户名/.claude.json）。若文件不存在，请手动创建一个。
- 在文件中添加关键配置项："hasCompletedOnboarding": true，保存并关闭文件。

2. 安装并配置 VSCode 系列编辑器 Claude 插件

此步骤适用于 Visual Studio Code 及其衍生版本（如 Trae、Cursor 等）。

打开编辑器的扩展管理面板（快捷键 Ctrl+Shift+X 或点击左侧活动栏的扩展图标）。
在搜索框中输入 “Claude” —— 找到由 Anthropic 官方发布的 Claude Code 插件，点击安装。若已安装，请确保其为启用状态。
关闭插件的自动登录提示（避免每次启动编辑器都弹出官方账号登录窗口）：
- 按下 Ctrl+,（Mac 用户为 Cmd+,）打开编辑器设置。
- 在设置搜索框内输入 Claude code login。
- 找到并勾选 Disable login prompt（禁用登录提示）选项。

完成此步后，插件将不再弹出干扰性的登录对话框，为后续配置第三方服务扫清障碍。

3. 获取与安装 cc-switch 配置管理工具

cc-switch 是一款功能强大的 API 配置管理工具，专为 Claude CLI、Code X、Opencode 及 Gemini CLI 等工具设计。其核心作用是让用户能够轻松管理和切换不同的 API 中转站或直连端点，无需繁琐地反复修改系统环境变量。

下载渠道：访问 Releases · farion1231/cc-switch。根据你的操作系统（Windows、macOS 或 Linux），下载并安装最新版本的发布文件。

4. 获取第三方中转站 API 密钥

本文以“哈基米中转站”为例进行说明。该平台支持使用 QQ 邮箱进行注册，新用户注册即赠送 500 额度，且每日签到可额外获得 50 额度。若注册时发现邮箱注册选项暂时不可用，简单刷新页面通常即可解决。

完成注册并登录后，进入用户控制台，点击“新增令牌”或类似功能按钮。
令牌名称可自定义，过期时间建议选择“永不过期”，额度限制选择“无限额度”（如提供）。生成后，请立即复制并妥善保存生成的 API Key。
每日签到功能一般位于“个人中心”或“账户设置”下的“每日签到”页面，定期领取可有效积累使用额度。

成功获取 API Key 后，即可将其配置到 cc-switch 工具中。

5. 在 cc-switch 中配置中转站信息

运行 cc-switch 应用程序，点击界面右上角的“新增”或“Add”按钮。
在弹出的表单中，准确填入中转站提供的 API 端点地址（Base URL）以及上一步复制的 API 密钥（API Key）。其余参数如模型名称等，可暂时保持默认值。
信息添加完毕后，找到该条配置，点击“启用”或“Activate”按钮，使其成为当前活动配置。
如需在 VSCode 插件中使用此配置，还需进入 cc-switch 的“设置”或“Preferences”菜单，在“通用”选项下，找到并勾选“应用到 Claude Code 插件”或类似功能的复选框。这一步是实现编辑器插件联动的关键。

6. 完整功能测试验证

测试 CLI：打开终端（命令行），进入任意目录，输入 claude 命令启动对话界面，观察是否能成功初始化并出现提示符。
测试通信：在 CLI 对话界面中输入一条测试消息（如“你好”），检查是否能正常接收到来自 Claude 模型的回复内容。
测试插件：启动 VSCode 或 Cursor 等编辑器，在项目文件夹中按下 Ctrl+Shift+P 打开命令面板，运行 “Claude: Start” 命令，或直接点击侧边栏的 Claude 插件图标。启动插件后，同样发送一条测试消息，确认编辑器插件也能通过中转站与 AI 模型正常通信。

完成以上所有测试后，表明整个 Claude CLI 与 VSCode 插件的第三方中转配置已全部成功。今后若需要更换其他中转服务商，只需在 cc-switch 中添加新的配置并切换即可，无需重装任何软件或改动复杂设置，实现了高度灵活与便捷的配置管理。

来源：https://juejin.cn/post/7615250753898905663

第三方