第25课 · 安装 Claude Code：给自己多一个 AI 终端

本节要点

多一个选择：前 24 节都用 OpenCode，这一节引入 Claude Code——Anthropic 官方出的 AI 命令行工具，和 OpenCode 定位一样、命令高度兼容，可以共存
三个名字别搞混：Claude Code（工具本体）/ Claude 模型（国内用不了）/ cc-switch（接入国内模型的切换器）
安装四步走：Node.js（已装）→ Claude Code 本体 → cc-switch → 配置国内模型 API
一行命令装好本体（国内镜像），一段配置接通国内模型
Claude Code 比 OpenCode 友好的地方：内置联网搜索、装插件更简单、Windows 上更稳
⭐ 不用每次点授权：本课重点补两种方式——① 启动加参数；② 改配置让 claude 直接免授权
两个工具共存：Skill 可以共用，MCP 各装一次

1. Claude Code 是什么？为什么要装它？

前 24 节课，我们一直在用 OpenCode。这一节给大家介绍 Claude Code——它是 Anthropic（Claude 的母公司）官方出品的 AI 命令行工具，和 OpenCode 定位几乎一模一样，斜杠命令也高度兼容。

为什么要引入它？只是给你多一个选择：

用 OpenCode 已经顺手 → 继续用，完全没问题
想尝鲜、对比一下 → 都装上，挑喜欢的用
没有任何强制要求

我个人的体会：

方面	Claude Code	OpenCode
装插件	`/plugin` 斜杠命令一条龙，更简单	要自己改配置文件
联网搜索	内置 Web Search，开箱即用	要装 oh-my-opencode-slim 插件才有
Windows 稳定性	更好使一点	偶尔有小毛病
Mac 体验	两个差不多	两个差不多

但有一点要先说清楚：Claude Code 默认要连 Anthropic 官方的模型，而国内连不上（被封了）。所以光装 Claude Code 本体没法直接用，必须再装一个 cc-switch 把它接上国内模型。这就是本课的两大主角。

2. 三个名字别搞混

最容易踩的坑就是分不清这几个名字。记住：

Claude Code：AI 命令行工具的本体。你在终端里敲 claude 启动的那个程序。Anthropic 官方开发。
Claude 模型：Anthropic 家的 AI「大脑」。国内用不了，要换成 DeepSeek、GLM 这些国内模型。
cc-switch：帮你切换 API 地址和密钥的小窗口软件。第三方社区开发。⚠️ cc-switch ≠ Claude Code，装了切换器不等于装了本体，两个都得装。
Node.js：Claude Code 运行的环境地基。前面装 OpenCode 终端版（第 4 课）时装过了，不用重复装。

一句话：Claude Code 是工具壳，Claude 模型用不了，靠 cc-switch 换成国内模型。

3. 安装四步走

顺序千万别反，反了报错你看不懂：

装 Node.js —— 第 4 课装过了，跳过
装 Claude Code 本体 —— 一行 npm 命令
装 cc-switch —— 下载安装包双击装
配置国内模型 —— 在 cc-switch 里填 API Key、映射模型

4. 第一步：一行命令装 Claude Code 本体

打开终端（PowerShell、CMD，或者第 21 课推荐的 Warp 都行），复制下面这行命令，回车：

bash

# 用国内镜像安装（不加镜像基本装不上）
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

关键是 --registry=

这个参数告诉 npm 走国内镜像，速度能差几十倍。不加基本装不上。想一劳永逸，先执行一次 npm config set registry https://registry.npmmirror.com，以后装啥都快。

装完验证一下：

bash

claude --version

看到版本号（类似 1.x.xx）就说明本体装好了。

💡 前提是你已经装过 Node.js。不确定的话先敲 node -v，能显示版本号就 OK；报错就回第 4 课把 Node.js 装上。

5. 第二步：下载安装 cc-switch

课程百度网盘里提供了 cc-switch 的安装包，Mac 版和 Windows 版都有，下载对应你系统的版本。

双击安装包，一路下一步
⚠️ 软件建议装在 D 盘，别什么都堆在 C 盘（Mac 没这个讲究，直接装应用程序就行）

装完打开，你会看到一个图形界面窗口——这就是切换器。

6. 第三步：在 cc-switch 配置国内模型（重点）

这是本课最关键的一步，跟着做：

① 新建配置

打开 cc-switch → 点「新建配置」。你会看到它内置了一个「官方配置」，但我们不用官方的（连不上），要新建一个自己的。

② 选供应商类型

新建时会让你选「统一供应商」还是「Claude 供应商」：

类型	适用场景
Claude 供应商	只给 Claude Code 一个工具用（本课演示选这个）
统一供应商	想让 Claude Code、Codex 等多个 AI 工具共用同一套配置

③ 填 API Key

下拉找到 API Key 一栏，把你在 DeepSeek（或其他国内模型商）注册得到的 API Key 复制粘贴进去。

💡 没 API Key 的话，去 DeepSeek 开放平台注册一个，充几块钱能用很久（国内模型很便宜）。参考第 3 课。

④ 配置模型档位（核心）

往下拉到「模型」配置。Claude 的模型按强弱分成了几个档位（从强到弱）：最强的档位、次强的，再到普通的。

cc-switch 的思路是：每个档位，你来映射成国内模型里的某个具体型号。建议这样配：

Claude 档位（由强到弱）	映射成国内模型	说明
最强档（如 Opus 等）	保留默认的 pro	最强档留给强模型
Sonnet 档	改成 flash	中等档用便宜的
支持百万 token 上下文的	都勾上	上下文越长越好
默认兜底模型	用 flash	兜底用最便宜的，省钱

配完点「添加」，再点「启用」。这一步等于是 cc-switch 帮你把 Claude Code 的配置文件改好了——以后 Claude Code 启动就直接用这套国内模型。

7. 第四步：启动 Claude Code

配置好了，来试试能不能用：

打开终端，先用 cd 命令进到一个项目文件夹（必须先进文件夹，不能在随便哪个目录启动）
bash
```
# 例子：进到你的项目文件夹（把路径换成你自己的）
cd C:\Users\你的用户名\Documents\测试
```
💡 不知道路径怎么写？在文件资源管理器里进到目标文件夹，点地址栏复制完整路径，粘贴到终端 cd 后面就行。
输入启动命令：
bash
```
claude
```
第一次启动会让你选主题（颜色风格）——方向键上下选，回车确认（默认那个就行）
会问你是否信任这个文件夹——回车信任
进入对话界面后，看左上角，显示的就是你在 cc-switch 里配的模型

发一句「你好」试试，能正常回复就说明全通了 🎉。

试试内置的联网搜索

Claude Code 自带 Web Search，直接说：

帮我联网搜索审计新闻

它就能联网抓取最新信息。这点比 OpenCode 友好——OpenCode 得装 oh-my-opencode-slim 插件才有联网能力，Claude Code 是开箱即用。

8. ⭐ 不用每次点授权（重点补充）

Claude Code 默认每执行一个操作（读写文件、跑命令）都要弹出来让你确认授权，频繁操作时点得很烦。下面教你两种方式，让它别老来烦你。

先理解：Claude Code 有几种「权限模式」

模式	行为	怎么进去
`default`（默认）	每个危险操作都问你	默认就是这个
`acceptEdits`（自动接受编辑）	文件读写自动放行，其他还问	`Shift+Tab` 切换
`plan`（计划模式）	只规划不动手，不改文件	`Shift+Tab` 切换 / `/plan`
`bypassPermissions`（跳过全部授权）	啥都不问，直接干	启动加参数 / 改配置（见下）

会话内快速切换：Shift+Tab

在 Claude Code 对话界面里，按住 Shift + Tab，会在 default / acceptEdits / plan 这几种模式之间循环切换。偶尔想偷懒、又不想永久关授权，按这个切到「acceptEdits」就行，文件读写自动放行、其他还问你。也可以输入 /permissions 命令，查看和管理当前权限规则。

⚠️ 注意：bypassPermissions（彻底免授权）没法在普通会话里按 Shift+Tab 切进去，必须用下面两种方式（启动参数 / 改配置）才能进入。

方式一：启动时加参数（临时，只管这一次）

在终端里，启动 Claude Code 时多带一个参数：

bash

claude --dangerously-skip-permissions

--dangerously-skip-permissions 就是「跳过全部授权」的开关（名字故意起得吓人，是为了提醒你这有风险）
只对这一次启动有效，关掉重开就恢复了
适合：偶尔需要让 AI 连续跑一大堆命令、不想一直点确认
⚠️ 第一次用会弹一个警告框，确认一次即可，以后就不再问了

方式二：改配置文件（永久，直接 `claude` 就免授权）

不想每次都敲那串长参数？改一下配置文件，以后直接 claude 就自动跳过授权。

编辑配置文件 settings.json（这是 Claude Code 的用户级配置）：

Mac / Linux：~/.claude/settings.json
Windows：C:\Users\你的用户名\.claude\settings.json

💡 .claude 是隐藏文件夹。Windows 在文件资源管理器顶部「查看」里勾选「隐藏的项目」才能看到；Mac 按 Cmd + Shift + . 显示隐藏文件。如果文件不存在，就新建一个叫 settings.json 的文本文件。

把内容改成：

json

{
  "permissions": {
    "defaultMode": "bypassPermissions"
  }
}

保存。以后终端里直接敲 claude，就是免授权模式了。

💡 第一次用也会弹一个警告框，点确认接受一次就行，配置会自动记下来，下次不再弹。这跟「方式一」是同一回事。

⚠️ 安全提醒

bypassPermissions = 完全信任 AI 的所有操作，包括删文件、跑任何命令。这很方便，但也意味着 AI 万一「抽风」你拦不住。建议：

只在信任的项目文件夹里用（别在系统目录、重要文件所在目录用）
重要项目先用第 20 课讲的 Git 做好版本控制，改坏了能回退
不放心的话，用折中方案：配置里设 "defaultMode": "acceptEdits"，只自动放行文件编辑，其他还问你
安心一点：即使开了免授权，像 rm -rf /（删根目录）、rm -rf ~（删整个用户目录）这种「灭顶之灾」命令，Claude Code 仍然会拦下来问你，这是官方留的最后一道保险

9. 装插件（比 OpenCode 简单很多）

Claude Code 装插件特别省心，一个斜杠命令搞定：

/plugin

回车后会列出官方插件库，方向键选、回车 install 就行。

输入 /plugin 提示「需要 add marketplace」怎么办？

有群友反馈，输入 /plugin 后没列出插件，反而提示「需要 add marketplace」。按下面三步排查：

① 先看版本是不是太旧

在终端里查一下：

bash

claude --version

如果版本号比较老（比如 2.1.x 这种），先升级——把第 4 步装本体的命令再跑一遍就是升级：

bash

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

② 添加官方插件市场

新版本里，插件要先「添加市场」才能看到。在 Claude Code 对话框里依次执行这两条：

/plugin marketplace add anthropics/claude-plugins-official
/plugin marketplace update

第一条是添加官方插件市场，第二条刷新一下。执行完再输 /plugin，插件列表就出来了。

③ 还不行？清空插件缓存重来

缓存坏了也会装不上。把缓存文件夹整个删掉：

Mac：~/.claude/plugins/cache
Windows：C:\Users\你的用户名\.claude\plugins\cache

💡 .claude 是隐藏文件夹。Windows 在文件资源管理器顶部「查看」里勾选「隐藏的项目」；Mac 按 Cmd + Shift + . 显示隐藏文件（第 8 节有讲）。

删掉 cache 文件夹后，重启 Claude Code 再试 /plugin。

几个值得装的：

插件	作用
Superpowers	前面在 OpenCode 装过的「先想清楚再动手」（第 5 课）
context7	MCP，能调取大量编程文档，查 API 很方便
skill-creator	Anthropic 官方的 Skill 制作工具（第 10 课）
GitHub	操作 GitHub（第 20 课）
Playwright	让 AI 操控浏览器、看网页
Security Guidance	保障一些安全方面

装完插件可能要让它生效，两种办法：

输入 /plugin reload（重新加载）
或者直接退出 Claude Code 重启（更保险）

重新进来后，Superpowers 里的 brainstorming、writing-plans 这些 skill 就都能用了，非常方便。

10. 切换模型、回到上次会话

这些命令和 OpenCode 基本一样（第 18 课讲过）：

命令	作用
`/model`	切换模型，比如切到 pro（百万 token 上下文）
`/resume`	回到之前的某个会话继续

在对话里输入 /model，选 pro 回车，就能用上 1M（百万 token）超长上下文的模型了。

11. OpenCode 和 Claude Code 共存（进阶）

很多人会问：我两个都想用怎么办？ 好消息——OpenCode 天然兼容 Claude Code。

最省心的做法：把 Skills 统一放在 Claude Code 里，两边就都能用了。你不用手动搬，直接跟 AI 说：

我的电脑里装了 OpenCode 和 Claude Code 两个 AI 工具，我想同时使用。
因为 OpenCode 兼容 Claude Code，所以我想把 Skills 统一安装在 Claude Code 里。
请帮我把 OpenCode 里的 Skills 迁移到 Claude Code，并告诉我 OpenCode 那边怎么配置才能共用。

AI 会帮你做迁移、配好共用方案。弄完之后：

✅ Skill：可以两边共用（放一处，两边都能调）
⚠️ MCP：两边安装方式不同，没法共用，每个工具里都得各自装一次

我自己在 Mac 上就是这么用的——Skills 都放在 Claude Code，OpenCode 直接兼容着用，省心。

三工具也能共存

将来你如果还用 Codex，也可以让 AI 帮你配成 Claude Code + OpenCode + Codex 三者兼容的方案，Skills 统一管理。直接跟 AI 讨论需求，让它帮你实现。

关键收获

TIP

Claude Code 是 Anthropic 官方的 AI 命令行工具，和 OpenCode 高度兼容、可以共存——只是给你多一个选择。国内用不了它的官方模型，所以要靠 cc-switch 接入 DeepSeek 等国内模型。

四步装好：① Node.js（第 4 课已装）→ ② 一行命令装 Claude Code 本体（带 --registry 国内镜像）→ ③ 装 cc-switch → ④ 在 cc-switch 里填 API Key、映射模型档位（强档留 pro、中等档用 flash、兜底用 flash 省钱）。

几个要点记住：① 必须 cd 进项目文件夹再敲 claude；② 不用每次点授权有两种办法——临时加参数 claude --dangerously-skip-permissions，或改 ~/.claude/settings.json 把 permissions.defaultMode 设为 bypassPermissions（注意安全，配合 Git 版本控制用）；③ Skill 可以让 AI 迁移、两个工具共用，MCP 要各装一次。

下一步

装好 Claude Code 后，可以回到第 6 课复习 Skill 的用法——两个工具通用，学会一处到处能用。

第25课 · 安装 Claude Code：给自己多一个 AI 终端 ​

本节要点 ​

1. Claude Code 是什么？为什么要装它？ ​

2. 三个名字别搞混 ​

3. 安装四步走 ​

4. 第一步：一行命令装 Claude Code 本体 ​

5. 第二步：下载安装 cc-switch ​

6. 第三步：在 cc-switch 配置国内模型（重点） ​

① 新建配置 ​

② 选供应商类型 ​

③ 填 API Key ​

④ 配置模型档位（核心） ​

7. 第四步：启动 Claude Code ​

试试内置的联网搜索 ​

8. ⭐ 不用每次点授权（重点补充） ​

先理解：Claude Code 有几种「权限模式」 ​

方式一：启动时加参数（临时，只管这一次） ​

方式二：改配置文件（永久，直接 claude 就免授权） ​

9. 装插件（比 OpenCode 简单很多） ​

10. 切换模型、回到上次会话 ​

11. OpenCode 和 Claude Code 共存（进阶） ​

关键收获 ​

下一步 ​

第25课 · 安装 Claude Code：给自己多一个 AI 终端

本节要点

1. Claude Code 是什么？为什么要装它？

2. 三个名字别搞混

3. 安装四步走

4. 第一步：一行命令装 Claude Code 本体

5. 第二步：下载安装 cc-switch

6. 第三步：在 cc-switch 配置国内模型（重点）

① 新建配置

② 选供应商类型

③ 填 API Key

④ 配置模型档位（核心）

7. 第四步：启动 Claude Code

试试内置的联网搜索

8. ⭐ 不用每次点授权（重点补充）

先理解：Claude Code 有几种「权限模式」

方式一：启动时加参数（临时，只管这一次）

方式二：改配置文件（永久，直接 `claude` 就免授权）

9. 装插件（比 OpenCode 简单很多）

10. 切换模型、回到上次会话

11. OpenCode 和 Claude Code 共存（进阶）

关键收获

下一步