ClaudeCode on Yanmu

5分钟安装ClaudeCode并接入DeepSeek

Sun, 26 Apr 2026 02:00:15 +0800

概述

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，内置多种 Skills 插件，通过不同组合可以完成许多 AI 单独做不到的事。接入国产大模型 DeepSeek V4 后，可以大幅降低使用成本。

核心用途：

构建个人知识库，自动化整理学习笔记
按时搜集行业资讯并整理成文稿
自动发布到各大社交媒体平台

第一步：安装运行环境

1.1 安装 Node.js

前往 Node.js 官网下载 Windows 安装包（.msi），双击后一路下一步。

验证安装：

1
2

node -v
npm -v

1.2 配置 npm 国内镜像

`1`	`npm config set registry https://registry.npmmirror.com/`

💡 为什么要配置镜像？

默认 npm 源在国外，下载速度很慢。配置国内镜像后安装速度可提升 10 倍以上。

1.3 安装 Git

前往 Git 官网下载对应版本安装包，一路下一步。

验证安装：

git -v

1.4 安装 CC-Switch

CC-Switch 用于将第三方模型接入 Claude Code。

前往 GitHub Release 页面下载对应版本（如 Windows MSI），双击安装，一路下一步。

第二步：安装 Claude Code

`1`	`npm install -g @anthropic-ai/claude-code`

验证：

`1`	`claude --version`

跳过登录（使用第三方 API）

启动一次 Claude Code 后关闭
在用户目录下找到 .claude.json 文件
添加以下字段（注意上一字段尾部需加英文逗号）：

`1`	`"hasCompletedOnboarding": true`

重新执行 claude 启动，选择信任当前文件夹即可

⚠️ 常见错误

如果忘记在上一字段末尾加逗号，会导致 JSON 解析错误，Claude Code 无法启动。

第三步：接入 DeepSeek

3.1 获取 API Key

打开 DeepSeek 开放平台，注册登录
确保账户有余额
右侧 API Keys → 创建 API Key → 复制保存（关闭后无法再次查看）

🚨 密钥安全

密钥不要分享给他人，否则会消耗你的余额。

3.2 配置 CC-Switch

打开 CC-Switch，点击右上角 + 号
模型预设选择 DeepSeek
填入 API Key
模型名称统一改为：deepseek-v4-pro[1m]（上下文 1M，Claude Code 默认使用 128K）
点击添加

3.3 验证模型

在 Claude Code 对话框中输入：

/model

可查看当前可用模型，或直接问"你当前是什么模型"确认接入成功。

第四步：实战示例

桌面新建一个文件夹
在地址栏输入 CMD 回车
执行 claude 启动，选择信任当前文件夹
输入需求：使用 HTML + JS + CSS 做一个 Todo 软件
运行中会申请工具权限，选择 Yes 即可
完成后让它帮你打开页面预览

💡 小技巧

可以用中文直接描述需求，Claude Code 支持中英文混合输入。

命令速查表

操作	命令
Node 版本检查	`node -v`
npm 版本检查	`npm -v`
npm 国内镜像	`npm config set registry https://registry.npmmirror.com/`
Git 版本检查	`git -v`
安装 Claude Code	`npm install -g @anthropic-ai/claude-code`
Claude Code 版本检查	`claude --version`
启动 Claude Code	`claude`
切换模型	`/model`

常见问题

执行 claude 后提示找不到命令？

检查 Node.js 是否安装成功（node -v），以及 npm 全局路径是否在系统 PATH 中。

启动后要求登录 Anthropic 账号？

说明 .claude.json 中的 hasCompletedOnboarding 未正确配置，请回到第二步检查。

模型调用报错 / 无响应？

检查 DeepSeek 账户余额是否充足，以及 CC-Switch 中 API Key 是否正确填写。

安装ClaudeCode并接入DeepSeek（面向小白）

Sun, 26 Apr 2026 02:00:15 +0800

概述

这份教程是给谁看的？

这份教程面向完全没有计算机基础的用户。你不需要知道什么是"命令行"、什么是"环境变量"、什么是"版本管理"——我会把每一步都拆解到最细，告诉你在哪里点、点什么、输入什么、看到什么说明成功了。

你要装什么？为什么要装这些？

在开始之前，先了解我们一共要安装 3 个东西，它们各自的作用：

序号	软件名称	一句话解释	为什么必须装
1	Node.js	让你的电脑能运行 JavaScript 程序的"引擎"	Claude Code 是用 JavaScript 写的，没有它就跑不起来
2	Claude Code	一个住在你电脑终端里的 AI 编程助手	这就是我们最终要用的东西
3	CC-Switch	一个给 Claude Code “换大脑"的小工具	让 Claude Code 从昂贵的官方模型换成便宜的 DeepSeek

整个过程大约需要 10-15 分钟。请按顺序一步步来，不要跳步。

📌 前提条件

你需要一台 Windows 电脑（Windows 10/11），能正常上网。

安装 Node.js

什么是 Node.js？

Node.js = 让电脑能运行 Claude Code 的运行环境。它是完全免费的，就像你需要先装好 Windows 系统才能运行软件一样，你需要先装好 Node.js 才能运行 Claude Code。

下载 Node.js

第 1 步：打开浏览器

打开你电脑上任意一个浏览器（Chrome、Edge、Firefox 都可以）。

第 2 步：访问 Node.js 官网

在浏览器地址栏（顶部输入网址的长条框）中输入以下网址，然后按回车：

`1`	`https://nodejs.org/`

第 3 步：找到下载按钮

打开网页后，你会看到页面中央有两个大按钮：

左边的按钮写着 LTS（推荐的版本号，比如 22.16.0 LTS）
右边的按钮写着 Current

点击左边的 LTS 按钮，浏览器会自动开始下载一个 .msi 文件。

第 4 步：找到下载好的文件

下载完成后（通常只需几秒钟），有两种方式找到这个文件：

方式一：点击浏览器右上角的下载列表（通常是一个向下的箭头 ↓ 图标），在列表中找到刚才下载的文件，文件名类似 node-v22.16.0-x64.msi
方式二：打开文件资源管理器（就是你看文件夹的那个窗口），在左侧找到下载文件夹，里面就有这个文件

安装 Node.js

第 1 步：双击安装文件

在下载文件夹中，找到 node-v22.16.0-x64.msi（版本号可能略有不同），双击它。

第 2 步：欢迎界面

弹出一个标题为 Node.js Setup（Node.js 安装向导）的窗口。点击底部的 Next（下一步）按钮。

第 3 步：许可协议

窗口中显示一大段英文协议文字。

勾选左下角的复选框：I accept the terms in the License Agreement（我接受许可协议中的条款）
点击 Next

第 4 步：安装位置（⚠️ 重要！需要修改路径）

这里显示的是 Node.js 将要安装到你电脑的哪个位置。

默认路径是：C:\Program Files\nodejs\

📌 我们要把它改到 D 盘！

建议安装到 D 盘，原因：

C 盘是系统盘，放太多东西会影响电脑速度

D 盘专门用来装软件，万一系统重装了，D 盘的东西还在

方便管理和查找

修改步骤：

点击路径输入框，把里面的内容全部选中（按 Ctrl + A），然后删除
输入新的路径：
1

D:\nodejs\
点击 Next

💡 注意

路径中不要有中文和空格，否则可能导致安装出错。

第 5 步：自定义安装

显示一个带有树状复选框的页面（Custom Setup）。

什么都不要改，直接点击 Next。

第 6 步：确认安装

点击 Install（安装）按钮。如果弹出安全提示，点击是。

第 7 步：等待安装

进度条会走完，通常只需 10-30 秒。

第 8 步：完成

点击 Finish（完成）。

Node.js 安装完成！

此时 Node.js 和 npm（Node.js 的包管理器，可以理解为"软件商店”）都已经装好了。

验证 Node.js 是否安装成功

安装完成后，我们需要验证一下——就像买完菜要检查一下有没有漏掉的东西。

第 1 步：打开命令提示符（CMD）

什么是"命令提示符"？

命令提示符（也叫 CMD）是一个黑色背景、白色文字的窗口，你可以在这个窗口里输入文字命令来让电脑执行操作。以后会经常用到它。

打开方式（任选一种）：

方式一（推荐）：
1. 按住键盘上的 Win 键（键盘左下角，画着 Windows 图标的那个键）
2. 同时按下 R 键
3. 弹出一个小窗口（标题是"运行"），在里面输入 cmd
4. 点击确定，或直接按回车键（Enter）
方式二：
1. 点击桌面左下角的开始菜单（Windows 图标）
2. 在搜索框中输入 cmd
3. 点击搜索结果中的 命令提示符

第 2 步：输入验证命令

在打开的黑色窗口中，输入以下内容（输入时屏幕上会显示你打的字），然后按回车键：

node -v

如果窗口中显示类似 v22.16.0 的内容，说明 Node.js 安装成功了 ✅

继续输入以下命令，按回车：

npm -v

如果显示类似 10.9.2 的版本号，说明 npm 也正常 ✅

⚠️ 提示"不是内部或外部命令"？

说明环境变量没有配置好，请看下面的 1.4 如何配置环境变量。

如何配置环境变量

什么是环境变量（PATH）？

PATH 可以理解为电脑的"通讯录"。当你在命令提示符里输入 node 时，电脑不知道 node 装在哪里，它会去 PATH 这个"通讯录"里找。如果 PATH 里没有 Node.js 的安装目录，电脑就找不到它，就会报"不是内部或外部命令"。

正常情况下，Node.js 安装时会自动把自己加到 PATH 里。但如果出了问题，你需要手动添加。

查看 PATH 里有没有 Node.js

按 Win + R，输入 sysdm.cpl，回车
点击顶部的高级选项卡
点击底部的 环境变量 按钮
在下方 系统变量 列表中，找到 Path 这一行，选中它，点击编辑

在弹出的列表中，检查有没有类似这样的条目：

`1`	`D:\nodejs\`

💡 路径要和你安装时设置的一致

如果你当时装在了 D:\Software\nodejs\，那这里也应该显示 D:\Software\nodejs\。

如果有这个条目：说明 PATH 没问题，但仍然报错的话，关掉当前命令提示符窗口，重新打开一个新的再试。

如果没有这个条目：按下面步骤手动添加。

手动添加 Node.js 到 PATH

在刚才打开的 编辑环境变量 窗口中，点击新建
输入 Node.js 的安装路径：
1

D:\nodejs\
点击确定
点击确定关闭环境变量窗口
点击确定关闭系统属性窗口
关掉所有已打开的命令提示符窗口，重新打开一个新的（旧窗口不会识别新配置）
再次输入 node -v 验证

配置 npm 国内镜像（强烈推荐）

💡 为什么要配置？

npm 默认从国外下载软件，速度很慢。配置国内镜像后下载速度提升 10 倍以上。

在命令提示符中输入以下命令，按回车：

`1`	`npm config set registry https://registry.npmmirror.com/`

输入以下命令验证，如果显示 https://registry.npmmirror.com/ 则成功 ✅：

`1`	`npm config get registry`

第一步完成！

你已经在电脑上安装好了 Node.js，并且配置了国内镜像。接下来安装 Claude Code。

安装 Claude Code

通过 npm 安装 Claude Code

打开命令提示符（如果还没打开的话），输入以下命令，按回车：

`1`	`npm install -g @anthropic-ai/claude-code`

等待安装完成（一般 1-3 分钟）。屏幕上会滚动一些文字，只要最后没有报错就行。

验证安装

输入：

`1`	`claude --version`

按回车。如果显示版本号（例如 1.0.x），说明安装成功 ✅

首次启动（跳过登录）

为什么要跳过登录？

Claude Code 官方要求你用 Anthropic 账号登录才能使用。但 Anthropic 的服务需要海外信用卡支付，对国内用户很不方便。

我们的方案是：先跳过登录，然后通过 CC-Switch 工具接入国产的 DeepSeek 模型，这样就不需要 Anthropic 账号了，费用也低得多。

第 1 步：先启动一次 Claude Code

在命令提示符中输入：

claude

按回车。Claude Code 会启动，可能会显示一些介绍信息或要求你登录。

不用管它，直接关闭这个命令提示符窗口（点右上角的 ×）。

第 2 步：找到配置文件

按 Win + R（Win 键 + R 键同时按）
在弹出的"运行"窗口中，输入 %USERPROFILE%
点击确定或按回车
打开后，你会看到一个文件夹，里面有各种文件和子文件夹

第 3 步：找到 .claude.json 文件

在这个文件夹中，找到一个名为 .claude.json 的文件。

⚠️ 找不到这个文件？

如果找不到 .claude.json，可能是以下原因：

文件扩展名被隐藏了——在文件夹窗口顶部，点击查看 → 勾选 文件扩展名 和 隐藏的项目

Claude Code 还没有创建这个文件——请回到第 1 步，确保你成功启动过一次 Claude Code

在某些情况下，这个文件可能在 .claude 文件夹里面，文件名为 settings.json

第 4 步：用记事本打开配置文件

右键点击 .claude.json 文件
在弹出的菜单中，选择 打开方式
选择 记事本（Notepad）
- 如果列表中没有记事本，选择 选择其他应用 → 在列表中找到 记事本 → 点击确定

第 5 步：编辑配置文件

打开后，你会看到类似这样的内容（具体内容可能不同）：

{
  "someField": "someValue",
  "anotherField": "anotherValue"
}

我们需要在最后的 } 前面，添加一行 "hasCompletedOnboarding": true。

修改后的样子应该是这样的：

{
  "someField": "someValue",
  "anotherField": "anotherValue",
  "hasCompletedOnboarding": true
}

📌 ⚠️ 注意三个细节，否则会报错！

加逗号：hasCompletedOnboarding 前面那行的末尾要加一个英文逗号 ,

用英文引号：引号必须是英文的 "，不能是中文的 "

true 是小写：必须写 true，不能写 True

第 6 步：保存文件

按 Ctrl + S 保存（或者点击左上角文件 → 保存）
关闭记事本窗口

第 7 步：验证跳过登录是否成功

重新打开命令提示符（Win + R → cmd → 回车）
输入 claude，按回车
如果直接进入了 Claude Code 的主界面（没有要求你登录），说明跳过登录成功 ✅

第二步完成！

Claude Code 安装完毕，并且跳过了登录步骤。接下来安装 CC-Switch 来接入 DeepSeek。

安装 CC-Switch（模型切换工具）

什么是 CC-Switch？

CC-Switch 是一个可视化工具，让你不用手动改配置文件，点点鼠标就能把 Claude Code 的"大脑"从官方模型换成 DeepSeek。

下载 CC-Switch

第 1 步：打开下载页面

在浏览器地址栏中输入以下网址，按回车：

`1`	`https://github.com/cc-switch/cc-switch/releases`

第 2 步：找到最新版本

打开页面后，找到带有绿色 Latest 标签的版本，点击展开。

第 3 步：找到下载链接

展开后往下滚动，找到 Assets 这个词（旁边可能有个小箭头 ▾），点击展开它。

找到以 .msi 结尾的文件（Windows 安装包），点击文件名开始下载。

💡 选哪个文件？

Windows 电脑：选 x64.msi 结尾的文件

Mac 电脑：选 .dmg 结尾的文件

安装 CC-Switch

第 1 步：双击安装文件

在下载文件夹中，双击下载好的 .msi 文件。如果弹出安全提示，点击 仍要运行 或 更多信息 → 仍要运行。

第 2 步：按提示安装

安装向导和 Node.js 类似：

点击 Next
接受协议 → Next
保持默认安装路径 → Next
点击 Install
等待安装完成 → Finish

第三步完成！

CC-Switch 安装好了。接下来获取 DeepSeek 的 API Key。

获取 DeepSeek API Key

什么是 DeepSeek？

国产大语言模型，性能强大且价格低廉（日常使用每月约 10-30 元），接入后可以大幅降低使用成本。

什么是 API Key？

API Key 是一把钥匙，用来调用 DeepSeek 的 AI 服务，每次使用会从账户余额中扣费。你需要：① 注册账号 ② 充值 ③ 创建 Key

注册 DeepSeek 账号

第 1 步：打开 DeepSeek 开放平台

在浏览器地址栏中输入：

`1`	`https://platform.deepseek.com/`

按回车。

💡 注意

这是 DeepSeek 的开发者平台（platform.deepseek.com），不是聊天网站（chat.deepseek.com），别搞混了。

第 2 步：注册/登录

页面右上角有登录 / 注册按钮
点击注册（如果没有账号）或登录（已有账号）
按页面提示填写信息完成注册

充值余额

💡 费用参考

日常使用一个月大约只需 10-30 元，建议首次充值 20-50 元。

登录后，在页面左侧菜单中找到充值（或钱包 / Billing），点击它
选择充值金额，选择支付方式，完成支付
确保账户余额大于 0（没有余额无法使用 API）

创建 API Key

第 1 步：进入 API Keys 页面

登录后，在左侧菜单中找到 API Keys，点击它
你会看到一个 API Keys 管理页面

第 2 步：创建新的 API Key

点击 创建 API Key 按钮
弹出一个对话框，要求你输入 Key 的名称
- 可以随意填写，比如 claude-code、我的key、test 都行
- 这个名称只是给你自己看的，用来区分不同的 Key
点击确认或创建

第 3 步：复制 API Key（⚠️ 最关键的一步！）

创建成功后，页面会显示你的 API Key，格式类似：

`1`	`sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

⚠️ 这个 Key 只会显示一次！

关闭对话框后就再也看不到了。请立即复制保存到记事本或微信文件传输助手。

🚨 安全提醒

API Key 等同于你的账号密码，不要分享给任何人，不要发到公开场合。如果怀疑泄露，立即删除并重新创建。

第四步完成！

你已经有了 DeepSeek 的 API Key（钥匙）。最后一步，把这把钥匙交给 CC-Switch，完成接入。

配置 CC-Switch 接入 DeepSeek

打开 CC-Switch

在桌面上或开始菜单中找到 CC-Switch 的图标，双击打开。

添加 DeepSeek 配置

第 1 步：点击添加按钮

CC-Switch 打开后，找到右上角的 + 号（加号按钮），点击它。

第 2 步：填写配置信息

点击 + 号后，会弹出一个配置面板，填写以下信息：

① 模型预设（Model Preset）：选择 DeepSeek

② API Key：粘贴你之前复制的 DeepSeek API Key（注意首尾不要有空格）

③ 模型名称（Model Name）：把输入框内容删掉，输入：

`1`	`deepseek-v4-pro[1m]`

④ Base URL / API 地址（如果有的话）：

`1`	`https://api.deepseek.com`

第 3 步：保存配置

检查所有信息都填好后，点击添加 / 保存 / 确认按钮。

切换到 DeepSeek

回到 CC-Switch 的主界面
你会看到刚才添加的 DeepSeek 配置已经出现在列表中
点击该配置旁边的切换 / 启用按钮
界面上应该会显示"当前模型：DeepSeek"或类似的信息

验证接入是否成功

打开命令提示符，输入 claude 启动 Claude Code。

在 Claude Code 中输入：

/model

按回车。如果显示的模型信息中包含 DeepSeek，说明接入成功 ✅

全部配置完成！

现在可以开始使用 AI 编程助手了！

开始使用（实战示例）

配置完成后，做一个简单的练习确保一切正常。

创建项目文件夹并打开命令提示符

在桌面右键 → 新建 → 文件夹，命名为 my-first-ai-project
双击打开这个文件夹
点击窗口顶部的地址栏，输入 cmd，按回车

启动 Claude Code

在弹出的命令提示符窗口中，输入：

claude

按回车。如果询问是否信任这个文件夹，输入 y 按回车。

发出第一个指令

Claude Code 启动后，输入以下内容（可以直接用中文）：

`1`	`帮我创建一个简单的个人主页，使用 HTML + CSS + JavaScript，包含一个标题、一段自我介绍和一个深色模式切换按钮`

按回车提交。

处理权限请求

运行过程中 Claude Code 可能会询问是否允许创建/修改文件，选择 Yes 即可。建议在自己创建的项目中选择 Yes, always allow（以后不再询问）。

查看成果

完成后，回到项目文件夹，双击 index.html，它会在浏览器中打开，你就能看到 AI 帮你创建的网页了！

恭喜！

你已经用 Claude Code + DeepSeek 完成了第一个项目！

常用命令速查表

操作	命令	说明
检查 Node.js 版本	`node -v`	验证 Node.js 是否安装
检查 npm 版本	`npm -v`	验证 npm 是否正常
设置 npm 镜像	`npm config set registry https://registry.npmmirror.com/`	加速下载
检查 npm 镜像	`npm config get registry`	验证镜像是否生效
安装 Claude Code	`npm install -g @anthropic-ai/claude-code`	全局安装
检查 Claude Code 版本	`claude --version`	验证 Claude Code 是否安装
启动 Claude Code	`claude`	在当前文件夹启动
查看当前模型	`/model`	在 Claude Code 内输入
退出 Claude Code	`/exit` 或按两次 `Ctrl + C`	退出程序

常见问题 FAQ

输入 node -v 提示"不是内部或外部命令"？

Node.js 的环境变量（PATH）没有配置好。打开文件资源管理器，进入 D:\nodejs\ 看看里面有没有 node.exe：

有这个文件：说明安装了但 PATH 没配好，按照上方 1.4 如何配置环境变量 的步骤手动添加

没有这个文件：说明安装失败了，重新下载安装

输入 claude 提示"不是内部或外部命令"？

Claude Code 安装没成功。先确认 node -v 和 npm -v 正常，然后重新执行 npm install -g @anthropic-ai/claude-code。

启动 Claude Code 后要求登录 Anthropic 账号？

.claude.json 没改对。按 Win + R，输入 %USERPROFILE% 回车，找到 .claude.json 用记事本打开，确认里面有 "hasCompletedOnboarding": true，且前面那行末尾有英文逗号、true 是小写、引号是英文引号。

Claude Code 对话时报错 / 无响应？

常见原因：① DeepSeek 余额不足 ② API Key 填写错误 ③ 模型名称不是 deepseek-v4-pro[1m] ④ 网络问题。逐项检查即可。

npm 安装 Claude Code 非常慢（超过 5 分钟）？

检查是否配置了国内镜像：npm config get registry（应显示 registry.npmmirror.com）。如果没有，执行 npm config set registry https://registry.npmmirror.com/ 后重试。

CC-Switch 打不开或闪退？

到 GitHub Release 重新下载最新版本，或尝试右键以管理员身份运行。

GitHub 页面打不开？

原因：GitHub 在国内可能访问不稳定。解决：

多刷新几次页面

尝试使用不同的浏览器

如果实在打不开，可以在网上搜索"CC-Switch 下载"，有些国内镜像站也提供了下载

完整流程回顾

步骤内容一句话总结

第一步安装 Node.js 装好"运行引擎"，让电脑能跑 JavaScript 程序

第二步安装 Claude Code 装好"AI 助手"，并跳过登录

第三步安装 CC-Switch 装好"换脑器"，用来切换 AI 模型

第四步获取 DeepSeek API Key 拿到"钥匙"，用来调用 DeepSeek 的 AI 服务

第五步配置 CC-Switch 用"换脑器"+“钥匙”，把 Claude Code 的大脑换成 DeepSeek

第六步开始使用在任何文件夹中输入 claude 启动 AI 助手！

完成全部步骤后，你就可以在电脑的任何文件夹中，输入 claude 命令，启动一个由 DeepSeek 驱动的 AI 编程助手了！

步骤	内容	一句话总结
第一步	安装 Node.js	装好"运行引擎"，让电脑能跑 JavaScript 程序
第二步	安装 Claude Code	装好"AI 助手"，并跳过登录
第三步	安装 CC-Switch	装好"换脑器"，用来切换 AI 模型
第四步	获取 DeepSeek API Key	拿到"钥匙"，用来调用 DeepSeek 的 AI 服务
第五步	配置 CC-Switch	用"换脑器"+“钥匙”，把 Claude Code 的大脑换成 DeepSeek
第六步	开始使用	在任何文件夹中输入 `claude` 启动 AI 助手！

MCP入门指南：小白也能看懂的AI万能插头

Mon, 01 Dec 2025 01:46:03 +0800

概述

你有没有想过：ChatGPT、Claude 这些 AI 很聪明，但它们只能在对话框里聊天，没法帮你查日历、管文件、操作数据库——因为它们被"关在笼子里"，接触不到外面的世界。

MCP（Model Context Protocol，模型上下文协议） 就是来打破这堵墙的。

简单来说，MCP 是一个开放标准协议，让 AI 应用能够连接外部系统——文件、数据库、API、各种工具——就像给 AI 装了一个万能插头（USB-C 接口），插上什么就能用什么。

💡 一句话理解 MCP： 它是 AI 世界的"USB-C 接口"——统一标准，即插即用。

🤔 为什么要用 MCP？

没有 MCP 之前

在 MCP 出现之前，如果你想让 AI 连接外部工具（比如查天气、读日历、操作数据库），每个 AI 应用和每个工具之间都需要单独开发对接。

这就像早年的手机充电口——安卓一个、苹果一个、Type-C 一个，每换一个设备就得重新买线。

问题很明显：

开发成本高：每个对接都是从零开始
不通用：给 Claude 写的工具，ChatGPT 用不了
维护困难：工具一升级，所有对接都得改

有了 MCP 之后

MCP 定义了一个统一标准：

工具方按照 MCP 标准开发一个 MCP Server（服务端）
AI 应用作为 MCP Client（客户端）来连接它
只要双方都遵守 MCP 协议，即插即用，无需重复开发

这就像是 USB-C 统一了充电接口——一根线走天下。

🎯 MCP 能做什么？使用场景一览

1️⃣ 个人 AI 助手

让 AI 帮你管理日常生活：

📅 连接 Google Calendar，帮你查看日程、创建会议提醒
📝 连接 Notion，帮你整理笔记、管理待办事项
📧 连接 Gmail，帮你读取和回复邮件
💬 连接 Slack / 飞书，帮你总结聊天记录

举个例子： 你对 AI 说"帮我看看明天有什么会议，总结一下上周的项目进度笔记"——AI 就能自动查日历、翻 Notion，给你一份汇总。

2️⃣ 编程开发

让 AI 编程助手真正"动手干活"：

📁 通过 MCP 连接 本地文件系统，读写项目文件
🗄️ 连接 数据库，直接查询和修改数据
🐙 连接 GitHub，自动创建 Issue、提交 PR
🎨 连接 Figma，根据设计稿直接生成代码

举个例子： Claude Code 通过 MCP 连接 Figma，拿到设计稿后直接生成一个完整的 Web 应用。

3️⃣ 企业级应用

在公司里大展身手：

🏢 连接 多个数据库，让员工用自然语言查询业务数据
📊 连接 内部系统（CRM、ERP），AI 自动汇总报表
🔍 连接 知识库，让 AI 基于公司文档回答问题

4️⃣ 创意与设计

🖼️ 连接 Blender，让 AI 生成 3D 模型
🖨️ 连接 3D 打印机，直接打印设计
🎬 连接 视频编辑工具，自动化剪辑流程

🏗️ MCP 的核心架构

MCP 的架构非常简单，只有三个角色：

┌──────────────┐         ┌──────────────┐         ┌──────────────┐
│   AI 应用    │ ◄─────► │   MCP 协议    │ ◄─────► │  MCP Server  │
│ (MCP Client) │         │  (传输层)     │         │  (外部工具)   │
└──────────────┘         └──────────────┘         └──────────────┘

角色	说明	类比
MCP Client	AI 应用（如 Claude、ChatGPT、Cursor）	手机
MCP Server	提供具体能力的服务（如查天气、管文件）	充电器
MCP 协议	双方沟通的"语言"	USB-C 标准

MCP Server 能提供什么？

MCP Server 可以向 AI 暴露三类能力：

类型	说明	例子
Tools（工具）	AI 可以调用的函数/操作	搜索网页、发送邮件、查询数据库
Resources（资源）	AI 可以读取的数据	文件内容、数据库记录、API 返回值
Prompts（提示词模板）	预设的提示词模板	代码审查模板、翻译模板

🚀 怎么使用 MCP？

方式一：直接用现成的 MCP Server（推荐小白）

这是最简单的方式——别人已经写好了 MCP Server，你只需要"安装并连接"。

步骤 1：找到你需要的 MCP Server

MCP 生态已经有大量现成的 Server，常用的获取渠道：

官方仓库：github.com/modelcontextprotocol/servers
MCP 市场：mcp.so、smithery.ai
GitHub 搜索：搜索关键词 mcp-server

MCP Server	功能
`filesystem`	读写本地文件
`github`	操作 GitHub（Issue、PR）
`fetch`	抓取网页内容
`sqlite`	操作 SQLite 数据库
`notion`	操作 Notion 笔记
`memory`	持久化记忆存储

步骤 2：在 AI 应用中配置 MCP Server

以 Claude Desktop 为例，找到配置文件：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

添加 MCP Server 配置（以 filesystem 为例）：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/你的/工作目录/路径"
      ]
    }
  }
}

保存后重启 Claude Desktop，AI 就拥有了操作文件的能力。

步骤 3：开始使用

重启后，在对话中直接让 AI 使用这些工具：

“帮我在工作目录下创建一个 notes 文件夹”
“读取 README.md 的内容，给我做个总结”
“搜索一下最近的项目 Issue”

AI 会自动调用对应的 MCP Server 来完成任务。

方式二：在 Cursor / VS Code 中使用 MCP

如果你用 Cursor 或 VS Code 进行编程开发，配置方式类似。

在项目根目录创建 .cursor/mcp.json（Cursor）或 .vscode/mcp.json（VS Code）：

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    },
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sqlite", "./data.db"]
    }
  }
}

配置完成后，在 AI 对话中就可以使用这些工具了。

方式三：自己开发 MCP Server（进阶）

如果你想让 AI 连接自己的系统（比如公司内部 API），可以自己写一个 MCP Server。

MCP 支持多种编程语言，官方提供了 SDK：

语言	SDK
TypeScript	`@modelcontextprotocol/sdk`
Python	`mcp`（PyPI）
Java / Kotlin	`io.modelcontextprotocol`

最简示例（TypeScript）：

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({
  name: "my-server",
  version: "1.0.0"
});

// 定义一个"查天气"的工具
server.tool(
  "get_weather",
  { city: z.string().describe("城市名称") },
  async ({ city }) => {
    // 这里写你的业务逻辑
    const weather = `${city}今天晴天，25°C`;
    return {
      content: [{ type: "text", text: weather }]
    };
  }
);

// 启动服务
const transport = new StdioServerTransport();
await server.connect(transport);

写好后配置到 AI 应用中即可使用。

🌐 哪些 AI 应用支持 MCP？

MCP 已经成为行业标准，主流 AI 应用纷纷支持：

AI 应用	支持情况
Claude Desktop / Claude Code	✅ 原生支持
ChatGPT	✅ 支持
Cursor	✅ 支持
VS Code (Copilot)	✅ 支持
Windsurf	✅ 支持
OpenCode	✅ 支持

一次配置，多端通用——在 Claude 里配好的 MCP Server，换个应用照样能用。

❓ 常见问题

Q：MCP 和 API 有什么区别？

API 是两方之间的"私有协议"，每个 API 的调用方式都不同。MCP 是一个统一标准——所有遵守 MCP 的工具，AI 都能用同样的方式调用。可以把 MCP 理解为"AI 专用的 API 标准层"。

Q：使用 MCP 需要编程基础吗？

不需要！ 如果你只是使用现成的 MCP Server，只需要会复制粘贴配置文件就行。只有自己开发 MCP Server 时才需要编程。

Q：MCP 安全吗？

MCP Server 默认运行在本地，数据不会上传到云端。但使用第三方 MCP Server 时，建议查看其源码和权限，确保安全。

Q：MCP Server 运行需要什么环境？

大部分 MCP Server 基于 Node.js 运行，你需要先安装 Node.js。Python 版本的 Server 则需要 Python 环境。

📚 总结

问题	答案
MCP 是什么？	AI 连接外部工具的统一标准协议
为什么要用？	让 AI 真正"动手干活"，而不是只能聊天
谁能用？	所有人——小白用现成 Server，开发者可以自己写
怎么用？	找到 MCP Server → 配置到 AI 应用 → 重启使用

MCP 的本质就是：给 AI 世界统一一个"插口标准"，让工具和 AI 自由连接。

🔗 延伸阅读：

MCP 官方文档

MCP Server 仓库

MCP 中文社区