不少用户在后台询问如何安装 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 图标双击打开。
首次启动如果提示「未识别的开发者」，解决方案很简单：
- 先关掉警告窗口；
- 打开「系统设置」→「隐私与安全」；
- 找到 CC Switch 相关的提示，点击「仍然打开」；
- 之后就能正常启动了。
至此，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
