中山大学岭南学院 · 金融AI智能体设计与应用装机手册 · 2026-09
第 1 次课 · 装机手册

Claude Code 接入 DeepSeek

八个步骤 ｜ Windows 与 Mac 分别列出 ｜ 命令点「复制」后粘贴到终端执行 ｜ 全部装完约 20 分钟

准备

本手册只给出一条经过核对的安装路径。整个过程约 20 分钟，需要联网。

装什么作用
Node.js运行 Claude Code 所需的环境
Git为 Claude Code 提供命令行工具，也用于给文件存档。Mac 随命令行开发者工具一起装
Claude Code在终端里读写文件、运行命令的智能体
DeepSeek API 密钥Claude Code 背后使用的模型，按用量付费
CC Switch把 DeepSeek 的地址、密钥与模型名写入 Claude Code 的配置
VS Code 与 Claude Code 插件查看文件，开会话面板或终端
API 密钥与账户余额直接相关。不截图、不外发、不写入要提交的文件。

八个步骤

01打开 PowerShell，放开脚本限制

开始菜单搜索 PowerShell，打开不带 x86 字样的那一个，执行下面的命令，提示时输入 Y 回车。

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

02安装 Node.js

下载安装包，双击安装，全部保持默认，保留「Add to PATH」勾选。

https://cdn.npmmirror.com/binaries/node/v24.20.0/node-v24.20.0-x64.msi

装完关闭并重新打开 PowerShell，执行：

node -v
显示 v24.20.0 即完成。

03安装 Git

下载安装包，双击安装，所有页面直接点「Next」，保持默认选项。

https://cdn.npmmirror.com/binaries/git-for-windows/v2.55.0.windows.5/Git-2.55.0.5-64-bit.exe
git --version
显示 git version 2.55 即完成。

04安装 Claude Code

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code --allow-scripts=@anthropic-ai/claude-code

末尾的 --allow-scripts 不能省。npm 12 起默认不运行安装包自带的安装脚本，少了它安装不报错，claude 却运行不了。

claude --version
显示一串版本号和 (Claude Code) 即完成。先不要启动 claude，配置好 DeepSeek 再启动。

01打开终端

按 Command + 空格，输入 终端 回车。

02安装 Node.js，并设置 npm 全局目录

下载安装包，双击安装，全部保持默认。

https://cdn.npmmirror.com/binaries/node/v24.20.0/node-v24.20.0.pkg

装完关闭并重新打开终端，执行下面四行，把 npm 的全局安装目录放到你自己的用户目录下，避免权限错误：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile
node -v
显示 v24.20.0 即完成。

03安装命令行开发者工具（含 Git）

Mac 自带的 git 只是个占位，要先装苹果的命令行开发者工具。执行下面的命令，弹窗里点安装（不要点「获取 Xcode」），同意协议，等 5 到 20 分钟。提示已经安装过，就直接往下。

xcode-select --install
git --version
显示 git version 加一串版本号即完成，没有再弹安装窗口。

04安装 Claude Code

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code --allow-scripts=@anthropic-ai/claude-code

末尾的 --allow-scripts 不能省。npm 12 起默认不运行安装包自带的安装脚本，少了它安装不报错，claude 却运行不了。出现 EACCES 权限错误，说明第 2 步的四行没执行，回去补上，不要加 sudo。

claude --version
显示一串版本号和 (Claude Code) 即完成。先不要启动 claude，配置好 DeepSeek 再启动。

05获取 DeepSeek API 密钥

  1. 打开 platform.deepseek.com，用手机号注册并登录，按页面提示完成实名认证
  2. 在控制台充值页小额充值，够一次课使用即可
  3. 先打开记事本，再进入 API keys 页面，点「创建 API key」
  4. 密钥只显示一次，立即复制到记事本保存
得到一串以 sk- 开头的密钥即完成。

06安装 CC Switch

CC Switch 是免费开源的工具，官网有中文说明、文档与更新日志。安装包在它的 GitHub 发布页下载最新版，2026-09-16 核对时为 v3.20.3。Windows 下载文件名以 -Windows.msi 结尾的安装包；Mac 下载 -macOS.dmg，打开后拖入「应用程序」。

https://ccswitch.io/zh/
https://github.com/farion1231/cc-switch/releases/latest
GitHub 打不开或下载很慢，就用备用下载。同一份 v3.20.3 安装包已放进本材料包，直接点 Windows 版 msi，13 MB 或 Mac 版 dmg，27 MB。
能打开 CC Switch 窗口即完成。只从官网 ccswitch.io、GitHub 发布页或本材料包的备用下载取安装包，任何要求付费的都不是官方版本。

07在 CC Switch 中配置 DeepSeek

见下一节。

08安装 VS Code 与 Claude Code 插件

从官网下载安装 VS Code。打开后选「文件 → 打开文件夹」，选择练习文件夹，再选「终端 → 新建终端」，下面的验收三条在这个终端里跑。

https://code.visualstudio.com/

再点左侧最下方的扩展图标（四个方块），搜 Claude Code，作者是 Anthropic，点安装。装好后左侧多出一个图标，点开就是会话面板，也可以按 Ctrl + Esc（Mac 为 ⌘ + Esc）调出来。课上主要用这个面板操作，终端作为备用。

终端面板出现、路径停在练习文件夹，左侧出现 Claude Code 图标，即完成。

在 CC Switch 中配置 DeepSeek

  1. 打开 CC Switch，顶部选择 Claude Code
  2. 点「添加供应商」，在预设中选择 DeepSeek
  3. 按下表核对并修改字段，模型名必须改
  4. 保存后点该供应商的启用
  5. 在设置中打开跳过 Claude Code 初次安装确认，启动时不会要求登录
字段填写说明
请求地址https://api.deepseek.com/anthropic预设已填好，核对即可
API Key第 5 步保存的 sk-…粘贴
模型映射 · 各行的「实际请求模型」deepseek-flash，右侧 1M 打勾预设默认是 deepseek-v4-pro，课程统一改用 deepseek-flash（便宜，能看图）。Sonnet 一行填好、勾上 1M 后点「一键设置」，其余各行自动填好
模型映射 · Haiku 一行deepseek-flash
默认兜底模型deepseek-flash，右侧 1M 打勾一键设置不管这一栏，要单独填
不要在输入框里手打 [1m]。CC Switch 会把手打的后缀自动去掉，要靠右侧的 1M 勾选框开启 100 万上下文。Haiku 一行没有这个勾选框，属正常。

CC Switch 做的事情，是把上面这些值写入 ~/.claude/settings.json，勾了 1M 的一栏写进去是 deepseek-flash[1M]。Claude Code 每次启动时读取这份配置，决定把请求发给谁。

界面与字段名称以 CC Switch 官方文档为准：ccswitch.io/zh/docs；版本变化见更新日志。

验收

#操作通过标准
1终端执行 claude --version显示版本号与 (Claude Code)
2在练习文件夹执行 claude，进入后输入 /model不要求登录，显示 deepseek-flash
3对它说「新建 hello.md，写一句你好」文件夹中出现 hello.md；DeepSeek 平台用量页出现消耗

它在回答里自称 Claude 不影响使用，界面沿用的是 Claude 的说明，实际调用的是 DeepSeek，以用量页的消耗为准。退出 claude 按两次 Ctrl+C。