Claude Code 精通指南 第1篇：快速上手

想象一下：你面对一个庞大的遗留代码库，数百个文件层层嵌套，然后有人让你"加个小功能"。你可以花上好几个小时追踪 import、理解设计模式、搞清楚各模块之间的关联。又或者，你可以在终端里敲下 claude，让它用大白话给你讲清楚整个架构。

这就是 Claude Code 的价值所在——一个 AI 结对编程助手，不只是帮你自动补全代码，而是真正理解你整个项目，并且能自主执行任务。来，我们开始搞定它。

生产力差距是真实存在的

有句话没人愿意说破：如果你现在还没用上 Claude Code 这样的工具，你已经在掉队了。

那些先行者的生产力是其他人的 10 到 100 倍。这不是营销话术，这是当你能在一小时内交付整个功能、几分钟内重构架构、让 AI 几秒读完几千个文件来定位 bug 时，自然而然发生的事。

当有些开发者还在手动追踪代码时，其他人已经搞定了，开始下一个任务。当有些人还在翻文档时，其他人已经上线了。当有些人还在逐行 debug 时，其他人已经解决问题继续前进了。

这篇指南是我日常使用 Claude Code 一年以来的全部心得。每一个帮我省下几小时的技巧，每一个倍增产出的工作流，每一次让我从抓狂变成心流的思维转变。

如果你是独立开发者，这会改变你的职业轨迹。如果你带团队，这会改变你整个组织。差距正在飞速拉大，别站错了队。

Claude Code 到底是什么？

Claude Code 是 Anthropic 打造的智能编程助手（agentic coding assistant），直接运行在你的终端里。和传统的代码补全工具不同——那些只是帮你猜下几个字符——Claude Code 能够：

• 浏览你的整个代码库 - 它会阅读、理解并串联数百个文件之间的逻辑
• 执行多步骤任务 - "把这个模块重构成 TypeScript"不只是个建议，Claude 是真的会动手去做
• 处理 git 工作流 - 提交、分支、PR 描述——全都可以用自然语言搞定
• 到处运行 - 终端、VS Code、JetBrains，甚至在 GitHub 上通过 @claude 提及直接调用

把它想象成一个不太像自动补全、更像是一个超级积极的初级开发者——打字速度是你的 1000 倍，能在几秒内读完你的整个代码库，而且对解释任何事情都有无限的耐心。

不过有个要注意的地方：如果你不加约束，LLM（大语言模型）会毫无顾忌地一路狂奔。真正从 Claude Code 中获益最大的开发者，不只是擅长写 prompt，更擅长搭建一套结构，把这股速度引导到有用的方向，而不是制造混乱。

安装前的准备

你需要以下两者之一：

方案 A：Claude Pro 或 Max 订阅

如果你已经订阅了 Claude Pro（$20/月）或 Max（$100/月），直接就能用。Claude Code 的使用包含在订阅中，登录你的 Claude 账号即可验证身份。

方案 B：Anthropic API 密钥

更喜欢按量付费？在 console.anthropic.com 创建账号，添加账单信息，然后生成 API 密钥。用多少付多少。

小贴士： 如果你同时设置了 API 密钥环境变量和 Claude 订阅，API 密钥会优先生效——这意味着你会被按 token 计费，而不是使用订阅额度。在 Claude Code 里运行 /status 可以查看当前使用的是哪种认证方式。

系统要求：

• Node.js 18 或更高版本（运行 node --version 检查）
• macOS、Linux 或 Windows

安装

npm 安装方式已经弃用了。以下是官方推荐的安装方法：

macOS 或 Linux（推荐）：

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

Homebrew（macOS/Linux）：

Brew install --cask claude-code

Windows（PowerShell）：

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

Windows（WinGet）：

Winget install Anthropic.ClaudeCode

安装完成后，Claude Code 会在后台自动更新。使用 Homebrew 和 WinGet 安装的用户需要手动运行 brew upgrade claude-code 或 winget upgrade Anthropic.ClaudeCode 来更新。

首次启动

切换到任意项目目录，运行：

Claude

接下来的流程取决于你的配置：

1. 浏览器弹出进行身份验证
2. 使用你的 Claude 账号或 Anthropic 控制台凭据登录
3. 授权 Claude Code 访问你的账号
4. 系统自动创建一个专属的 "Claude Code" 工作区来追踪用量

就这样，你已经进来了。

上手后第一件事

立刻运行这个命令：

/terminal-setup

这会安装终端快捷键，让你可以用 Shift + Enter 输入多行内容。不装的话，你就只能在一行里把所有东西塞完——当你要写详细的 prompt 时，这会很痛苦。

为什么重要： 想象一下，在一行里解释一个复杂 bug 和分成几段有条理地描述，体验完全不同。多行输入会彻底改变你与 Claude 沟通的效率。

两种工作模式

交互模式（你的日常主力）

Claude

打开一个 REPL 会话，进行来回对话。Claude 会在整个会话中保持上下文，记住你们讨论的内容，并能处理复杂的多步骤任务。

适用场景：

• 开发新功能
• 排查棘手的问题
• 代码评审和重构
• 探索不熟悉的代码库

计划模式（三思而后行）

在发送消息前按两次 Shift+Tab 进入计划模式（Plan Mode）。在这个只读状态下，Claude 可以浏览你的代码库、研究方案、提出解决方案——但不能修改任何文件。

适用场景：

• 实施前的架构决策
• 理解陌生代码
• 评估解决问题的不同方案
• 需要先看方案再动手的复杂重构

计划模式在第2篇：心智模型中有详细介绍。

单次模式（快速提问）

Claude -p "你的问题"

执行一条命令后退出。没有交互会话，就是提问 → 回答 → 结束。

适用场景：

• 快速查询：claude -p "auth 中间件是做什么的？"
• 自动化脚本：claude -p "列出所有 TODO 注释" >> todos.txt
• CI/CD 流水线：claude -p "根据最近的提交生成 changelog"

核心命令

进入交互会话后，以下斜杠命令用来控制 Claude 的行为：

/help — 显示所有可用命令，包括自定义命令。忘记命令或想发现新功能时用。

/clear — 清空对话历史。要经常用！ 不相关的任务之间清一下，省 token。

/compact — 压缩对话上下文。上下文变长但你又想保留部分历史时使用。

/model — 在 Opus、Sonnet 或 Haiku 之间切换。Opus 适合复杂推理，Haiku 处理简单任务，Sonnet 是均衡之选。

/config — 打开设置配置。用来调整权限、默认值和偏好。

/status — 显示当前状态和认证方式。确认使用的是哪个账号/API 密钥。

/cost — 显示 token 用量。随时关注消耗情况。

/context — 查看 Claude 当前上下文中有什么。帮你了解 Claude 此刻"知道"些什么。

/vim — 启用 vim 风格编辑。vim 用户会感觉宾至如归。

/init — 初始化或更新 CLAUDE.md。在完成大功能或重构后运行，保持项目上下文信息最新。

会话管理命令

/terminal-setup — 安装 Shift+Enter 快捷键以支持多行输入。

/allowed-tools — 配置 Claude 可以使用的工具（文件访问、bash 等）。

/hooks — 设置特定事件的自动化钩子。

/mcp — 管理模型上下文协议（Model Context Protocol）服务器。

/agents — 创建和管理子代理（subagent），用于并行任务。

/install-github-app — 设置 GitHub Actions 集成，支持 @claude 提及。

从终端管理会话

有时候你需要接着上次的进度继续：

# 从上次停下的地方精确继续
Claude -c

# 浏览并选择最近的会话
Claude -r

-r 标志特别有用，当你突然想起"等等，两天前我在查那个 auth 的 bug，Claude 好像搞清楚了什么"，你可以直接跳回那个会话继续。

你的第一个真实任务

下面这个操作非常适合用来测试你的环境。切换到任意项目，运行：

Claude

然后输入：

Explain the architecture of this project. What are the main components
And how do they connect? Where would I look if I wanted to add a new
API endpoint?

Claude 会扫描你的代码库，识别其中的模式，然后给你一个结构化的概述。这确实是上手任何陌生项目最好的方式之一——不管是新工作、开源贡献，还是你自己半年前写的代码。

权限系统

Claude 不会偷偷修改你的文件。在做修改之前，你会看到类似这样的提示：

Claude wants to edit src/auth.ts
Allow? [y]es / [n]o / [a]lways allow for this file

你的选择：

• y - 允许这次具体操作
• n - 拒绝
• a - 始终允许此类操作（后续类似操作不再提示）

我的建议： 刚开始时对所有操作都选 y，直到你了解 Claude 的行为模式。一旦你对某些操作（比如编辑测试文件）建立了信任，再切换到 a 来加速工作流。

进阶权限管理： 关于允许/拒绝列表、自动化钩子和团队级权限策略的精细控制，请参阅第3篇中的 Settings 配置。

IDE 集成

Claude Code 原生支持多个 IDE：

VS Code — 在扩展商店（Cmd/Ctrl+Shift+X）搜索"Claude Code"。完整集成了内联 diff 和多标签页对话。

Cursor — 可能需要手动安装 VSIX。基于 VS Code，安装后体验很棒。

Windsurf — 与 Cursor 类似的安装方式。VS Code 分支，支持 VSIX 扩展。

JetBrains — 有插件可用。支持 IntelliJ、WebStorm、PyCharm 及其他 JetBrains IDE。

重要提示： VS Code 扩展并不是 CLI 的替代品——它是一个启动器，提供更友好的界面。底层运行的 Claude Code 引擎完全相同。你可以同时运行多个实例，分别处理代码库的不同部分。

思维转变：结构驱动速度

这里是区分"爱用 Claude Code"和"觉得 Claude Code 不好用"的开发者的关键：成功的人把它当作在和一个非常能干但非常冲动的初级开发者协作。

这位初级开发者打字飞快、永不疲倦，能在几秒内吸收你的整个代码库。但如果你不加约束，它也会毫不犹豫地横冲直撞。让 AI 辅助编程真正好用的那些实践并不新鲜——它们就是经验丰富的开发者多年来一直在做的事，只是现在变得至关重要了。

Git 是你的安全网

频繁提交，小步快跑。如果 Claude 跑偏了，你只需要 git checkout . 或回退到上一个已知的正常状态。把每次 commit 想象成游戏里的存档点。

听起来很基础，但这会改变一切。当你知道随时可以回滚时，你才能放心让 Claude 去尝试。当你没有把握时，你会犹豫、过度干预，从而失去大部分速度优势。

如果你对 Git 有些生疏，GitHub 官方文档写得确实很好，值得看看。

先计划，再提问

在开始写 prompt 之前，先写清楚你要构建什么。一个简单的 markdown 文档，记录你的目标、架构决策和约束条件就够了。把它放在你的仓库里，Claude 可以随时引用。

说真的——用计划模式。这个名字就已经说明了一切。当你让 Claude 做规划时，它会向你提出澄清性问题，然后提出方案让你选择是否接受。如果你因为任何原因不满意，说不，然后告诉 Claude 你想怎么改。反复迭代，直到满意为止。

这迫使你去思考，也给了 LLM 关键的上下文。按两次 Shift+Tab 然后说"设计一个登录表单"，比直接说"给我搞一个登录表单"好上一万倍。

把大任务拆成 Issue

不要一上来就"嘿 Claude，给我搞一套用户认证系统"，而是把它拆成独立的小任务："创建 User 模型"、"添加会话管理"、"构建登录表单"。每个 Issue 对应一个 PR。

创建 GitHub Issue 模板（功能请求、Bug 报告——这两种覆盖 90% 的场景），并提交到版本控制。GitHub 会在任何人通过 UI 创建 Issue 时自动使用这些模板。

一旦你有了扎实的计划并理解了它，让 Claude 用你的模板创建 GitHub Issue。或者如果你有一个大计划，让 Claude 把它拆成更小、更可控的部分，然后把你认可的部分转化为 Issue。

先写测试（是真的）

让 Claude 在实现功能之前先写测试。听起来违反直觉，但这会迫使 LLM 清晰地思考"完成"是什么样子——同时给你一张安全网。如果测试没通过，说明实现有问题。

这叫 TDD（测试驱动开发，Test-Driven Development），也叫"从红到绿"——来源于 CLI 中失败/通过测试的典型颜色。这不只是好的实践——这是你让 Claude 保持诚实的方式。

用 Linter 捕捉"创意发挥"

ESLint、Prettier、Rubocop、markdownlint、yamllint——选适合你技术栈的。配合 Git pre-commit 钩子使用。这能捕获大量 LLM 做出的与你代码库风格不一致的选择。

举个例子：Claude 特别喜欢在 markdown 文件中省略标题和列表之间的空行。不知道为什么，但标准做法是要有空行的。所以你安装 markdownlint，在配置文件中设好规则，对 Claude 修改过的 markdown 文件运行检查，问题就解决了。

CLAUDE.md：你的项目说明书

在项目根目录创建一个 CLAUDE.md 文件，写上你的编码规范、偏好和项目上下文。Claude 会在每次会话开始时自动读取它。

不过别写太多。LLM 的短期记忆出人意料地差——但它们又能莫名其妙地说出 300 年前发生的事情（感谢训练数据）。保持聚焦在你的偏好和关键项目细节上。

在完成大功能或重构后运行 /init，保持 CLAUDE.md 是最新的。Claude 会告诉你是否需要添加或更新什么，或者直接说"看起来不错，无需修改"。

新手常见错误（以及如何避免）

1. 跳过 /terminal-setup

你会纳闷为什么写详细 prompt 时感觉施展不开。运行一下就好了。

2. 从不用 /clear

你发的每条消息都包含之前所有的上下文。完成一个任务后，清空重来。你的 token 账单会感谢你的。

3. 描述太模糊

"修复那个 bug" vs "修复 auth.ts 第 42 行的空指针异常，user.id 在空值检查之前就被访问了"——哪个效果更好不言而喻。

4. 让 Claude 修改它还没读过的代码

先让 Claude 分析。先说"读一下 auth 模块，解释一下会话是怎么工作的"，然后再说"重写会话处理逻辑"。

5. 一个 prompt 塞进巨量任务

"把整个应用重写成 TypeScript"太吓人了。拆开来："先把 user 模块转成 TypeScript，然后我们再做 auth。"

6. 不检查 /status

如果你纳闷为什么有订阅还在被扣费，检查一下当前激活的是哪种认证方式。

7. 跳过计划模式

"直接开搞"感觉更快，其实不然。按两次 Shift+Tab，花五分钟做个计划——能省下好几个小时的返工。

8. 没有安全网

如果你不频繁提交，一次糟糕的生成就能毁掉你一下午。大改之前提交，改好之后也提交。提交不要钱。

下一步

现在你已经安装好了 Claude Code，不仅了解了命令本身，更理解了让 AI 辅助编程真正好用的思维方式。结构和约束不是限制——它们才是让速度变得真正有用而非混乱的关键。

在第2篇：心智模型中，我们将深入 Claude Code 的"思维方式"——理解上下文窗口、工具调用，以及如何组织你的 prompt 来持续获得更好的结果。这些知识会让 Claude 从一个偶尔有用的助手，变成一个可靠的工程伙伴。