目录

1.Claude Code 是什么
2.前置依赖安装
3.安装 Claude Code
4.登录认证
5.CC Switch 安装教程
6.在 VS Code 中使用
7.常见问题
8.总结清单

一、Claude Code 是什么？

Claude Code 是 Anthropic 官方推出的 AI 编程助手，运行在终端里，可读取本地代码库、协助编写代码、修复 Bug、执行测试。使用需绑定 Claude 付费订阅账号，或接入 DeepSeek 等第三方 API。

二、前置依赖安装

Claude Code 运行必备依赖：Node.js、Git。

2.1 安装 Node.js（必装）

版本要求：Node.js ≥ 18

系统	安装方法
Mac	打开终端执行：brew install node（需提前安装 Homebrew）
Windows	访问 https://nodejs.org/zh-cn/download 下载 LTS 版，双击安装包默认下一步安装

安装校验：终端 / 命令提示符输入 node \-v，输出版本号即为成功。

Mac 额外步骤：安装 Homebrew

未安装 Homebrew 的 Mac，终端粘贴执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成执行 brew \-\-version 校验。

2.2 安装 Git（必装）

系统	安装方法
Mac	终端执行 brew install git，或执行 xcode\-select \-\-install 安装命令行工具
Windows	访问 https://git-scm.com/download/win 下载安装包，默认配置安装，建议安装至 C 盘

Windows 注意：Claude Code 优先调用 Git Bash，无 Git 则降级使用 PowerShell，体验会下降，务必安装 Git。

安装校验：终端输入 git \-\-version 即可验证。

三、安装 Claude Code

3.1 macOS 安装

方式一（推荐终端安装）：

curl -fsSL https://claude.ai/install.sh | bash

安装后自动后台更新。

方式二（Homebrew 可选）：

brew install --cask claude-code

Homebrew 版本不自动更新，需手动执行 brew upgrade claude\-code 升级。

3.2 Windows 安装

方法一：PowerShell（推荐）

Win+R 输入 powershell 回车，执行：

irm https://claude.ai/install.ps1 | iex

方法二：CMD 命令提示符

Win+R 输入 cmd 回车，执行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方法三：WinGet

winget install Anthropic.ClaudeCode

终端区分提示

• 提示符带 PS C:\\ = PowerShell

• 提示符仅 C:\\ 无 PS = CMD

• 报错 \&\& 无效语句 说明在 PowerShell，改用方法一

• 报错 irm 不是内部命令 说明在 CMD，改用方法二

3.3 验证安装

终端执行：

claude --version

正常输出版本号即安装成功；异常可执行 claude doctor 做全局检测修复。

四、登录认证

安装完成后终端直接输入：

claude

首次运行自动唤起浏览器跳转登录。
注意：免费 [Claude.ai](Claude.ai) 账号不支持 Claude Code，必须开通 Pro / Max / 团队 / 企业付费订阅。
国内无法直连官方服务，可看下一节 CC Switch 接入第三方模型。

五、CC Switch 安装教程（接入 DeepSeek 等第三方模型）

5.1 CC Switch 是什么？

CC Switch 是可视化管理工具，无需手动改配置文件，可一键将 Claude Code 底层模型切换为 DeepSeek、智谱 GLM 等国产大模型。
官网：https://github.com/farion1231/cc-switch

5.2 下载 CC Switch

1. 打开 GitHub 仓库：https://github.com/farion1231/cc-switch

2. 点击右侧 Releases

3. 根据系统下载对应安装包：

   • Mac：下载 \.dmg 镜像文件

   • Windows：下载 \.exe 安装程序

4. 双击安装包默认流程安装

5.3 获取 DeepSeek API Key

1. 打开 DeepSeek 开放平台：https://platform.deepseek.com

2. 注册并登录账号

3. 进入「API Keys」页面，新建密钥

4. 复制密钥（格式：sk\-xxxxxxxxxxxxxxxx）

提示：DeepSeek API 按量计费，新用户通常赠送免费额度，定价低廉。

5.4 在 CC Switch 中配置 DeepSeek

1. 打开 CC Switch

2. 点击右上角「+」添加模型供应商

3. 供应商选择 DeepSeek，也可选择 Other 手动填写接口

4. 粘贴复制好的 API Key

5. 主模型选择：deepseek\-chat（DeepSeek V3）或 deepseek\-reasoner（R1 推理模型）

6. Haiku / Sonnet / Opus 四个槽位统一填写同款模型名

7. 点击「+ 添加」保存配置

5.5 启动使用

配置完成后，终端执行：

claude

自动通过 CC Switch 配置的 DeepSeek API 运行。

六、在 VS Code 中使用（可选）

1. 打开 VS Code

2. 快捷键：Mac Cmd\+Shift\+X / Windows Ctrl\+Shift\+X 进入插件市场

3. 搜索「Claude Code」，安装官方 Anthropic Claude Code 插件

4. 安装后按 Cmd\+Shift\+P / Ctrl\+Shift\+P，输入 Claude Code，选择 Open in New Tab 即可使用

七、常见问题

问题	解决方案
command not found: claude	重启终端；Mac 检查 Node 环境变量是否加入 PATH
node: command not found	Node.js 未安装或未配置环境变量，重新安装配置
Windows 安装报权限错误	以管理员身份运行 CMD / PowerShell
国内下载安装速度慢	开启网络代理，或切换国内镜像源
claude doctor 报错	按提示逐项修复，多为 Git 路径未识别问题
CC Switch 连接失败	核对 API Key 是否正确、网络代理是否通畅

八、总结清单

必备安装清单

序号	名称	下载 / 安装地址
1	Node.js (≥18)	https://nodejs.org/zh-cn/download
2	Git	Windows：https://git-scm.com/download/win Mac：brew install git
3	Claude Code	执行本文第三节对应系统安装命令
4	CC Switch（可选）	https://github.com/farion1231/cc-switch
5	DeepSeek API Key（可选）	https://platform.deepseek.com

完整流程

安装 Node.js → 安装 Git → 安装 Claude Code → 安装 CC Switch → 配置 API Key → 终端启动使用

参考来源

Anthropic 官方文档：https://code.claude.com/docs/en/setup
CC Switch GitHub：https://github.com/farion1231/cc-switch
DeepSeek 开放平台：https://platform.deepseek.com