Claude code与CC-switch安装使用

CC-Switch 安装与使用

Windows 安装

前往 GitHub Releases 下载 .exe 安装包或 .zip 便携版。运行安装包或解压后双击启动。若遇 SmartScreen 警告，选择"更多信息"→"仍要运行"。

macOS 安装

通过 Homebrew 安装：

brew tap farion1231/ccswitch
brew install --cask cc-switch

首次打开时若提示"无法验证开发者"，需在系统设置的"隐私与安全性"中手动允许。

Linux 安装

下载 .deb 包并安装：

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_3.10.x_amd64.deb
sudo dpkg -i cc-switch_3.10.x_amd64.deb

添加 API 供应商

点击界面右上角 +，选择预设（如 OpenAI、MiniMax）或自定义配置，填写名称、API Base URL 和 API Key 后保存。

切换与启用

在供应商列表中选中目标，点击"启用"，并打开"应用到 Claude Code 插件"选项。需重启终端或相关 IDE 插件生效。

设为默认供应商

选中常用供应商后点击"设为默认"，后续请求将自动使用该配置。

---

Claude Code 安装与使用

安装 Node.js

从 Node.js 官方网站下载最新 LTS 版本安装包，运行安装程序并遵循默认配置。安装完成后打开命令提示符，输入 node -v 和 npm -v 验证版本信息。建议勾选安装程序中的 "Automatically install the necessary tools" 选项以便自动配置环境变量。

安装 Git Bash

访问 Git 官网下载 Windows 版本安装程序，安装过程中注意勾选 "Use Git and optional Unix tools from the Command Prompt" 选项。这将允许在系统任何路径调用 Git 命令。安装完成后通过右键菜单选择 "Git Bash Here" 测试功能是否正常。

配置 Claude

完成基础环境配置后，通过 npm 安装 Claude 相关依赖包。在项目目录打开 Git Bash 终端，执行 npm install @anthropic-ai/claude 命令。创建配置文件 .env 并添加 API 密钥等认证信息。测试阶段可先使用官方提供的示例代码验证连接状态。

环境变量设置

将 Node.js 和 Git 的可执行路径添加到系统环境变量。在 Windows 搜索栏输入 "环境变量"，编辑系统变量 Path，添加类似 C:\Program Files\nodejs 和 C:\Program Files\Git\cmd 的路径。这确保所有命令行工具都能识别相关命令。

验证安装

新建测试脚本文件 claude_test.js，写入基础交互代码。在 Git Bash 中运行 node claude_test.js 查看输出结果。遇到权限问题时，可能需要以管理员身份运行终端或调整 Windows 防火墙设置。

官方脚本安装（推荐）

macOS/Linux 运行：

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 验证。

登录与认证

运行 claude auth login，选择 Claude.ai 账号授权或直接输入 API Key。

基本命令

启动交互式会话：claude

查看帮助文档：claude help

更新工具：claude update

结合 CC-Switch 使用

在 CC-Switch 中配置 API 并启用"应用到 Claude Code 插件"，运行 claude 命令时流量自动代理。

---

常见问题

地区限制解决方案

通过 CC-Switch 配置合规的第三方 API 中转服务，绕过官方地域限制。

macOS 权限问题

右键应用选择"打开"，或在系统设置→隐私与安全性中手动放行。

Windows 权限不足

以管理员身份运行安装包或终端，确保有足够权限修改系统配置。