这是一篇关于 Claude Code 的最全使用教程，从零开始，深入了解并掌握这个强大的终端AI编程工具。文章结构清晰，涵盖了从理念、安装、核心命令到高阶玩法的全部内容

---

Claude Code 最全使用教程：从入门到精通的终端AI编程神器

引言：欢迎进入代理式编程时代

如果你是一位开发者，可能已经习惯了 GitHub Copilot 的代码补全，或者 Cursor 的对话式编辑。但 Claude Code 的出现，将 AI 编程带入了全新的 “代理式” 时代 。

Claude Code 是由 Anthropic 推出的直接运行在终端中的智能体编程工具。它不再仅仅是你的“副驾驶”，而是一位能够独立理解代码库、执行 Shell 命令、处理 Git 工作流、甚至通过 MCP 调用外部工具的“代理人” 。你只需要像对一位初级工程师下达指令一样，告诉它目标，它就能规划并执行多步骤任务。

本文将为你提供一份最全面的 Claude Code 使用教程，无论你是初学者还是资深开发者，都能从中找到提升效率的钥匙。

第一章：安装与初始配置

1.1 环境准备

Claude Code 基于 Node.js 运行，请确保你的系统已安装 Node.js 18 或更高版本 。

node --version

1.2 安装 Claude Code

根据你的操作系统和偏好，可以选择以下任意一种方式进行安装 ：

• 通过 NPM 安装（全平台通用）：

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

• macOS（Homebrew）：

  brew install --cask claude-code
  

• macOS / Linux（官方脚本）：

  curl -fsSL https://claude.ai/install.sh | bash
  

• Windows（PowerShell）：

  irm https://claude.ai/install.ps1 | iex
  

安装完成后，运行 claude --version 验证安装是否成功。

1.3 账号认证

首次启动时，在终端输入 claude，系统会引导你进行登录 ：

1. 运行 /login 命令。
2. 终端会弹出一个浏览器窗口，要求你授权 Claude Code 访问你的账户（支持 Claude.ai 的 Pro/Max 订阅用户或使用 Console 的 API 用户）。
3. 认证成功后，凭证会存储在本地，后续使用无需重复登录。

1.4 配置 API 密钥（备用方案）

如果你遇到网络问题或希望使用特定模型（如国内中转或阿里云 Coding Plan），可以通过环境变量配置 ：

cd your-project-folder
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://your-custom-endpoint.com"
claude

💡 专业技巧：为了避免每次都要输入 export 命令，可以将环境变量写入 Shell 配置文件（如 .bashrc 或 .zshrc）中永久生效 。

第二章：核心命令与交互模式

进入项目目录并输入 claude，你就进入了一个全新的智能终端世界。

2.1 让 AI 理解你的项目：/init

在任何新项目中，首先运行 /init 。
Claude Code 会扫描整个项目，在根目录下生成一个 .claude/CLAUDE.md 文件。这个文件是项目的“说明书”，包含了项目的构建命令、架构模式和代码规范。它会成为 AI 的长期记忆，每次对话都会自动加载 。

2.2 对话管理

• /clear：清空当前对话历史，开启一个全新的任务，避免上下文干扰 。
• /compact：当对话过长时，使用此命令压缩总结对话内容，帮助 AI 聚焦重点，同时节省 Token 消耗 。
• /export：将整个对话导出为 Markdown 文件，方便复盘或分享 。

2.3 快捷指令与语法

• @ 引用：像在 Slack 中一样，使用 @ 快速将文件或目录拉入上下文。
  • @src/utils/auth.ts：引用特定文件。
  • @src/components/：引用整个目录 。
• ! 执行命令：在不退出对话的情况下执行终端命令。
  • ! git status：直接运行 git 命令，结果会返回给 AI 作为上下文 。
• # 长期记忆：使用 # 告诉 AI 一些关键信息（如“我们使用 pnpm 而不是 npm”），这些信息会被记录到 CLAUDE.md 中，永久生效 。

2.4 常用快捷键

• 双击 Esc：时光倒流，回退到上一个代码或对话的检查点 。
• Ctrl + R：搜索历史输入的 Prompt 。
• Ctrl + S：暂存当前正在编写的 Prompt，处理完其他事后自动恢复 。
• Shift + Enter：多行输入（需 /terminal-setup 配置）。

第三章：高阶玩法 —— 让你的效率起飞

掌握了基础命令，你已经可以流畅使用 Claude Code。但要想真正“榨干”它的性能，你需要了解以下高阶技巧。

3.1 思考深度与规划模式

面对复杂逻辑时，可以通过关键词触发 AI 的深度思考 ：

• > ultrathink:：在 Prompt 前加上 ultrathink，Claude 会分配更多算力进行深度推理，适合处理高并发设计或复杂算法。
• 规划模式：双击 Shift + Tab 进入。在此模式下，Claude 只读代码、分析架构并起草计划，绝不修改任何文件。等你批准后，再切换回普通模式执行。这是“先谋后动”的最佳实践 。

3.2 会话管理：断点续传与远程传送

• 断点续传：
  • claude --continue：恢复上次意外关闭（如电脑没电）的对话 。
  • claude --resume：从历史会话列表中选择并恢复 。
• 命名会话：使用 /rename api-refactor 给会话起名，之后可通过 claude --resume api-refactor 直接恢复 。
• 远程传送：在网页版 claude.ai/code 开始的任务，可以通过 claude --teleport session_id 无缝“传送”到本地终端继续执行 。

3.3 权限与自动化

• 沙盒模式 (/sandbox)：厌倦了一次次点“Approve”吗？使用沙盒模式预先定义权限范围（如允许 npm test，允许读取 src/），在此范围内 Claude 可以自动执行，无需人工干预 。
• YOLO 模式 (claude --dangerously-skip-permissions)：跳过所有权限检查。⚠️ 警告：这个名字中的“Dangerously”不是开玩笑的，建议仅在完全隔离的沙盒环境中使用 。
• 非交互模式 (-p 参数)：将 Claude 集成到脚本中。

  git diff | claude -p "根据这些 diff 生成一份简洁的 commit message"
  

  这个命令完美体现了 Unix 哲学：Claude Code 成为了一个可以通过管道连接的“自然语言到行动”的转换引擎 。

第四章：与 IDE 的无缝集成

虽然 Claude Code 生于终端，但它能与你的编辑器完美结合，带来可视化的极致体验。

4.1 VS Code 集成

1. 在 VS Code 扩展市场搜索并安装 “Claude Code” 官方扩展 。
2. 在终端 Claude 会话中输入 /ide 命令，连接两者。
3. 智能感知：在 VS Code 中选中代码，直接到终端提问，无需复制粘贴，Claude 就知道你指的是哪段代码。
4. 可视化 Diff：当 Claude 修改代码时，修改建议会以 Diff 视图 的形式直接呈现在 VS Code 中。你可以清晰地看到每一行变化，并轻松选择接受或拒绝 。

4.2 JetBrains 系列集成

在 IntelliJ IDEA、PyCharm 等 JetBrains IDE 的插件市场中搜索 “Claude Code” 并安装，即可在 IDE 内调起工具窗口进行对话 。

第五章：扩展 Claude Code 的无限可能 —— MCP 与 Skills

5.1 模型上下文协议

MCP 就像是 Claude Code 的“插件系统”，让它能够连接外部工具和数据源 。

• 安装 MCP 服务器：例如，安装一个联网搜索的 MCP，Claude 就能获取实时信息，而不是依赖过时的训练数据。
• 获取最新文档：通过 MCP 连接官方文档库，Claude 可以基于最新版本的框架 API 来编写代码，彻底消除幻觉 。

5.2 Skills 与 Hooks

• Skills（技能包）：将一组指令、脚本和工具打包成“技能”，在不同项目中随时加载特定领域的专长 。
• Hooks（生命周期钩子）：在 .claude/settings.json 中配置，可以在工具执行前后自动运行脚本。例如：配置一个 Hook，让 Claude 在每次修改代码后自动运行 linter（代码检查工具）。

第六章：实战技巧与最佳实践

6.1 上下文工程

传统的提示工程关注如何措辞，而上下文工程关注如何为 AI 构建一个完整的认知系统 。

• 创建 context 文件夹：将与任务相关的文档、图片、数据文件放在项目 context 目录下，供 Claude 随时查阅。
• 精简 CLAUDE.md：只记录构建命令、代码规范和工作流等广泛适用的全局约定，保持文件简洁易读 。

6.2 测试驱动开发

利用 Claude Code 可以完美实践 TDD ：

1. 命令 Claude：“为 utils/calculator.js 中的 add 函数编写单元测试。”
2. 运行测试，确认失败（Red）。
3. 命令 Claude：“编写代码让这些测试通过。”（Green）。
4. 最后命令 Claude：“重构代码，保持测试通过。”（Refactor）。

6.3 常见场景示例

• 接手新项目：/init -> “简要介绍一下这个项目的整体结构和核心功能。”
• 修复 Bug：“用户登录时不输入密码会报错，修复它，并确保现有测试全部通过。”
• 生成文档：“为 client.py 文件添加详细的文档字符串和注释。”

结语

Claude Code 的强大之处，不仅在于它能自动写代码，更在于它赋予了开发者前所未有的控制权。它让你从繁琐的细节中解脱出来，专注于架构设计、结果审查和创意实现，真正成为 AI 时代的“监督者”和“架构师” 。