10分钟安装ClaudeCode与CCSwitch随心切换国产模型

不少用户在后台询问如何安装 Claude Code，以及安装后怎样对接国产模型。本文将完整梳理整个流程，确保每一步都清晰明了。如果你想涉足 AI 编程领域，这可以说是入门的关键门槛，跨过之后，主流工具链就基本畅通了。

Claude 安装

首先，请确保已安装 VSCode，这是运行 Claude Code 的基础环境。打开 VSCode 后，在左上角点击「终端」→「新建终端」，进入命令行界面。

在 VSCode 终端里安装 Claude Code（左上角「终端」→「新建终端」）。

Linux / macOS 安装：

# 全局安装 Claude Code
sudo npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

Windows 安装：

# 以管理员身份打开 PowerShell 或命令提示符
# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

安装完成后，在终端中直接输入 claude 命令即可启动程序。随后安装必要的插件，Claude Code 的运行环境就配置就绪了。

准备工作（可跳过）

建议先检查系统中是否已安装 Node.js 和 Git。如果之前已经配置过，可以直接跳过此步骤。

Windows 安装命令（PowerShell 上装）

# 安装 Node.js
winget install OpenJS.NodeJS
# 安装 Git
winget install Git.Git
# 验证安装
node --version
npm --version
git --version

macOS 安装命令（终端上装）

# 安装 Node.js
brew install node
# 安装 Git
brew install git
# 验证安装
node --version
npm --version
git --version

安装 cc-switch

Windows

最新 v3.10.3 便携版（在 PowerShell 执行下面的命令）：

# 1. 下载
Invoke-WebRequest -Uri "https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows-Portable.zip" -OutFile "$env:USERPROFILE\Downloads\CC-Switch-Portable.zip"
# 2. 解压到桌面
Expand-Archive -Path "$env:USERPROFILE\Downloads\CC-Switch-Portable.zip" -DestinationPath "$env:USERPROFILE\Desktop\CC-Switch"
# 3. 启动程序
Start-Process "$env:USERPROFILE\Desktop\CC-Switch\CC Switch.exe"

macOS

# 添加 cc-switch 的 brew 源
brew tap farion1231/ccswitch
# 安装 cc-switch（cask 是桌面应用安装方式）
brew install --cask cc-switch

启动 cc-switch

安装完成后，在终端输入 cc-switch，或者直接去「应用程序」文件夹里找到 CC Switch 图标双击打开。

首次启动如果提示「未识别的开发者」，解决方案很简单：

1. 先关掉警告窗口；
2. 打开「系统设置」→「隐私与安全」；
3. 找到 CC Switch 相关的提示，点击「仍然打开」；
4. 之后就能正常启动了。

至此，cc-switch 就安装完毕。

cc-switch 核心使用流程

添加提供商

启动 CC Switch 后，点击 + 添加提供商。可以用预设，也可以自己创建自定义配置。

切换提供商

选中你要用的提供商，点击「启用」。打开三个开关。更快捷的做法：直接点击提供商名称，立即生效。

要配置完全生效，请重启终端 / Claude Code / Codex / Gemini 客户端，配置会自动加载。

关键功能

• MCP 管理：点击右上角「MCP」，可以添加 / 管理 MCP 服务器，支持 stdio / http / sse 协议。
• 技能管理：点击「Skills」，一键安装 / 卸载 Claude 技能（自动同步到 ~/.claude/skills/）。
• 提示管理：点击「Prompts」，创建 / 切换系统提示预设（同步到 ~/.claude/CLAUDE.md 等文件）。

后续更新

需要更新到最新版本的话，在终端跑这条命令：

brew upgrade --cask cc-switch