文章摘要
本文是一篇系统的*Claude Code教程，涵盖环境准备、安装配置、核心功能、高级技巧及实战案例，帮助开发者在终端中高效完成代码生成、调试、重构与自动化任务，让AI真正融入日常开发工作流。

Claude Code是Anthropic推出的终端原生AI编程助手，支持40多种编程语言和200k超长上下文。本文是一篇系统的 Claude Code教程，涵盖环境准备、安装配置、核心功能、高级技巧及实战案例，帮助开发者在终端中高效完成代码生成、调试、重构与自动化任务，让AI真正融入日常开发工作流。

Claude Code教程

一、Claude Code 是什么——终端里的 AI 编程执行代理

1.1 从聊天工具到可执行代理

Claude Code 是由 Anthropic 推出的终端原生 AI 编程工具。与网页版 Claude 的对话式交互不同，Claude Code 直接运行在终端中，能够读取项目目录、理解代码结构、修改文件、执行命令、生成提交信息并辅助调试。

更准确地说，Claude Code 是一个运行在本地项目环境中的 AI 执行代理（Agent Runtime）。它具备完整的工程属性：常驻项目目录、读写文件、执行命令、维护长期上下文、调用外部工具。这意味着 AI 不再只是“给建议”，而是直接参与工作执行。

1.2 适用场景

Claude Code 适合以下开发场景：

  • 快速理解陌生项目：接手新项目时，让 Claude Code 扫描目录结构、输出技术栈、核心模块和启动方式
  • 辅助修改代码：制定修改计划后按文件逐步执行
  • 排查 Bug：结合项目上下文分析错误日志，而非仅看孤立报错
  • 生成文档和脚本：自动生成 README、部署文档、测试脚本、Git commit message
  • 原型开发：将需求拆解为任务并逐步实现

1.3 系统要求

Claude Code 支持主流开发系统：

  • Windows：Windows 10 / 11（建议使用 WSL 或 Git Bash）
  • macOS：macOS 10.15 以上（建议使用自带终端、iTerm2 或 VS Code 终端）
  • Linux：Ubuntu 20.04+ / Debian 10+（建议使用 Bash、Zsh 或 Fish）

二、安装与环境配置

2.1 前置条件：Node.js 环境

Claude Code 需要 Node.js 18 或更高版本。

检查 Node.js 版本：

node -v
npm -v

若未安装或版本过低，请前往 Node.js 官网下载安装。

设置国内 npm 镜像源（可选，提升安装速度）：

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

2.2 三种安装方式

方式一：npm 全局安装（推荐）

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

安装完成后验证版本：

claude --version

方式二：原生安装（无需 Node.js）

macOS / Linux / WSL：

# 稳定版
curl -fsSL https://claude.ai/install.sh | bash
# 最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

Windows PowerShell：

# 稳定版
irm https://claude.ai/install.ps1 | iex
# 最新版
& ((scriptblock)::Create((irm https://claude.ai/install.ps1))) latest

方式三：各操作系统专项说明

macOS：也可通过 Homebrew 安装 Node.js：

brew install node

Windows：建议安装 Windows Terminal 以获得更好的兼容性。可从 GitHub 下载或通过微软商店安装。

Linux：按标准 npm 方式安装即可。

2.3 首次启动与账号认证

进入项目目录后启动：

cd your-project
claude

首次运行会自动弹窗请求 Anthropic API 密钥或 Claude Pro 订阅授权。按提示在浏览器中完成 OAuth 授权（登录 Claude 账号即可），授权成功后终端将自动缓存令牌。

三、核心功能与基础操作

3.1 常用命令速查

命令 功能描述 示例
claude 启动交互式 REPL 会话 claude
claude "任务描述" 运行一次性任务并退出 claude "重构这个函数"
claude -p "查询" 打印响应后退出（非交互模式） claude -p "解释这个正则"
claude -c 继续最近的会话 claude -c
claude -r 从历史列表中选择并恢复会话 claude -r
claude commit 使用 Claude 生成 Git 提交信息 claude commit
/clear 清除当前会话上下文 会话中输入 /clear
/help 显示所有可用命令 会话中输入 /help
exit 或 Ctrl+C 退出当前会话 会话中输入 exit

3.2 交互式会话操作

在终端输入 claude 后进入交互式 REPL 环境。开发者可以直接用自然语言描述需求，Claude Code 会自动规划方案并执行。

会话管理快捷键：

  • /：显示可用命令列表
  • 方向键（上/下）：浏览历史输入
  • Tab：自动补全命令或文件名
  • Option+Enter（macOS）/ Alt+Enter（Windows/Linux）：在输入框中换行
  • ESC：立即中断 AI 正在执行的任务

会话恢复：

  • claude -c：继续上一次的会话
  • claude -r：列出历史会话供选择恢复
  • /resume：在当前会话中切换到另一个历史会话

3.3 四大核心应用场景

功能构建：自然语言转代码

直接用中文描述需求，Claude Code 会自动规划方案、编写代码并确保可运行。支持前端组件、后端接口、数据脚本等各类场景，主流框架（React/Vue/Spring Boot/Gin 等）全覆盖。

调试修复：一键定位问题

粘贴错误日志或描述问题，工具将自动分析代码库、定位根因并修复。还支持截图上传调试（macOS 用 Ctrl+V，Windows 用 Alt+V 粘贴图片）。

代码库导航：全局理解项目

无需手动浏览文件，直接询问项目相关问题。工具会自动扫描项目结构并提供结构化答案，大型项目也能快速上手。

自动化任务：解放重复劳动：

  • 批量修复 ESLint 错误
  • 处理 Git 合并冲突
  • 生成测试脚本和部署文档

四、高级功能深度解析

4.1 Skills 技能系统

Skills 是 Claude Code 的重要扩展机制，可以理解为“前人验证好的工作流”。本质上是一个包含指令的 Markdown 文件。

Skills 与 CLAUDE.md 的区别：

  • CLAUDE.md：全局规范，告诉 Claude 这个项目是什么
  • Skill：操作手册，告诉 Claude 怎么完成某个具体任务

Skills 的核心特性：

  • 热重载：修改 ~/.claude/skills 目录下的技能文件后立刻生效，无需重启
  • 分叉上下文：在 Skills 配置中加上 context:fork，让技能在独立的子环境中运行，避免污染主对话
  • 生命周期钩子：支持 PreToolUse、PostToolUse 和 Stop 钩子，可在工具调用前后插入自定义逻辑

创建 Skill：在 ~/.claude/skills/ 目录下创建 Markdown 文件，定义任务的执行步骤和规范。之后可通过 /skill-name 直接调用，或由 Claude 根据上下文自动加载。

4.2 MCP 协议扩展

MCP（Model Context Protocol）是 Claude Code 连接外部世界的核心协议。Claude Code 的能力上限取决于 MCP 工具层——Agent 只负责决策与调度，工具才是真正的执行者。

MCP 的核心价值：将 Claude Code 从代码助手升级为全栈自动化引擎。通过配置 mcp.json，可以接入 GitHub、Playwright、Context7 等外部服务，实现自动化的 Code Review 工作流。

4.3 Hooks 钩子系统

Hooks 是用户定义的 shell 命令，在 Claude Code 生命周期的特定点执行。它们对 Claude Code 的行为提供确定性控制，确保某些操作始终发生。

常见 Hook 场景：

  • 每次写文件之前自动备份
  • 每次执行命令之后记录日志
  • 强制执行项目规则
  • 将 Claude Code 与现有工具集成

4.4 Plan 模式与安全重构

Plan Mode（计划模式）允许 Claude Code 先制定修改计划，再按文件逐步执行。这特别适合代码重构场景——AI 先展示完整的修改方案，开发者确认后再执行，避免盲目修改带来的风险。

4.5 子代理与多 Agent 协作

Claude Code 支持通过子代理（Sub-Agent）机制构建多 Agent 协作系统：

  • 主 Agent：负责理解与调度
  • 子 Agent：各司其职、职责单一、可替换

这套结构与微服务、Actor Model 高度一致，只是调度逻辑由自然语言驱动。

4.6 会话传送（/teleport）

/teleport 命令实现了网页端与终端之间的会话无缝传送：

  • 在 claude.ai 网页上开始项目，用 /teleport 传送到本地终端继续
  • 终端里的会话也可以传送到 claude.ai/code 继续

这意味着可以在任何设备上开始工作，在任何设备上继续工作。

五、配置管理与项目记忆

5.1 CLAUDE.md：建立项目记忆

CLAUDE.md 是 Claude Code 的项目记忆文件。每个会话启动时，它会被注入到 system prompt 中，让 Claude 在开口前就知道项目的技术栈、代码规范和架构信息。

配置层级与优先级：

文件路径 作用 是否提交 Git
~/.claude/CLAUDE.md 全局默认配置，适用于所有项目 否
项目根目录/CLAUDE.md 项目级配置，团队共享 是
项目根目录/CLAUDE.local.md 本地个人配置，覆盖项目配置 否（加入 .gitignore）
子目录/CLAUDE.md 子模块配置，仅对该子目录生效（优先级最高） 是

生成 CLAUDE.md：在项目根目录启动 claude，输入 /init 命令。程序会自动扫描代码库，分析 package.json 中的依赖项、目录架构和技术栈特征，生成初始的 CLAUDE.md 文件。

5.2 配置文件结构

环境初始化后，当前项目和全局目录下会生成特定的配置文件：

  • 项目根目录的 .claude/：存放 settings.json（可提交 Git 供团队共享）和 settings.local.json（本地忽略，用于个人偏好覆盖）
  • 系统用户目录 ~/.claude/：存放全局通用的配置偏好

这种分离机制保证了团队在代码规范上保持一致，同时开发者又能保留个人的终端操作习惯。

5.3 上下文与 Token 管理

压缩对话历史：使用 /compact 命令压缩对话历史，保留摘要信息，减少 token 消耗并保持上下文的精确性。

清除上下文：使用 /clear 清除当前对话上下文，开始一个干净的对话，避免历史信息干扰。

模型选择：通过 --model 标志指定当前会话使用的模型：

claude --model sonnet   # 默认模型
claude --model opus     # 处理复杂任务时切换

在处理极其复杂的架构设计时，切换到性能更强的 Opus 模型往往能获得更深刻的见解。

5.4 自定义命令

可以将常用的指令集或工作流封装为自定义命令：

  • 用户级命令：路径 ~/.claude/commands/，调用方式 /user:<命令名>，适用于所有项目
  • 项目级命令：路径 .claude/commands/（项目根目录），仅当前项目可用

六、实战案例与工作流集成

6.1 典型工作流示例

场景一：接手陌生项目

  1. 进入项目目录：cd new-project
  2. 启动 Claude Code：claude
  3. 输入 /init 生成项目记忆
  4. 提问：“分析这个项目的技术栈、核心模块和启动方式”

场景二：修复 Bug

  1. 粘贴错误日志：“TypeError: Cannot read properties of undefined…”
  2. Claude Code 自动分析代码库、定位根因
  3. 确认修复方案后执行

场景三：代码重构

  1. 启用 Plan 模式
  2. 描述重构目标：“将 API 服务从回调改为 async/await”
  3. 审阅 AI 制定的修改计划
  4. 确认后执行

场景四：批量自动化任务

  1. “帮我批量修复项目中的所有 ESLint 错误”
  2. “处理当前分支的 Git 合并冲突”
  3. “生成这个 API 模块的单元测试”

6.2 与其他工具的横向对比

对比维度 Claude Code Cursor GitHub Copilot
运行形态 终端 CLI IDE 分支（VS Code 分支） IDE 扩展
最佳场景 复杂重构、大型代码库理解、自动化任务 日常编码、Tab 补全、多语言开发 多语言补全、GitHub 生态集成
上下文能力 200k 超长上下文 依赖 IDE 上下文 依赖 IDE 上下文
定价 Claude Pro $20/月 Pro $20/月 Pro $10/月
自主执行 高（可读写文件、执行命令） 中 低（主要为补全和建议）

Claude Code 在终端中运行，无 GUI 层，能够实现编辑器内工具无法匹配的上下文理解和推理能力。Cursor 适合日常 IDE 工作，而 Claude Code 擅长多文件重构和代码库级别的复杂任务。多数团队的实际做法是：日常使用 IDE 助手，大型重构时启用 Claude Code。

七、常见问题 FAQ

Q1：Claude Code 和网页版 Claude 有什么区别？

网页版 Claude 是对话式聊天工具，而 Claude Code 是运行在终端中的 AI 执行代理。Claude Code 可以直接读取项目文件、修改代码、执行命令、维护长期上下文，真正参与开发工作流，而不仅仅是提供建议。

Q2：安装 Claude Code 需要什么前置条件？

需要 Node.js 18 或更高版本。支持 Windows 10/11、macOS 10.15+ 及主流 Linux 发行版。

Q3：如何让 Claude Code 记住我的项目？

在项目根目录启动 claude 后输入 /init 命令，工具会自动扫描代码库并生成 CLAUDE.md 文件。每个会话启动时该文件会被自动加载。

Q4：Claude Code 支持哪些编程语言？

支持 40 多种编程语言及主流框架，覆盖前后端、数据科学等全场景。

Q5：Claude Code 的费用是多少？

Claude Code 包含在 Claude Pro 订阅中，费用为 $20/月。部分功能在 Claude 免费计划中也可使用。

Q6：国内用户如何使用 Claude Code？

国内用户可以通过配置国内模型（如智谱 AI）的 API 来使用。配置文件位置：~/.claude/settings.json（Linux/macOS）或 C:\Users\{用户}\.claude\settings.json（Windows）。

Q7：如何更新 Claude Code 到最新版本？

使用 npm 安装的用户执行：

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

或使用内置命令：

claude update

Q8：Claude Code 的上下文长度是多少？

Claude Code 支持 200k 超长上下文，能够轻松驾驭大型代码库。

Q9：如何安全地使用 Claude Code 执行敏感操作？

默认情况下，Claude Code 在执行文件修改或系统命令等敏感操作时会请求用户确认。可以使用 Plan 模式先预览修改方案再执行。如需跳过确认（自动化场景），可使用 --dangerously-skip-permissions 参数，但需确保操作安全。

Q10：Claude Code 可以和其他 AI 编程工具一起使用吗？

可以。多数团队的实际做法是结合使用——日常使用 IDE 助手（如 Cursor 或 Copilot），大型重构或复杂任务时使用 Claude Code。

以上内容不代表本平台立场，仅供读者参考