Claude Code完全指南：安装配置、工作流与进阶技巧

Claude Code 是 Anthropic 推出的一款代理式编程工具（Agentic Coding Tool），它能直接访问你的代码库、编辑文件、执行命令，并与现有开发工具无缝集成。与传统的 Claude AI 聊天不同，Claude Code 不再需要你来回复制粘贴代码——它能自主完成工作。本文将系统梳理 Claude Code 的核心概念、安装方式、工作流程以及进阶技巧，帮助你快速上手并高效使用这款工具。

什么是Claude Code？它与Claude AI有何不同？

Claude Code 的本质是一个 AI Agent（智能代理）。所谓 AI Agent，是指能够与环境交互、执行动作以完成特定目标的软件系统。其核心机制是将大语言模型置于一个实时循环中，让它能够调用工具、访问外部服务，甚至协调其他 AI 代理来达成预设目标。

与普通的 Claude AI 聊天相比，Claude Code 有三个关键区别：

• 直接访问文件系统：它能读取和理解你的整个代码库，追踪 Bug，解释功能实现
• 执行终端命令：可以运行构建脚本、测试套件、安装依赖包，并根据输出决定下一步操作
• 联网搜索：当需要最新的 API 文档或参考资料时，它可以自主搜索网络

同时，有三个核心概念需要理解：上下文窗口（Claude 的工作记忆，容量有限）、权限机制（默认会在执行命令或修改文件前征求许可）、以及容错意识（它可能误解意图、引入新 Bug 或过度工程化）。

多平台安装与使用方式

Claude Code 支持终端、VS Code、JetBrains IDE、Claude Desktop 桌面应用以及网页端，覆盖了主流的开发环境。

终端安装（推荐，功能更新最快）：

• macOS/Linux/WSL：使用 cURL 一键安装命令
• 也可通过 Homebrew 安装（brew install），但不支持自动更新
• Windows：支持 PowerShell、CMD 的 cURL 命令以及 WinGet

安装完成后，进入项目目录运行 claude 即可启动，它将自动获取该目录及所有子文件夹的访问权限。

VS Code：在扩展面板搜索 "Claude Code"，安装 Anthropic 官方扩展（认准蓝色认证标识）。安装后通过 Ctrl/Cmd + Shift + P 打开命令面板，搜索 "Claude Code" 即可使用。

JetBrains IDE：从 JetBrains Marketplace 安装 Claude Code 插件，重启后即可在侧边栏看到 Claude 图标。

桌面应用与网页端：Claude Desktop 支持在后台运行 Claude Code，适合多任务场景；网页端则仅限 GitHub 仓库，但支持多会话并行工作。

选择建议：追求最新功能用终端；喜欢与编辑器深度集成用 IDE 插件；需要后台运行用桌面应用；远程协作用网页端。

核心工作原理：代理循环与工具调用

Claude Code 的工作流程可以概括为一个代理循环（Agentic Loop）：

1. 输入提示词：你向 Claude Code 描述任务
2. 收集上下文：Claude 与模型交互，返回文本或工具调用请求
3. 执行动作：编辑文件、运行命令等
4. 验证结果：判断是否达成目标
5. 循环迭代：未达成则重新执行，直到结果可验证

在整个循环中，你可以随时添加上下文、中断操作或引导模型方向。

工具（Tools） 是代理工作的骨架。与传统"输入文本→输出文本"的 AI 不同，工具让 Claude Code 能在适当时机执行代码来推进任务——比如 read_file、search_web 等。Claude Code 通过语义搜索来判断何时调用哪个工具。

权限模式可通过 Shift + Tab 切换：

• 默认模式：每次编辑文件或运行命令都需要确认
• Auto Accept 模式：自动接受文件编辑，但仍需确认命令执行
• Plan 模式：仅使用只读工具，编译行动计划而不执行任何修改

黄金工作流：探索→计划→编码→提交

这是使用 Claude Code 最高效的方法论，避免了大多数人直接让 AI 写代码然后反复纠正的低效模式。

第一步：探索（Explore）

使用 Plan 模式让 Claude 只读取文件、搜索信息，不做任何修改。例如：

"我需要在图片上传管道中添加 WebP 转换功能。请分析管道中应该在哪个环节处理，是否需要新依赖，以及实现方案。"

Claude 会读取相关文件、搜索网络，然后给出详细的行动计划。

第二步：计划（Plan）

这是最佳的纠偏时机——因为还没有写任何代码。仔细审查计划，确认是否符合预期，必要时要求修改或补充。

第三步：编码（Code）

批准计划后，Claude 开始逐项执行。你可以选择自动接受文件编辑或逐一确认。Claude 会尽力自行排查问题，但有时仍需你介入纠正。

提升编码质量的关键技巧：

• 在计划中明确定义"正确"的标准
• 安装 Claude in Chrome 扩展，让 Claude 能控制浏览器测试 UI
• 在项目中包含测试套件，让 Claude 持续验证代码正确性
• 如果 Claude 反复遇到相同问题，让它将解决方案保存到 CLAUDE.md

第四步：提交（Commit）

在提交前，运行一个子代理（Sub-agent）做代码审查，然后让 Claude 按你的风格生成提交信息。

CLAUDE.md：给AI的项目说明书

CLAUDE.md 是 Claude Code 最实用的功能之一。它是一个放在项目根目录的 Markdown 文件，Claude 每次启动时都会自动读取，相当于项目的"入职手册"。

一个典型的 CLAUDE.md 包含：

• 技术栈说明（如 Next.js 15 + Tailwind + Drizzle ORM）
• 常用命令（开发服务器、测试、Lint）
• 代码风格（缩进、导出方式、目录结构约定）
• 架构决策（如"优先使用 Server Actions 而非 API Routes"）

记忆文件的层级结构：

• 项目级 CLAUDE.md：放在项目根目录，团队共享，纳入版本控制
• 用户级 CLAUDE.md：放在配置文件夹，个人偏好，跨项目生效

最佳实践：先不急着创建 CLAUDE.md，观察你需要反复纠正 Claude 的地方，再逐步添加规则。这样能保持文件精简且包含真正必要的信息。可以用 /init 命令让 Claude 自动生成初始版本。

上下文管理：高效利用有限的工作记忆

上下文窗口是 Claude 的工作记忆，每次读取文件、运行命令、发送消息都会占用空间。管理好上下文是高效使用 Claude Code 的关键。

核心命令：

• /compact：压缩当前对话，总结重要细节，释放空间（适合同一功能开发中途）
• /clear：完全清空，从零开始（适合切换到新功能时）
• /context：查看当前上下文使用情况的详细报告

优化技巧：

• 提示词要具体：模糊的提示会迫使 Claude 大量探索代码库，消耗更多上下文
• 精简 MCP 服务器：未使用的 MCP 工具定义也会占用上下文空间
• 善用子代理：子代理拥有独立的上下文窗口，适合处理"只需要答案不需要过程"的任务
• 考虑使用 Skills：与 MCP 类似但不会默认加载全部工具定义到上下文中

MCP：连接外部工具与数据源

Model Context Protocol（MCP）是一个开放标准，让 Claude Code 能连接外部工具和数据源，大幅扩展其能力边界。

常见用例：

• 连接 Linear 获取项目管理中的具体 Issue 详情
• 使用 Context7 MCP 服务器获取依赖库的最新文档
• 在 MCP 连接器市场可以找到数百种不同的连接器

添加与管理：

• 使用 claude mcp add 命令添加服务器
• 两种类型：HTTP（远程服务）和 STDIO（本地进程）
• 三种作用域：Local（仅当前项目）、User（跨项目）、Project（通过 .mcp.json 纳入版本控制）

注意事项：MCP 工具定义会占用上下文空间。如果工具超过上下文窗口的 10%，Claude Code 会自动切换到工具搜索模式。如果某个工具有 CLI 等价物（如 gh、aws），使用 CLI 方式更节省上下文。

Hooks：确定性的自动化控制

Hooks 与前面介绍的所有功能有一个根本区别：它们是确定性的，永远会执行。你可以在 CLAUDE.md 中告诉 Claude "每次编辑后运行 Prettier"，但它偶尔会忘记；而 Hook 则保证每次都执行，没有例外。

五种事件类型：

• UserPromptSubmit：提交提示词时触发
• PreToolUse：工具调用前触发（可用于阻止危险操作）
• PostToolUse：工具调用后触发（最常用于自动格式化）
• Notification：Claude 发送通知时触发
• Stop：Claude 完成响应时触发

典型应用场景：

• 自动格式化：PostToolUse Hook 匹配 edit/multi-edit，根据文件扩展名运行对应格式化工具
• 安全防护：PreToolUse Hook 阻止写入生产配置目录、阻止 rm -rf 命令、阻止直接提交到 main 分支（退出码 2 = 阻止，退出码 0 = 放行）
• 团队规范：Hooks 配置在 .claude/settings.json 中，可纳入版本控制，团队成员自动共享

总结

Claude Code 不是一个简单的聊天窗口，而是一个完整的代理式开发环境。掌握它的关键在于：理解代理循环的工作原理，遵循"探索→计划→编码→提交"的黄金工作流，用 CLAUDE.md 提供持久化上下文，精细管理上下文窗口，通过 MCP 扩展外部能力，以及用 Hooks 实现确定性的自动化控制。将这些要素组合在一起，才能真正发挥 Claude Code 的全部潜力，显著提升日常开发效率。