Claude Code 小白上手教程

告别繁琐的复制粘贴，在终端里用自然语言直接操控你的代码库。

> 面向中文开发者 · 零基础入门 · 2026.07

---

一、Claude Code 是什么？

**Claude Code** 是 Anthropic 官方推出的基于终端（CLI）的 AI 编程助手。它不是你在网页上常见的聊天框——它直接运行在你的项目目录中，能读取你的整个代码库、修改文件、运行命令、甚至帮你提交 Git 代码。

简单说：你在终端里跟它说话，它帮你写代码。

• **Agent 架构**：不像 Web 端那样只能一问一答，Claude Code 有"自主行动"能力——你说"帮我修这个 bug"，它会自己去读代码、定位问题、修改文件、运行测试确认修复。
• **项目理解**：它能一次性看到你的整个项目结构，而不是像 ChatGPT 那样只能一段段粘贴代码。
• **终端原生**：直接在命令行工作，和 Git、npm、测试框架等工具无缝配合。

• > **一句话总结：** Claude Code = 能看懂你整个项目的 AI 程序员同事，坐在你的终端里随叫随到。

  ---

  二、安装与环境配置

  2.1 前提条件

• **Node.js** v18+（安装 Node 时会自动带上 npm）
• **Git**（Claude Code 大量依赖 Git 来理解代码变更）
• 一个 **Anthropic 账号**（用 Google 账号或邮箱注册即可）

• 没有 Node.js？去 [nodejs.org](https://nodejs.org) 下载 LTS 版本安装即可。

  2.2 安装 Claude Code

  打开终端（Mac 的「终端」或 Windows 的 PowerShell），执行：

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

  安装完成后验证：

  claude --version

  如果显示了版本号，就说明安装成功了。

  2.3 身份认证

  首次使用需要登录你的 Anthropic 账号：

  claude auth

  终端会弹出一个链接，用浏览器打开它、登录授权即可。整个过程不需要手动填 API Key。

  > ⚠️ **关于费用：** Claude Code 按消耗的 Token 量计费。注册 Anthropic 账号后会赠送一些免费额度试用。建议在 [Anthropic Console](https://console.anthropic.com) 的 Billing 页面设置好预算上限（Usage Limits），避免超额。

  ---

  三、基本使用流程

  3.1 启动

  进入你的项目目录，然后输入：

  cd 你的项目路径
  claude

  这时终端会进入 Claude Code 的交互界面，你会看到提示符变成了 ▎，表示它已经准备好听你指令了。

  3.2 第一次对话

  像跟人说话一样自然就好。例如：

• `这个项目的入口文件在哪里？`
• `解释一下 src/utils.js 的作用`
• `帮我看看 package.json 里有哪些依赖`

• Claude 会读取文件并给你清晰的回答。

  3.3 权限确认机制

  当 Claude Code 要修改文件或执行命令时，它不会擅自行动——终端会弹出 [y/N] 确认提示，并告诉你它打算做什么：

  
  ? Claude 想要修改文件 src/App.tsx
    - 在第 15 行添加一个 email 校验函数
    允许执行？(Y/n)

  **小白建议：** 刚开始使用时，仔细读一遍它要改什么，确认没问题再敲回车。这个机制是个安全防护网。

  3.4 退出

  输入 /exit 或按 Ctrl + D 即可退出。

  > **小技巧：** 不需要每次退出了再进。直接在下一次终端输入新的指令即可，Claude 会记住当前会话的上下文。

  ---

  四、常用命令与快捷键

  Claude Code 提供了一些内置的斜杠命令，快速完成常见操作：

  | 命令 | 作用 |

  |------|------|

  | /bug | 扫描当前项目，自动检测并修复潜在的 Bug |

  | /review | 对当前未提交的代码变更做 Code Review |

  | /test | 自动编写或运行项目的单元测试 |

  | /clear | 清空对话历史，释放上下文（省 Token 的好方法） |

  | /help | 查看帮助文档和所有可用命令 |

  | /exit | 退出 Claude Code |

  常用快捷键：

• **Ctrl + C**：取消当前操作
• **Ctrl + D**：退出交互界面
• **↑/↓**：浏览历史命令

• ---

  五、实战技巧

  5.1 提问要精准

  好指令 = 动词 + 目标 + 约束条件：

  > ❌ **不要这样问：** "帮我加个邮箱校验"

  >

  > ✅ **要这样问：** "在 src/utils/validation.ts 中添加一个邮箱格式校验函数 isValidEmail，用正则实现，并用 Jest 写 3 个测试用例：正常邮箱、缺少 @ 的邮箱、空字符串。"

  越精确，Claude 给你的代码就越接近你想要的结果。

  5.2 利用 Git 联动

  修改完代码后，可以直接说：

  
  帮我把刚才的修改提交到 Git，写一个规范的 Commit Message。

  Claude Code 会自动执行 git add 和 git commit，并根据变更内容生成有意义的提交信息。

  5.3 复杂任务分步走

  遇到比较大的需求（比如"给博客加个评论功能"），先让 Claude 出方案：

  
  我想给博客添加评论功能，请先给出技术方案和实现步骤。

  看完方案确认没问题后，再说：

  
  好的，按步骤 1 开始实现。

  这种"先计划，再执行"的方式比让它一口气做完要可控得多。

  5.4 省 Token 小技巧

• 定期使用 `/clear` 清空对话历史（旧的上下文会一直消耗 Token）
• 在项目根目录配置好 `.claudeignore` 文件，排除 `node_modules`、大日志文件等不必要的目录
• 问完一个问题后如果不需要上下文了，果断 `/clear`

• ---

  六、新手避坑指南

  6.1 永远要审查 AI 写的代码

  Claude 写代码速度快，但它也会犯错——逻辑漏洞、安全隐患、不合理的架构决策都有可能。任何 AI 生成的代码，**必须**经过你运行和验证，才能上线。

  一个好的习惯：让 Claude 帮你写完代码后，用 /review 命令再让它自己审查一遍。

  6.2 注意 Token 消耗

  避免在包含超大文件的项目里直接抛出模糊问题。比如在一个有 100 万行日志文件的项目中问"帮我看看有什么问题"——Claude 会试图读完整个文件，Token 飞涨。建议先用 .claudeignore 排除大文件。

  6.3 保护敏感信息

  不要在对话中粘贴 API Key、数据库密码、.env 文件内容等敏感信息。确保 .env、*.pem 等敏感文件已被 .gitignore 忽略——这些规则同样适用于 Claude Code 的读取范围。

  6.4 分清楚"问"和"做"

  Claude Code 是执行型工具，不是纯问答工具。纯聊天问问题（比如"React 和 Vue 的区别"）更适合用 Web 版 Claude，省 Token 且不影响你的项目上下文。Claude Code 最适合的是**直接操作项目代码**的场景。

  > **核心建议：** 把 Claude Code 当成你的结对编程伙伴。它擅长执行具体任务，你负责制定方向、审查结果、做关键决策。

  ---

  写在最后

  AI 不会取代程序员，但会用 AI 的程序员一定会取代不用 AI 的程序员。Claude Code 拉近了"想到"和"做到"之间的距离，让你可以把精力更多地花在思考和设计上，而不是在繁琐的实现细节里打转。

  现在就打开终端试试吧：

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

  别担心犯错——反正有 AI 帮你兜底。