Claude code 小白保姆级入门教程

1.1 什么是 Claude Code

Claude Code 是 Anthropic 推出的系统级 AI Agent。它不只是“帮你补代码”的聊天工具，而是可以在终端和项目环境里完成读文件、写代码、执行命令、分析项目、调用外部工具等任务的执行型助手。

1.2 关键能力

1.3 与传统开发工具的区别

1.4 适合的使用场景

• •进入一个陌生仓库，先读结构再给出修改方案
  
• •让 AI 直接执行测试、修复问题并汇报结果
  
• •配合外部工具完成浏览器、GitHub、数据库等操作
  
• •把常见任务沉淀成可复用技能和自动化流程
  

2.1 前置准备

在安装 Claude Code 前，至少准备这些基础条件（看一遍即可）：

按照系统选择安装安装node和git的命令

macOS 终端

Homebrew 官方安装命令如下；Homebrew 默认会装到 Apple Silicon 的 /opt/homebrew，Git 官方也把 brew install git 作为 macOS 的安装方式之一。

代码块Plain Text复制

Windows 终端（PowerShell / CMD）

Microsoft 的 WinGet 文档说明可以用 winget install 安装应用；Git for Windows 官方安装页给出的命令是 winget install --id Git.Git -e --source winget。

代码块Plain Text复制

2.2 安装 Claude Code

macOS 终端

代码块Bash复制

或者：

代码块Plain Text复制brew install --cask claude-code

Windows 终端

步骤 1：配置环境变量Claude Code 需要通过环境变量找到 git-bash。设置环境变量 CLAUDE_CODE_GIT_BASH_PATH

• •变量名：CLAUDE_CODE_GIT_BASH_PATH
  
• •变量值：git-bash 路径（如 C:\Program Files\Git\bin\bash.exe）
  

1. 1.按下 Win + R，输入 sysdm.cpl，回车打开「系统属性」
   
2. 2.切换到「高级」选项卡，点击「环境变量」
   
3. 3.在「用户变量」区域点击「新建」：
   
4. 1.点击「确定」保存所有设置验证环境变量配置关闭所有已打开的终端/程序，重新打开 CMD，执行以下命令：
   

代码块Plain Text复制

步骤 2：创建配置目录（可选但推荐）Claude Code 会使用用户目录下的 .claude 文件夹作为配置目录。打开 CMD，执行以下命令自动创建：

代码块Bash复制if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

步骤 3：安装 Claude Code配置 npm 镜像（可选，加速下载）如果 npm 下载速度慢，可配置淘宝镜像：

代码块Bash复制

安装命令打开 CMD 或 PowerShell，执行以下命令：

代码块Bash复制

-g 参数表示全局安装，推荐。

安装成功后，会看到类似以下输出：

代码块Go复制added 2 packages in 4s1 package is looking for funding  run `npm fund` for details

2.3 配置账号或模型

唯一的门槛，就是搞定一个能在 Claude code 里用的账号。可以这样理解 Claude code：它是一个工具，Claude code 和大模型的关系，就像手机和运营商的关系。你的手机可以选电信、联通、移动，都能打电话上网， Claude code 就相当于手机，大模型就相当于运营商，你可以在 Claude code 使用各种模型，你只需要为大模型付费。Claude 官方会直接封中国用户的账号，所以使用官方账号门槛很高。推荐使用中转方案，或者用国产大模型平替。如何选择？

• •如果追求效果最好，选中转；
  
• •如果追求简单方便，选国产大模型。
  

方案 1：使用 cc Switch 配置

Cc Switch 是一个社区工具，可用于管理兼容 Anthropic API 网关的本地配置。它不是 Claude Code 官方组件；如果你走官方登录或官方 API key 路径，通常不需要它。Windows 版本：

安装的时候，会弹出来安全确认，点击「更多信息」，即可继续安装

Mac 版本：

注意：由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开。

cc Switch：https://github.com/farion1231/cc-switch

下载安装：https://github.com/farion1231/cc-switch/releases

如何配置：Claude Code 配置指南：快速完成 claude code 配置避坑经验

如何判断账号是否配置成功：

• •点开 claude code，和它说句话，它如果正常回应你，说明配置成功！
  

方案2：手动配置(通用方式)

手动配置适用于兼容 Anthropic API 的网关或代理场景；如果你直接使用官方 Anthropic 账号 / API，请优先参考官方登录或官方 API key 配置方式。Windows（网关场景）:

代码块Plain Text复制

Bash（Linux / macOS）:

代码块Bash复制export ANTHROPIC_BASE_URL=https://your-gateway.example.comexport ANTHROPIC_AUTH_TOKEN=your-token

Zsh（macOS 默认）:

代码块Bash复制

2.4 启动方式

基础启动：

代码块Bash复制

跳过权限确认的高风险模式：

代码块Bash复制

非交互式 / Headless 用法示例：

代码块Bash复制git diff | claude -p "解释这些更改"

这一部分是 Claude Code 的真正门槛。装好 CLI 只是开始，理解这些概念后，才能把它当成一个可扩展 Agent 来使用。

3.1 Skills

Skills 可以理解成“预封装工作流”。它们像一次性调用的技能包，能把一类任务的做法固化下来，并在需要时按指令触发。常见分类：

查看 Skills 的方式有两种：

• •先运行 claude 进入交互会话，再输入 /skills
  
• •直接运行 claude /skills，它会启动交互会话并立即打开 skills 列表以及通过安装器引入现成技能，例如前端设计、文档协同、PDF 处理等。核心价值：
  
• •把常见任务固化为可复用流程
  
• •降低重复提示词成本
  
• •在复杂项目里减少上下文消耗
  

3.2 Hooks

Hooks 是事件驱动脚本。它们会在特定节点自动执行，用于拦截危险操作、自动格式化、记录日志或发送通知。常见事件包括：

配置文件通常放在：

• •~/.claude/settings.json
  
• •.claude/settings.json
  
• •.claude/settings.local.json其中 PreToolUse 和 PostToolUse 通常会配合 matcher 使用，例如 Bash、Edit|Write 等；UserPromptSubmit、Notification、Stop 这类事件则不依赖工具 matcher。实战里最常见的做法，是在写入或编辑文件后自动执行格式化或校验命令，这样能显著减少 CI 里的格式问题。
  

3.3 Plugins

Plugin 是更大的扩展单元。它不只是一条工作流，而是可以同时打包多个 Skills、斜杠命令、MCP 配置、Subagents 和 Hooks。可以把它理解为：

• •Skill：解决单一任务
  
• •Plugin：交付一整套能力组合常见来源包括官方技能库、插件市场和社区精选目录。安装方式既可以从市场安装，也可以从本地目录或 GitHub 仓库安装。
  

3.4 MCP Servers

MCP 是 Model Context Protocol。它的作用是让 Claude Code 接入外部资源和服务，例如浏览器、GitHub、数据库、文件系统或搜索服务。文章给出的常见 MCP 示例包括：

• •Chrome DevTools MCP
  
• •GitHub MCP
  
• •PostgreSQL MCP
  
• •Filesystem MCP
  
• •Web Search MCP典型安装方式：
  

代码块Bash复制claude mcp add chrome-devtools npx chrome-devtools-mcp@latest

也可以直接在 ~/.claude/mcp.json 里配置多个 MCP Server。核心意义在于：Claude Code 不再只依赖本地文件和终端，而是能通过统一协议扩展成一个更完整的执行系统。

3.5 Subagents

Subagents 是可以并行工作的子代理。每个子代理都有自己的上下文和职责，可以把复杂任务拆分后同时推进。适合的拆分方式：

• •一个代理做代码审查
  
• •一个代理写测试
  
• •一个代理补文档
  
• •一个代理做性能检查这样主代理负责拆解和汇总，子代理负责各自领域的执行。常见管理方式包括：
  
• •通过 /agents 交互式管理
  
• •在 .claude/agents/ 或 ~/.claude/agents/ 下创建带 YAML frontmatter 的 Markdown 文件来声明子代理
  

3.6 CLAUDE.md

CLAUDE.md 可以理解成项目记忆文件。它记录项目结构、常用命令、技术栈、团队规范和架构决策，让 Claude Code 更快进入项目上下文。这类文件通常适合记录：

• •项目概述与目录结构
  
• •常用开发、构建、测试命令
  
• •命名规范和提交规范
  
• •团队约定与架构决策原文还强调了一个实践：在代码评审中不断把“本次教训”写入 CLAUDE.md，让 AI 随项目一起进化，减少重复犯错。
  

3.7 这一部分的理解顺序

如果你是第一次接触 Claude Code，建议按这个顺序理解：

1. 1.先把 Skills 当成“现成工作流”
   
2. 2.再把 Hooks 理解成“事件自动化”
   
3. 3.把 Plugins 看成“能力套件”
   
4. 4.把 MCP Servers 看成“对外连接层”
   
5. 5.把 Subagents 看成“并行执行机制”
   
6. 6.把 CLAUDE.md 看成“项目记忆与团队规范”
   

视频链接：https://pan.quark.cn/s/22afe454bfff
橙皮书📙：直接从 《§03你的第一个项目》 看起

Claude Code从入门到精通-v2.0.0_trimmed.pdf