🌱 初级教程 - 入门篇

适合：完全没有使用过 Claude Code 的新手

---

📦 第一步：安装必备软件

💡 2026 年新增安装方式

Claude Code 现在支持原生安装（无需 Node.js）和桌面应用！

• 原生安装：curl -fsSL https://claude.ai/install.sh | bash
• Homebrew：brew install --cask claude-code
• 桌面应用：从 claude.ai 下载

以下 npm 安装方式仍然可用，但推荐使用原生安装。

💡 安装顺序

安装 Claude Code 需要按以下顺序：

1. Node.js（包含 npm 包管理器）
2. Git（版本控制工具）
3. Claude Code（通过 npm 安装）

Windows 系统

1. 安装 Node.js（自带 npm）

下载 Node.js（选择 LTS 版本）：

• 官网：https://nodejs.org/zh-cn
• 国内镜像：https://npmmirror.com/mirrors/node/

运行安装包，一路点击「下一步」完成安装。

验证安装：

node -v    # 应显示 v20.x.x 或更高（推荐 LTS 版本）
npm -v     # 应显示 npm 版本号

2. 安装 Git

下载 Git：

• 官网：https://git-scm.com/download/win
• 国内镜像：https://npmmirror.com/mirrors/git-for-windows/

运行安装包，使用默认选项即可。

验证安装：

git --version

3. 设置 PowerShell 执行策略

🔒 重要

以管理员身份运行 PowerShell，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。

4. 配置 npm 国内镜像

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

🎬 配置 npm 国内镜像演示

npm config set registry https://registry.npmmirror.com✓ npm registry 已配置为国内镜像！后续安装速度将显著提升。

⚠️ 安装前必做

如果跳过第3步的 PowerShell 执行策略设置，安装时会报错：

claude.ps1 cannot be loaded because running scripts is disabled

请确保已以管理员身份执行过 Set-ExecutionPolicy 命令！

5. 安装 Claude Code

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

6. 验证安装

claude --version

🎬 安装验证演示

node -vv20.18.0npm -v10.8.2git --versiongit version 2.43.0claude --versionclaude-code v2.1.38✓ 所有组件安装成功！

---

macOS 系统

1. 安装 Homebrew（如已安装可跳过）

/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

2. 安装 Git

brew install git

3. 安装 Node.js 和 npm（二选一）

💡 说明

npm 是 Node.js 自带的包管理器，无需单独安装。安装 Node.js 后自动获得 npm。

方法 A：使用 nvm 安装（推荐）

nvm 是 Node 版本管理器，可以方便地安装和切换不同版本的 Node.js。

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载终端配置（根据你使用的 shell 选择一个）
source ~/.zshrc     # 如果使用 zsh（macOS 默认）
# 或
source ~/.bashrc    # 如果使用 bash

找不到 nvm 命令？

如果提示 nvm: command not found，请手动将以下内容添加到 ~/.zshrc 或 ~/.bashrc 文件末尾：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

然后重新打开终端窗口。

# 使用 nvm 安装 Node.js 20
nvm install 20

# 设置默认版本
nvm alias default 20

# 验证安装
node -v    # 应显示 v20.x.x
npm -v     # 应显示 npm 版本号

方法 B：使用 Homebrew 直接安装（简单）

brew install node@20

# 如果提示需要添加到 PATH，执行：
echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 验证安装
node -v    # 应显示 v20.x.x
npm -v     # 应显示 npm 版本号（如 10.x.x）

4. 配置 npm 国内镜像

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

5. 安装 Claude Code

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

6. 验证安装

claude --version

---

Linux 系统（Ubuntu/Debian）

1. 安装 Node.js（自带 npm）和 Git

sudo apt-get update
sudo apt-get install -y git
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 配置 npm 国内镜像

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

3. 安装 Claude Code

sudo npm install -g @anthropic-ai/claude-code

4. 验证安装

claude --version

---

🌐 第二步：配置 API

💡 好消息

使用第三方 API 服务，国内用户无需翻墙即可使用 Claude Code！

国内使用 Claude Code 有两种方式：

方式	是否需要翻墙	推荐程度	说明
方式一：第三方 API	❌ 不需要	⭐⭐⭐ 推荐	注册平台获取 API，简单快捷
方式二：官方 API	✅ 需要	⭐	需配置科学上网，步骤较多

---

方式一：使用第三方 API（推荐，无需翻墙）

这是最简单的方式，只需两步：

1. 注册一个 API 服务平台
2. 使用 CC-Switch 管理 API

第 1 步：注册 API 服务平台

以下平台提供 Claude API 服务，注册即可获得免费额度：

平台	注册地址	注册奖励	API 地址
Code Relay	https://api.code-relay.com/register?aff=fwDp	125 美元	https://api.code-relay.com
MegaLLM	https://megallm.io/ref/REF-ZXLXHWRD	125 美元	https://ai.megallm.io
88Code	https://www.88code.ai/register?ref=UNHFWN	加群领取	https://api.88code.ai
pincc.ai	https://pincc.ai/	CRS 官方拼车	注册后获取

想自建服务？

如果你想自己搭建 Claude API 中继服务，请参考 高级教程 - 自建 CRS

第 2 步：安装 CC-Switch 管理 API

CC-Switch 是一个可视化的 API 管理工具，可以：

• 一键切换不同 API 服务
• 可视化管理多个平台账号
• 无需手动配置环境变量
• 方便对比不同平台效果

Windows：

1. 访问 https://github.com/farion1231/cc-switch/releases
2. 下载 cc-switch-windows-amd64.exe
3. 双击运行即可

macOS：

# 使用 Homebrew 安装（如果可用）
brew install farion1231/tap/cc-switch

# 或手动下载
curl -LO https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-darwin-amd64
chmod +x cc-switch-darwin-amd64
sudo mv cc-switch-darwin-amd64 /usr/local/bin/cc-switch

Linux：

curl -LO https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-linux-amd64
chmod +x cc-switch-linux-amd64
sudo mv cc-switch-linux-amd64 /usr/local/bin/cc-switch

使用方法

1. 运行 cc-switch
2. 添加 API 服务商（如 Code Relay、MegaLLM）
3. 填入 API 地址和 API Key
4. 选择要使用的服务商
5. 启动 Claude Code，自动使用选中的 API

添加 API 服务示例

服务商	API 地址
Code Relay	https://api.code-relay.com
MegaLLM	https://ai.megallm.io
88Code	https://api.88code.ai

👉 项目地址：https://github.com/farion1231/cc-switch

---

方式二：使用官方 API（需要翻墙）

如果你希望直接使用 Anthropic 官方 API，或者需要访问 claude.ai 网站，则需要配置科学上网。

点击展开科学上网配置步骤

1. 安装 Clash Verge

下载 Clash Verge Rev（推荐 v2.4.4 最新版）：

💡 v2.4.4 更新：Mihomo 内核升级、支持自动备份、连接排序等

• GitHub：https://github.com/clash-verge-rev/clash-verge-rev/releases/

根据你的系统下载对应版本：

• Windows: Clash.Verge_x64-setup.exe
• macOS: Clash.Verge_x64.dmg
• Linux: clash-verge_amd64.deb

2. 获取订阅链接

推荐机场（付费，稳定）：

• 👉 https://w1.soxo.top/auth/register?code=k87a

个人节点（需要密码）：

• 👉 https://us-lax02.107-173-127-103.sslip.io/clash/

访问上述链接，按页面说明获取适合你的订阅配置。

3. 导入并启用

1. 打开 Clash Verge
2. 点击「订阅」→「导入」→ 粘贴订阅链接
3. 点击「更新」下载节点
4. 开启「系统代理」
5. 选择「规则模式」（自动区分国内外流量）

4. 验证配置

打开浏览器访问以下网站，都能正常打开说明配置成功：

• https://www.google.com
• https://claude.ai

---

技术交流社区

👉 https://linux.do

这是一个程序员与 AI 爱好者社区，有大量：

• 大模型使用分享
• 免费资源汇总
• 技术问答交流

---

⚠️ 第三步：养成好习惯

🚨 新手必读

以下三个习惯能帮你避免 90% 的问题，请务必养成！

1. 每个项目必须有独立目录

错误做法：在桌面或下载文件夹直接运行 Claude Code

正确做法：

# 创建项目专用目录
mkdir ~/projects/my-app
cd ~/projects/my-app

# 然后再启动 Claude Code
claude

为什么重要：

• Claude Code 会修改当前目录的文件
• 没有独立目录，可能误改其他重要文件
• 便于后续备份和版本管理

2. 开始前先用 Git 备份

这是最重要的习惯！ 有了 Git，你可以随时恢复到之前的状态。

# 进入项目目录后，首先初始化 Git
cd ~/projects/my-app
git init
git add .
git commit -m "初始状态"

# 然后再启动 Claude Code
claude

每次重要修改后：

git add .
git commit -m "描述这次修改"

💡 小技巧

让 Claude Code 帮你提交：直接说「请帮我提交代码」

🎬 Git 备份演示

cd ~/projects/my-appgit initInitialized empty Git repository in ~/projects/my-app/.git/git add .git commit -m "初始状态"[main (root-commit) a1b2c3d] 初始状态 3 files changed, 100 insertions(+)✓ 代码已备份，可以安心使用 Claude Code 了！

3. 出错后如何恢复

Claude Code 修改出错了？别慌，有多种恢复方法：

方法一：按两次 Esc（最快）

连续按两次 Esc 键，Claude Code 会回退到上一个检查点。

方法二：使用 Git 恢复（推荐）

# 查看修改了哪些文件
git status

# 放弃所有未提交的修改，恢复到上次提交
git checkout .

# 如果已经提交了错误的代码，回退到上一个提交
git reset --hard HEAD~1

方法三：使用 /rewind 命令

# 在 Claude Code 中输入
/rewind

⚠️ 注意

如果没有用 Git 备份，也没有检查点，修改可能无法恢复！ 所以一定要养成先备份的习惯。

🎬 Git 恢复演示

git statusmodified: src/app.jsmodified: src/utils.jsgit checkout .Updated 2 paths from the indexgit statusnothing to commit, working tree clean✓ 已恢复到上次提交的状态！

---

🚀 第四步：开始使用

🎬 操作演示

下面是一个完整的操作流程演示：

cd ~/Desktopmkdir fourier-democd fourier-demogit initInitialized empty Git repository in ~/Desktop/fourier-demo/.git/claude╭─────────────────────────────────────────────────╮│ Welcome to Claude Code! ││ /help for commands, /exit to quit │╰─────────────────────────────────────────────────╯claude > 帮我做一个傅里叶变换的演示动画好的，我来创建一个傅里叶级数可视化动画...✓ 已创建 index.html (傅里叶变换可视化)

🎯 查看实际效果

上面演示中创建的傅里叶动画已部署在线：点击查看效果

启动 Claude Code

cd 你的项目目录
claude

首次运行会提示登录或配置 API Key。

基本对话

启动后，直接用中文和 Claude 对话：

> 这个项目是做什么的？
> 帮我写一个 hello world 函数
> 帮我提交代码

---

📝 必会命令

启动命令

命令	说明
claude	启动新会话
claude -c	继续上次对话（最常用！）
claude -r	选择历史会话恢复

🎬 启动命令演示

claude╭─────────────────────────────────────────────────╮│ Welcome to Claude Code! │╰─────────────────────────────────────────────────╯claude > /exitGoodbye!claude -cResuming previous conversation...✓ 已恢复上次对话！

会话内命令

命令	说明
/help	查看帮助
/exit	退出 Claude Code
/clear	清空对话历史
/cost	查看费用消耗
/compact	压缩对话历史

快捷键

快捷键	说明
Ctrl+C	中断当前操作
Esc Esc	回退到检查点
↑ / ↓	浏览历史输入

---

💡 新手常见问题

Q: 安装失败怎么办？

尝试以管理员身份运行，或使用 --force 参数：

npm install -g @anthropic-ai/claude-code --force

Q: 提示权限错误（Windows）？

执行以下命令：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Q: 如何继续上次的对话？

使用 claude -c 命令。

Q: 如何撤销 Claude 的修改？

按两次 Esc 键，会回退到上一个检查点。

Q: API 连接失败？

1. 检查科学上网是否开启
2. 检查 API Key 是否正确配置
3. 尝试更换 API 服务平台

---

📚 初级推荐阅读

• Claude Code 完整指南
• 常见问题解答

---

🎯 学完初级后

掌握了基本安装和使用后，可以进入 中级教程 学习更多技巧！