Claude Code 小白安装教程：零基础，10 分钟搞定

Claude Code 小白安装教程：零基础，10 分钟搞定 Claude Code 小白安装教程：零基础，10 分钟搞定 Modified April 14 2. 点击这个链接：https://marketplace.visualstudio.com/items?itemName=anthropic.claude code 3. 网页会提示你跳转到 VS Code，点「允许」 4. 在 VS Code 里点击「Install（安装）」按钮或者手动安装： 1. 在 VS Code 左侧栏，找到一个看起来像「四个方块」的图标（扩展商店），点击它 2. 在搜索框里输入「Claude Code」 3. 找到 Anthropic 官方出品的那个，点「Install」安装完成！你会在 VS Code 侧边栏看到一个新的 Claude 图标。第四步：搞定账号（最关键的一步） Claude Code 本身免费，但它背后的 AI 大脑需要付费使用。这里有个比喻帮你理解： • Claude Code = 手机（免费的） • AI 大模型 = 运营商（需要充话费）你的手机可以选电信、联通、移动来上网打电话。同样，Claude Code 可以选不同的「AI 运营商」。推荐方案：使用中转服务（最简单，国内直接用）因为 Claude 官方对国内用户有限制，直接用官方账号门槛较高。中转服务帮你解决了这个问题——你把请求发给中转商，中转商帮你转发给 Claude，你不用操心网络问题。以下是几个常用的中转服务商（任选一个注册即可）：服务商链接特点 hongmacc https://hongmacc.com 支持订阅套餐+按量购买，比较灵活 4api https://4api.top 按 Token 消耗量购买 AIcodewith https://aicodewith.com 按 Token 消耗量购买注册后，你会得到两样东西： • API Key（一串长长的密码，类似 sk xxxx 或 or xxxx） • 请求地址（类似 https://hongmacc.com/api）把这两个东西记下来，下一步要用。备选方案：使用国产大模型（更便宜）如果你想省钱，也可以用国产模型替代：模型链接 DeepSeek https://api docs.deepseek.com/zh cn/guides/anthropic api 智谱 GLM https://www.bigmodel.cn/claude code 效果会比 Claude 原版差一些，但基本够用。第五步：配置账号到 Claude Code 你有两种配置方式，推荐第一种：方式一：用 CC Switch 工具配置（推荐，有界面操作） CC Switch 是一个专门帮你管理 Claude Code 账号的小工具。 1. 下载 CC Switch：https://github.com/farion1231/cc switch/releases ◦ Windows 下载 .msi 文件 ◦ Mac 下载 .zip 文件 2. 安装后打开 CC Switch 3. 点击右上角「新建」→ 选择「自定义配置」 4. 填写信息： ◦ 供应商名字：随便写，比如「我的账号」 ◦ API Key：粘贴你在第四步拿到的那串密码 ◦ 请求地址：粘贴你的服务商地址 5. 点击「保存」 6. 重要：勾选「应用到 Claude Code 插件」和「跳过初次安装确认」 7. 重启 VS Code Mac 用户注意：首次打开可能提示「未知开发者」，去「系统设置」→「隐私与安全性」→ 点「仍要打开」即可。方式二：手动配置（适合想了解原理的人） 1. 找到你电脑上的这个目录： ◦ Mac：打开「终端」，输入 open /.claude 回车 ◦ Windows：在文件资源管理器地址栏输入 %USERPROFILE%\.claude 回车 2. 在这个文件夹里新建一个文件，命名为 settings.json 3. 用文本编辑器打开它，粘贴以下内容（把里面的信息替换成你自己的）： Code block JSON Copy { "env": { "ANTHROPIC AUTH TOKEN": "你的API Key粘贴在这里", "ANTHROPIC BASE URL": "你的请求地址粘贴在这里" } } 1. 保存文件，重启 VS Code 第六步：开始使用！ 1. 打开 VS Code 2. 点击菜单「文件」→「打开文件夹」，选一个你想让 Claude 工作的文件夹（比如「桌面」或「下载」文件夹） 3. 点击左侧的 Claude Code 图标 4. 在对话框里输入一句话，比如：「你好，帮我看看这个文件夹里有什么」 5. 按回车如果 Claude 正常回复了——恭喜，你已经成功安装并配置好了！试试你的第一个任务不知道用 Claude Code 做什么？试试这个：打开你的「下载」文件夹，然后告诉 Claude：帮我整理一下这个文件夹里的文件，把图片、文档、视频分类放到不同的子文件夹里看着 Claude 自动帮你干活，感受一下 AI 的魔力吧！常见问题 Q：输入内容后，Claude 没有回复 / 顶部出现红色报错原因：Git 没装好，或者装完没重启 VS Code。解决：确认 Git 已安装，然后完全关闭 VS Code 再重新打开。 Q：出现登录界面，不知道怎么办原因：CC Switch 的配置没生效。解决： 1. 检查 CC Switch 里是否勾选了「应用到 Claude Code 插件」和「跳过初次安装确认」 2. 试试在 CC Switch 里新建一个其他配置，切换过去，再切换回来（让配置重新写入） 3. 重启 VS Code Q：报错 "request body too large" 原因：你发了太大的图片或对话太长了。解决：在 Claude Code 里新开一个对话（点击左上角的「+」按钮）。 Q：挂了梯子但安装时网络报错解决：命令行默认不走代理。如果你用的是终端安装方式，先在终端执行： Code block Plain Text Copy export https proxy=http://127.0.0.1:你的代理端口 http proxy=http://127.0.0.1:你的代理端口然后再执行安装命令。 Q：改错了东西怎么办？别慌！在 Claude Code 对话框里输入 /rewind，可以回退到之前的状态。或者直接告诉 Claude：「刚才的改动还原回去」。想更深入学习？这份教程帮你完成了最基础的安装和体验。如果你想深入学习 Claude Code 的更多玩法，推荐以下资源（都在 WaytoAGI 飞书知识库里）： • Claude Code 专区（系统化学习路径）：https://waytoagi.feishu.cn/wiki/LJbiwATadi72LUklHpgcexeSnNh • Claude Code 完整安装指南（详细版）：https://waytoagi.feishu.cn/wiki/MrfKwe3ApilsnvkaRyfcM1kEnmr • Claude Code 保姆级入门教程：https://waytoagi.feishu.cn/wiki/WZZRwjxAbiNow5ki0s6clQNLnsb • Claude Code 进阶：装这 9 个 Skill 才算真正上手：https://waytoagi.feishu.cn/wiki/CnfKwM4PzisrshkGH1Ycg3mYnAd 本教程整理自 WaytoAGI 社区知识库，感谢 Ben、老金、橘子等社区共建者的原始教程。 2. 点击这个链接：https://marketplace.visualstudio.com/items?itemName=anthropic.claude code 3. 网页会提示你跳转到 VS Code，点「允许」 4. 在 VS Code 里点击「Install（安装）」按钮或者手动安装： 1. 在 VS Code 左侧栏，找到一个看起来像「四个方块」的图标（扩展商店），点击它 2. 在搜索框里输入「Claude Code」 3. 找到 Anthropic 官方出品的那个，点「Install」安装完成！你会在 VS Code 侧边栏看到一个新的 Claude 图标。第四步：搞定账号（最关键的一步） Claude Code 本身免费，但它背后的 AI 大脑需要付费使用。这里有个比喻帮你理解： • Claude Code = 手机（免费的） • AI 大模型 = 运营商（需要充话费）你的手机可以选电信、联通、移动来上网打电话。同样，Claude Code 可以选不同的「AI 运营商」。推荐方案：使用中转服务（最简单，国内直接用）因为 Claude 官方对国内用户有限制，直接用官方账号门槛较高。中转服务帮你解决了这个问题——你把请求发给中转商，中转商帮你转发给 Claude，你不用操心网络问题。以下是几个常用的中转服务商（任选一个注册即可）：服务商链接特点 hongmacc https://hongmacc.com 支持订阅套餐+按量购买，比较灵活 4api https://4api.top 按 Token 消耗量购买 AIcodewith https://aicodewith.com 按 Token 消耗量购买服务商服务商链接链接特点特点 hongmacc hongmacc https://hongmacc.com https://hongmacc.com 支持订阅套餐+按量购买，比较灵活支持订阅套餐+按量购买，比较灵活 4api 4api https://4api.top https://4api.top 按 Token 消耗量购买按 Token 消耗量购买 AIcodewith AIcodewith https://aicodewith.com https://aicodewith.com 按 Token 消耗量购买按 Token 消耗量购买注册后，你会得到两样东西： • API Key（一串长长的密码，类似 sk xxxx 或 or xxxx） • 请求地址（类似 https://hongmacc.com/api）把这两个东西记下来，下一步要用。备选方案：使用国产大模型（更便宜）如果你想省钱，也可以用国产模型替代：模型链接 DeepSeek https://api docs.deepseek.com/zh cn/guides/anthropic api 智谱 GLM https://www.bigmodel.cn/claude code 模型模型链接链接 DeepSeek DeepSeek https://api docs.deepseek.com/zh cn/guides/anthropic api https://api docs.deepseek.com/zh cn/guides/anthropic api 智谱 GLM 智谱 GLM https://www.bigmodel.cn/claude code https://www.bigmodel.cn/claude code 效果会比 Claude 原版差一些，但基本够用。第五步：配置账号到 Claude Code 你有两种配置方式，推荐第一种：方式一：用 CC Switch 工具配置（推荐，有界面操作） CC Switch 是一个专门帮你管理 Claude Code 账号的小工具。 1. 下载 CC Switch：https://github.com/farion1231/cc switch/releases ◦ Windows 下载 .msi 文件 ◦ Mac 下载 .zip 文件 ◦ Windows 下载 .msi 文件 ◦ Mac 下载 .zip 文件 2. 安装后打开 CC Switch 3. 点击右上角「新建」→ 选择「自定义配置」 4. 填写信息： ◦ 供应商名字：随便写，比如「我的账号」 ◦ API Key：粘贴你在第四步拿到的那串密码 ◦ 请求地址：粘贴你的服务商地址 ◦ 供应商名字：随便写，比如「我的账号」 ◦ API Key：粘贴你在第四步拿到的那串密码 ◦ 请求地址：粘贴你的服务商地址 5. 点击「保存」 6. 重要：勾选「应用到 Claude Code 插件」和「跳过初次安装确认」 7. 重启 VS Code Mac 用户注意：首次打开可能提示「未知开发者」，去「系统设置」→「隐私与安全性」→ 点「仍要打开」即可。方式二：手动配置（适合想了解原理的人） 1. 找到你电脑上的这个目录： ◦ Mac：打开「终端」，输入 open /.claude 回车 ◦ Windows：在文件资源管理器地址栏输入 %USERPROFILE%\.claude 回车 ◦ Mac：打开「终端」，输入 open /.claude 回车 ◦ Windows：在文件资源管理器地址栏输入 %USERPROFILE%\.claude 回车 2. 在这个文件夹里新建一个文件，命名为 settings.json 3. 用文本编辑器打开它，粘贴以下内容（把里面的信息替换成你自己的）： 1. 保存文件，重启 VS Code 第六步：开始使用！ 1. 打开 VS Code 2. 点击菜单「文件」→「打开文件夹」，选一个你想让 Claude 工作的文件夹（比如「桌面」或「下载」文件夹） 3. 点击左侧的 Claude Code 图标 4. 在对话框里输入一句话，比如：「你好，帮我看看这个文件夹里有什么」 5. 按回车如果 Claude 正常回复了——恭喜，你已经成功安装并配置好了！试试你的第一个任务不知道用 Claude Code 做什么？试试这个：打开你的「下载」文件夹，然后告诉 Claude：帮我整理一下这个文件夹里的文件，把图片、文档、视频分类放到不同的子文件夹里看着 Claude 自动帮你干活，感受一下 AI 的魔力吧！常见问题 Q：输入内容后，Claude 没有回复 / 顶部出现红色报错原因：Git 没装好，或者装完没重启 VS Code。解决：确认 Git 已安装，然后完全关闭 VS Code 再重新打开。 Q：出现登录界面，不知道怎么办原因：CC Switch 的配置没生效。解决： 1. 检查 CC Switch 里是否勾选了「应用到 Claude Code 插件」和「跳过初次安装确认」 2. 试试在 CC Switch 里新建一个其他配置，切换过去，再切换回来（让配置重新写入） 3. 重启 VS Code Q：报错 "request body too large" 原因：你发了太大的图片或对话太长了。解决：在 Claude Code 里新开一个对话（点击左上角的「+」按钮）。 Q：挂了梯子但安装时网络报错解决：命令行默认不走代理。如果你用的是终端安装方式，先在终端执行：然后再执行安装命令。 Q：改错了东西怎么办？别慌！在 Claude Code 对话框里输入 /rewind，可以回退到之前的状态。或者直接告诉 Claude：「刚才的改动还原回去」。想更深入学习？这份教程帮你完成了最基础的安装和体验。如果你想深入学习 Claude Code 的更多玩法，推荐以下资源（都在 WaytoAGI 飞书知识库里）： • Claude Code 专区（系统化学习路径）：https://waytoagi.feishu.cn/wiki/LJbiwATadi72LUklHpgcexeSnNh • Claude Code 完整安装指南（详细版）：https://waytoagi.feishu.cn/wiki/MrfKwe3ApilsnvkaRyfcM1kEnmr • Claude Code 保姆级入门教程：https://waytoagi.feishu.cn/wiki/WZZRwjxAbiNow5ki0s6clQNLnsb • Claude Code 进阶：装这 9 个 Skill 才算真正上手：https://waytoagi.feishu.cn/wiki/CnfKwM4PzisrshkGH1Ycg3mYnAd 本教程整理自 WaytoAGI 社区知识库，感谢 Ben、老金、橘子等社区共建者的原始教程。这份教程专门写给「什么都不会」的你。不需要懂编程，不需要会用命令行，跟着做就行。一句话理解 Claude Code Claude Code 是一个装在电脑里的 AI 助手。你用大白话告诉它要做什么，比如「帮我整理桌面文件」、「帮我做个网页」、「分析这份表格数据」，它就会自己动手帮你完成。跟 ChatGPT 聊天不一样的是——Claude Code 不只是聊天，它能直接操作你的电脑文件。你需要准备什么？开始之前，确认你有这两样东西： • 一台电脑（Windows 或 Mac 都行） • 能上网就这些。其他的，下面一步步教你。第一步：安装 VS Code（免费的编辑器）为什么要装这个？因为 Claude Code 有一个「插件版」，装在 VS Code 里面就能用，完全不需要碰命令行。什么是 VS Code？ VS Code 是微软出品的一个免费软件，程序员用它来写代码。但你不用写代码，你只需要把它当作 Claude Code 的「家」——Claude Code 住在里面，你通过它跟 Claude 对话。怎么安装？ 1. 打开浏览器，访问：https://code.visualstudio.com/ 2. 点击页面上那个大大的蓝色「Download」按钮 3. 下载完成后，双击安装包，一路点「下一步」就行装完后打开它，你会看到一个深色背景的界面。别害怕，你只需要用到里面很小的一部分功能。第二步：安装 Git（必备的小工具） Git 是 Claude Code 运行时需要的一个基础工具。你不需要学会用它，只需要装上就行。 Windows 用户： 1. 打开浏览器，访问：https://git scm.com/install/windows 2. 点击「Git for Windows / x64 Setup.」下载 3. 双击安装，一路点「Next」默认安装即可，不需要改任何选项 4. 安装完成后，重启 VS Code（关掉再重新打开） Mac 用户： 1. 打开电脑上的「终端」应用（在「启动台」→「其他」文件夹里，或用 Spotlight 搜索「终端」） 2. 复制下面这行文字，粘贴到终端里，按回车： 1. 会弹出安装窗口，点击「安装」，等它装完 2. 装完后关闭终端第三步：安装 Claude Code 插件这一步超级简单： 1. 打开 VS Code