Claude Code 快速上手指南（新手友好版）

AI编程工具卷疯啦！而 Claude Code 凭借“任务驱动+终端原生”的神仙特性，成了很多开发者的效率搭子～它和传统代码补全工具（比如Copilot）不一样，不用装复杂的IDE插件，直接在终端里就能用，能自己规划任务、读代码、执行命令，甚至改文件，完美融入咱们日常开发的节奏。这篇教程就从基础到实操，手把手带新手快速上手，全程避坑，保证30分钟内你就能独立用起来！

一、Claude Code 介绍及核心优势

1.1 什么是 Claude Code

简单说，Claude Code 是 Anthropic 2025年推出的“AI编程小助手”，还是终端原生的那种～它不只是能生成、解释、优化代码，还能直接操作文件、运行Shell命令、管Git版本，甚至帮你配开发环境，从项目启动到上线，全程都能搭把手。比起其他AI编程工具，它不用依赖图形界面，就靠命令行操作，Windows、Mac、Linux都能兼容，不管是本地开发还是服务器操作，都能轻松hold住。

1.2 核心优势（新手必知，好记又实用）

和其他AI编程工具比，Claude Code 的优势真的很戳新手，主打一个“好用、灵活、不添乱”：

任务驱动，不用你多废话：不用一步步教它怎么做，只要说清楚目标（比如“帮我扫所有.py文件，把requests换成httpx，再更一下依赖”），它自己就会规划步骤、执行操作，省超多重复功夫。
终端原生，不打断你的思路：直接在终端里运行，和Git、npm、Docker这些咱们常用的工具无缝衔接，不用来回切换IDE，开发节奏不被打乱，习惯用终端的小伙伴会爱惨。
多模型兼容，想换就换：支持官方模型（Claude 4.6 Sonnet/Opus/Haiku），也支持国产大模型（DeepSeek、智谱GLM、阿里百炼等），国内小伙伴不用愁网络问题，想省成本、求稳定，换国产模型就好。
多语言支持，全能选手：Python、JavaScript、Java、Go这些主流编程语言都能搞定，生成代码、找Bug、修配置、管Git，一站式解决，不用再切换多个工具。
轻量易配置，新手无压力：安装步骤超简单，只要装个Node.js就够了，配置文件也很清晰，新手几分钟就能搞定初始化，还能自动更新，不用手动维护版本。

小补充：Claude Code 本身就像一个“工具框架”，能力强不强，全看你接入的大模型～海外顶级模型（比如Claude 4.6 Opus）适合搞复杂任务，国产模型日常编码完全够用，还便宜、网络稳，新手先从国产模型入手准没错。

1.3 Claude Code 安装与配置流程图

flowchart TD
    A[开始安装 Claude Code] --> B{检查 Node.js 版本}
    B -->|版本 >= 18.0| C[选择安装方式]
    B -->|版本 < 18.0| D[安装/升级 Node.js]
    D --> C

    C -->|官方脚本| E["curl -fsSL https://claude.ai/install.sh | bash"]
    C -->|npm 安装| F["npm install -g @anthropic-ai/claude-code"]
    C -->|Homebrew Mac| G["brew install --cask claude-code"]

    E --> H[验证安装: claude --version]
    F --> H
    G --> H

    H --> I{选择登录方式}
    I -->|官方账号| J["/login 登录 Anthropic 账号"]
    I -->|国产模型| K[配置环境变量切换模型]

    J --> L[开始使用]
    K --> M[编辑 settings.json]
    M --> N[配置 API Key 和 Base URL]
    N --> L

二、安装教程（官方+Windows/Mac专属，超详细）

安装前先做个小准备，确保你的设备满足要求、装好转需组件，避免安装一半卡壳哦～重点说明：Windows和Mac电脑均可以通过Node.js安装Claude Code，步骤通用且简单，具体操作如下。

2.1 安装前准备

要求项	具体说明
操作系统	Windows 10+（需Git Bash或WSL）、MacOS 13+
依赖组件	Node.js ≥ 18.0（必装）、Git 2.23+（推荐装）
硬件要求	RAM ≥ 8GB（保证运行不卡顿）

先验证下Node.js装没装对：打开终端（Windows用Git Bash/WSL，Mac直接用终端），输入 node -v，显示版本≥18.0就OK；没装或版本太低，按下面的方法来：

Mac：用Homebrew安装，终端输 brew install node 就行，很简单。
Windows：去 nodejs.org 下载LTS版本安装包，安装时记得勾选“Add to PATH”，这样会自动配置环境变量，不用手动弄。

2.2 Node.js通用安装Claude Code（Windows/Mac通用，推荐指令）

无论是Windows还是Mac电脑，在安装好Node.js（≥18.0版本）后，都可以通过npm命令快速安装Claude Code，优先使用官方规范指令，步骤统一，新手也能轻松操作：

打开终端（Windows用Git Bash/WSL，Mac直接用终端），输入npm官方安装命令，回车执行（贴合官方包命名规范，避免安装异常）：
npm install -g @anthropic-ai/claude-code
安装过程中若提示权限不足：Mac终端在命令前加 sudo（输入电脑密码即可）；Windows Git Bash以管理员身份运行终端后重试。
安装完成后验证：输入 claude --version，能显示版本号（比如v1.8.0），就说明通过Node.js安装成功啦。
补充说明：若上述官方指令安装失败，可尝试备用指令 npm install -g claude-code，两种指令均可完成安装，优先推荐官方规范指令。

2.3 官方推荐安装方式（通用款，稳就一个字）

Anthropic官方推荐的安装脚本，能自动处理依赖、配置环境，还能后台自动更新，不管是Mac还是Windows（Git Bash/WSL环境）都能用，新手优先选这个：

打开终端，复制下面的官方命令，粘贴进去回车执行：
curl -fsSL https://claude.ai/install.sh | bash
注意：访问 https://claude.ai/install.sh 可能出现“区域限制”提示（显示App unavailable），若无法执行该脚本，直接使用上述Node.js安装方式即可。
安装完验证一下：输入 claude --version，能显示版本号（比如v1.8.0），就说明装成功啦。

小提醒：如果Mac终端提示“权限不足”，就在命令前面加 sudo（输入电脑密码就行）；Windows的Git Bash要以管理员身份运行，不然容易出权限错误哦。

2.4 Mac 专属安装方式（Homebrew，懂的都懂）

如果你的Mac已经装了Homebrew，直接用它装更简洁，就是需要手动更版本，步骤如下：

终端输安装命令：
brew install --cask claude-code
验证安装：输入 claude --version，显示版本号就OK。
版本更新：定期输 brew upgrade claude-code，就能手动更到最新版本。

2.5 Windows 专属安装方式（两种可选，新手选第一种）

Windows用Claude Code，需要借助Git Bash或WSL（Windows Subsystem for Linux），两种方式，新手优先选第一种，简单快捷不踩坑。

方式一：Git Bash 安装（新手首选）

先装Git：去 git-scm.com 下载安装，记得勾选“Git Bash Here”选项，后续用着方便（Git是免费开源的分布式版本控制系统，适配终端操作）。
右键桌面，选择“Git Bash Here”打开终端，粘贴官方安装脚本执行：
curl -fsSL https://claude.ai/install.sh | bash
若脚本执行失败（区域限制），直接切换为Node.js安装方式，输入 npm install -g @anthropic-ai/claude-code 即可。
验证安装：输入 claude --version，显示版本号就成功啦。

方式二：WSL 安装（适合熟悉Linux的小伙伴）

先启用WSL：打开“设置→应用→可选功能→更多Windows功能”，勾选“适用于Linux的Windows子系统”，重启电脑生效。
在Microsoft Store搜“Ubuntu”，下载安装，打开Ubuntu终端，执行上面的官方安装脚本或Node.js安装命令（npm install -g @anthropic-ai/claude-code）就好。
验证安装后，就能在Ubuntu终端里用Claude Code啦。

小补充：如果安装失败，大概率是Node.js版本太低，或者终端没开管理员权限，重新装个≥18.0的Node.js，再用管理员身份运行终端重试，基本都能解决。

三、如何登录 Claude Code（两种方式，按需选）

Claude Code登录有两种玩法：官方账号登录（能用官方模型）、跳过登录（能用国产/第三方模型），新手根据自己的需求选，步骤都很简单，跟着来就行。

3.1 官方账号登录（推荐，能体验官方模型）

需要注册一个Anthropic账号（支持邮箱、Google账号），登录后能用官方模型，新账号一般有5美元免费额度，刚好用来体验功能：

打开终端，输入 claude 启动工具，这时右下角会显示“Not logged in · Run /login”（就是没登录的意思）。
在终端里输入 /login，回车，会自动弹出浏览器，跳转到Anthropic的登录页面。
注册或登录Anthropic账号（有账号直接登），登录后点“授权”，就能和终端绑定啦。
授权成功后，终端会提示“Login successful”，这就登录好啦，直接用官方模型写代码、做任务就行。

3.2 跳过登录（用国产/第三方模型，适合国内小伙伴）

如果不想用官方模型，或者访问不了Anthropic官网，直接跳过登录，配置一下环境变量就能用国产模型，步骤如下：

启动Claude Code后，要是显示没登录，按 Ctrl + C 退出当前界面就好。

在终端输入下面两条命令，创建配置文件，假装已经登录（跳过引导）：

mkdir -p ~/.claude && echo '{"hasCompletedOnboarding": true}' > ~/.claude.json
echo '{"primaryApiKey": "any-string"}' > ~/.claude/config.json

接下来配置国产模型的API环境变量（后面章节会详细说），配置好后，输入 claude 重新启动，就能正常用啦，不用登录。

小提醒：跳过登录后，就用不了官方模型了，只能用你配置好的国产/第三方模型哦。

四、如何切换国产大模型（国内小伙伴必看）

国内小伙伴用官方模型，可能会遇到网络不稳定、费用高的问题，而Claude Code能通过API兼容接口，轻松切换国产大模型（比如DeepSeek、智谱GLM、阿里百炼），步骤简单，还便宜、网络稳，新手也能轻松搞定。重点说明：Mac电脑切换国产模型时，需额外配置.zshrc文件，并修改settings.json中的对应开关，具体步骤如下。

4.1 切换前提（准备好这两样就行）

获取国产大模型的API Key和Base URL：去对应厂商官网注册账号（比如DeepSeek官网），注册后在控制台就能找到，很简单。
确保Claude Code已经装好了，而且已经跳过登录（登录后也不影响，切换后会优先用国产模型）。

4.2 通用切换步骤（以DeepSeek为例，其他模型也一样）

所有国产模型的切换逻辑都一样，核心就是配置环境变量或修改配置文件，两种方式，新手优先选第一种，临时生效，适合测试。其中Mac电脑需额外完成.zshrc配置和settings.json开关修改，Windows无需此操作。

方式一：环境变量配置（临时生效，重启终端就没了）

打开终端（Mac终端/Git Bash），输入下面的命令，把里面的内容换成你自己的DeepSeek API Key和Base URL：

Mac/Linux：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"

Windows Git Bash：

set ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
set ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"

注意：尝试访问 https://api.deepseek.com/v1 时出现“网页解析失败”，属于正常现象，无需手动访问该链接，只需确保配置的Base URL正确即可。
输入 claude 启动工具，这时就自动切换成DeepSeek模型了，输个指令（比如“写一段Python冒泡排序代码”）试试，能正常用就OK。

方式二：配置文件配置（永久生效，推荐）

修改Claude Code的全局配置文件，一次配置，以后都不用再改，重启终端也不影响。Windows和Mac步骤略有差异，重点注意Mac的额外配置：

Windows配置步骤

先创建全局配置文件夹（如果已经有了，直接跳过）：
mkdir -p ~/.claude
编辑配置文件 settings.json：
Windows Git Bash：终端输 nano ~/.claude/settings.json

在配置文件里输入下面的内容，把API Key换成你自己的（以DeepSeek为例）：

{
     
  "env": {
     
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/v1"
  },
  "permissions": {
     
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

保存退出：按 Ctrl + O 保存，再按 Ctrl + X 退出编辑就好。
重启Claude Code（输入 claude），这样就永久切换成国产模型啦。

Mac配置步骤（需额外配置.zshrc和settings.json开关）

先创建全局配置文件夹（如果已经有了，直接跳过）：
mkdir -p ~/.claude

编辑配置文件 settings.json，并修改关键开关：
Mac终端输 nano ~/.claude/settings.json，输入以下内容（重点添加"useCustomApi": true开关，启用自定义API，即国产模型），并替换自己的API Key：

{
     
  "env": {
     
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/v1"
  },
  "useCustomApi": true,
  "permissions": {
     
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

保存退出settings.json：按 Ctrl + O 保存，再按 Ctrl + X 退出编辑。
配置.zshrc文件（Mac专属，永久生效环境变量）：
终端输 nano ~/.zshrc，在文件末尾添加以下内容（替换成自己的API Key和Base URL）：
```
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_AUTH_TOKEN="你的DeepSeek API Key"
```
生效.zshrc配置：终端输 source ~/.zshrc，让配置立即生效（无需重启终端）。
重启Claude Code（输入 claude），即可永久切换成国产模型。

4.3 其他国产模型切换参考（直接抄作业）

不用重新学步骤，只要把配置文件里的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 换掉，就能切换其他国产模型，常用的给大家整理好啦：

智谱GLM：Base URL = "https://open.bigmodel.cn/api/paas/v4"，API Key 去智谱AI官网控制台找就行（注：访问该Base URL时会出现“网页解析失败”，无需手动访问，配置正确即可）。
阿里百炼：Base URL = "https://dashscope.aliyuncs.com/compatible-mode/v1"，API Key 在阿里云百炼控制台获取（注：访问该Base URL时会出现“网页解析失败”，无需手动访问，配置正确即可）。

小提醒：不同国产模型的API接口可能有点不一样，要是出现调用失败的情况，去对应厂商的API文档看看，调整一下Base URL格式就好。另外，目前DeepSeek、智谱GLM、阿里百炼的对应API页面暂无法正常解析，建议直接前往对应厂商官网，在控制台获取正确的API信息及使用说明。Mac电脑若切换后无法使用，可检查.zshrc配置是否生效，以及settings.json中的useCustomApi开关是否设为true。

五、常用命令与使用技巧（新手必记，省时间）

Claude Code的命令分两类：终端启动命令（启动时用）和斜杠命令（交互界面里用），掌握下面这些常用的，能省超多时间，新手先记核心的就好，不用死记硬背。

5.1 核心终端启动命令（记4个就够了）

命令	用途（直白好记）	示例
claude	启动工具，进入交互模式	claude
claude --version	查看当前工具版本	claude --version
claude -c	继续上一次没结束的会话	claude -c
claude --print "指令"	单次执行指令，执行完就退出	claude --print "写一段Python循环代码"

5.2 高频斜杠命令（交互界面用，记10个核心）

启动Claude Code（输入claude）后，输/就能看到所有命令，下面这10个新手必记，日常用得最多：

/login：登录Anthropic官方账号（想切换官方模型就用它）。
/init：项目初始化，在当前目录生成CLAUDE.md文件，把项目技术栈、代码规范写进去，它会一直记住，不用每次都重复说。
/model：切换官方模型（只有登录后能用），输/model sonnet就能切换到Sonnet模型，日常编码用这个最顺手。
/compact：压缩上下文，会话太长、快满的时候用，能回收空间，还不丢核心任务信息。
/clear：清空对话历史，想换个任务就用它，从零开始，比/compact更彻底。
/cost：查看当前会话的Token消耗和费用（只有官方模型能用），避免用超了花钱。
/context：查看上下文占用情况（百分比），建议到70%-80%就用/compact，避免溢出。
/diff：查看它改了哪些文件（和Git diff差不多），方便核对修改内容，避免改错。
/status：查看当前配置状态，比如Base URL、API Key对不对，排查问题超好用。
/exit：退出交互界面，回到终端。

5.3 实用使用技巧（新手避坑，少走弯路）

上下文管理技巧：长会话里，每完成一个任务，就用/compact压缩一下，省Token；换任务就用/clear重置，响应更快。
文件引用技巧：想让它分析某个文件，直接用@文件名（比如“分析@src/user.js的代码逻辑”），它会直接读文件，不用你手动粘贴代码，超方便。
权限控制技巧：修改settings.json配置文件，用permissions字段限制它的操作，比如禁止读.env敏感文件、禁止执行rm -rf *危险命令，更安全。
国产模型优化技巧：用国产模型时，指令说具体点（比如“写一段Python冒泡排序，注释详细点，兼容Python3.8+”），生成的代码更符合预期；要是报错，直接把错误信息发给它，让它修复就好。Mac用户若报错，优先检查.zshrc配置和settings.json开关。
版本更新技巧：官方安装的会自动更，Homebrew装的要手动输brew upgrade claude-code，Node.js安装的输npm update -g @anthropic-ai/claude-code（对应官方安装指令），定期更新能修复Bug、加新功能。
问题排查技巧：启动不了、调用不了模型，先输/status查配置，确认API Key和Base URL没错；网络报错，就检查国产模型的API能不能用，或者换个网络。

六、新手常见问题解决（遇到问题不用慌）

安装失败，提示“curl: command not found”：Windows装个Git Bash（自带curl），Mac要是没有curl，输brew install curl装一个就行。
启动后提示“Not logged in”，用不了：想用官方模型，就输/login登录；想用国产模型，按“跳过登录”的步骤配置，再重启工具就好。
切换国产模型后，调用失败：先检查API Key和Base URL对不对，再去对应厂商官网看看API接口是不是正常的。Mac用户额外检查.zshrc配置是否生效、settings.json中useCustomApi开关是否开启。
会话中响应很慢：输/compact压缩上下文，或者换个轻量点的模型（比如Haiku、国产基础模型），减少Token消耗，速度就快了。

七、总结（新手必看）

Claude Code 作为终端原生的AI编程工具，最大的好处就是“能自己干活、还灵活”，新手只要掌握“安装→登录/配置→常用命令”这三步，就能快速上手。重点记住：Windows和Mac均能通过Node.js安装Claude Code，推荐使用官方规范指令 npm install -g @anthropic-ai/claude-code；Mac切换国产模型需额外配置.zshrc文件，并开启settings.json中的useCustomApi开关。建议新手先从国产模型开始用，网络稳、成本低，熟悉操作和常用命令后，再试试官方模型，体验更复杂的功能。

这篇教程把新手必备的操作都讲透了，全程避坑，只要跟着步骤来，30分钟内就能独立用它提升编程效率～后续大家可以根据自己的需求，探索更多高级功能（比如MCP协议扩展、Hook自动化），让这个小助手发挥更大作用！

Claude Code 快速上手指南（新手友好版）

Claude Code 快速上手指南（新手友好版）

一、Claude Code 介绍及核心优势

1.1 什么是 Claude Code

1.2 核心优势（新手必知，好记又实用）

1.3 Claude Code 安装与配置流程图

二、安装教程（官方+Windows/Mac专属，超详细）

2.1 安装前准备

2.2 Node.js通用安装Claude Code（Windows/Mac通用，推荐指令）

2.3 官方推荐安装方式（通用款，稳就一个字）

2.4 Mac 专属安装方式（Homebrew，懂的都懂）

2.5 Windows 专属安装方式（两种可选，新手选第一种）

方式一：Git Bash 安装（新手首选）

方式二：WSL 安装（适合熟悉Linux的小伙伴）

三、如何登录 Claude Code（两种方式，按需选）

3.1 官方账号登录（推荐，能体验官方模型）

3.2 跳过登录（用国产/第三方模型，适合国内小伙伴）

四、如何切换国产大模型（国内小伙伴必看）

4.1 切换前提（准备好这两样就行）

4.2 通用切换步骤（以DeepSeek为例，其他模型也一样）

方式一：环境变量配置（临时生效，重启终端就没了）

方式二：配置文件配置（永久生效，推荐）

Windows配置步骤

Mac配置步骤（需额外配置.zshrc和settings.json开关）

4.3 其他国产模型切换参考（直接抄作业）

五、常用命令与使用技巧（新手必记，省时间）

5.1 核心终端启动命令（记4个就够了）

5.2 高频斜杠命令（交互界面用，记10个核心）

5.3 实用使用技巧（新手避坑，少走弯路）

六、新手常见问题解决（遇到问题不用慌）

七、总结（新手必看）

千问大模型

热门文章

最新文章

相关电子书