Claude Code

Why Claude Code

AI编程工具在三年里变了三次。搞清楚这个演变路径，你就能理解 Claude Code 到底在做一件什么不一样的事。

三年变了三次

点击下方时间轴，了解每个阶段的特点：

它跟 Cursor 到底有什么不一样

增长有多快

全书路线图

Get Started in 10 Minutes

安装过程比你想象的简单。选择你的系统，跟着做就行。

选择安装方式

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

winget install Git.Git

winget install Anthropic.ClaudeCode

claude --version

brew install --cask claude-code

五种使用方式

试一试：第一句话

安装清单（可交互勾选）

• ✓
  CLI 可用：运行 claude --version 能看到版本号
• ✓
  账号已登录：启动后不再要求登录
• ✓
  能创建文件：让 Claude Code 创建一个测试文件
• ✓
  能读取项目：在已有项目目录启动，问「这个项目是做什么的」
• ✓
  能运行命令：让它运行 ls 或 git status

全部通过？可以开干了。

付费方案

Your First Project — Learning by Doing

理论讲完了，直接上手。这一章从零做一个真实的 CLI 工具。做完之后，你就真正理解对话式编程是怎么回事了。

五步工作流

# 示例需求
帮我做一个AI新闻聚合CLI工具。需求如下：
1. 从以下RSS源抓取最近24小时的文章
2. 对每篇文章提取标题、链接、发布时间、来源
3. 按时间倒序排列，输出Markdown格式日报到output/目录
4. 用TypeScript写，用tsx直接运行

先别急着写代码，给我一个实现方案。

新手常见困惑

Core Workflows — The Patterns That Matter

跑通第一个项目之后，真正拉开效率差距的是几个核心工作模式。点击卡片查看详情。

四大工作模式

claude --permission-mode auto

# 允许运行所有 npm 脚本
Bash(npm run *)
# 允许编辑 docs 目录
Edit(/docs/**)
# 允许 git 操作
Bash(git add *)
Bash(git commit *)

# 创建一个 worktree，在新目录中开始工作
claude --worktree

# 在 Tmux 会话中启动
claude --worktree --tmux

会话管理命令速查

六个坑，你大概率会踩

CLAUDE.md — The Map You Draw for Your AI

Claude Code 每次对话开始时会自动读 CLAUDE.md。这个文件不是说明书，它更像一份契约。你和 AI 之间关于怎么干活的约定，就写在这一个文件里。

什么该写，什么不该写

一个真实的好 CLAUDE.md

# MyApp

## 架构
- Next.js 15 + TypeScript + Tailwind CSS
- 数据库: PostgreSQL + Drizzle ORM
- 认证: Better Auth
- 状态管理: Zustand (不要用Redux)

## 开发命令
- 启动开发服务器: pnpm dev
- 跑测试: pnpm test (Jest + React Testing Library)
- 类型检查: pnpm typecheck

## 代码风格
- 组件用函数式，不用 class
- 样式用 Tailwind，不写 CSS 文件
- 数据获取用 server component，不用 useEffect

## 常见陷阱
- Drizzle 迁移后必须跑 pnpm db:generate，否则类型不同步
- 环境变量改了之后需要重启 dev server

## 不要做
- 不要安装新依赖除非我明确同意
- 不要修改 drizzle.config.ts

整个文件不到 300 字。但每一行都有价值：要么是 Claude 猜不到的命令，要么是踩过的坑。没有一句废话。

迭代飞轮

层级结构

~/.claude/CLAUDE.md     ← 全局级：所有项目共用的偏好
./CLAUDE.md             ← 项目级：检入 git，与团队共享
./src/CLAUDE.md         ← 子目录级：monorepo 中特定模块的规则

Advanced Prompting & Context Engineering

好的对话靠的不是花哨的 prompt，而是精准的上下文。这章聊的都是实战中真正管用的对话策略。

三个提问原则

让 Claude 采访你

当你要做一个比较大的功能，不要一上来就写需求文档。先对 Claude 说：

我想做一个支付功能，在动手之前，先采访我，
问清楚所有你需要知道的事情。

Claude 会问你一系列问题，其中至少有一半是你自己没考虑过的。采访结束后，让它把答案整理成一份 Spec，然后开一个全新的会话来执行。

Context Engineering：信息不是越多越好

Extensions: Skills, Hooks & MCP

Claude Code 真正的价值不是它本身有多强，而是你能在它身上接多少东西。三种扩展机制，让它从一个终端工具变成一个可以无限生长的工作台。

# /techdebt 命令示例

把「发现技术债务 → 评估影响 → 创建 issue → 关联 sprint」
这个流程写成 skill。

以后发现技术债时，直接输入 /techdebt，
Claude 会自动走完整个流程。

// .claude/settings.json 自动格式化示例
{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Edit|Write",
      "command": "npx eslint --fix $CLAUDE_FILE_PATH"
    }]
  }
}

# 添加 Slack MCP
claude mcp add slack -- npx -y @modelcontextprotocol/server-slack

# 查看已安装的 MCP
claude mcp list

Multi-Agent Collaboration

Claude Code 最被低估的能力不是它写代码有多快，而是它可以同时跑很多个。学会并行之后，你的工作模式会从「一个人配一个 AI」变成「一个人指挥一支 AI 团队」。

并行工作的基础设施

# 启动一个在独立 worktree 中运行的 Claude session
claude --worktree

# 在 Tmux 会话中启动（可以后台运行）
claude --worktree --tmux

三种协作模式

for file in $(cat files-to-migrate.txt); do
  claude -p "Migrate $file from JS to TS" \
    --allowedTools "Edit,Bash(git commit *)" &
done

Build a Complete Product from Scratch

前8章讲零件，这一章组装。用一个真实项目把前面学的东西全串起来。

五个阶段

I want to build a weekly report tool. Before writing
any code, interview me to understand the requirements.

Deploy this project to Vercel. Set up the environment
variables for GitHub OAuth, Claude API key, and Slack
bot token. Also create a GitHub Actions workflow.

花叔踩出来的五条经验

Mental Models & Continuous Evolution

工具会过时，功能会更新，但好的思维方式不会贬值。最后一章退后一步，聊几个我觉得比具体操作更重要的东西。

三层模型：你的时间该花在哪

核心循环：Think → Act → Observe → Repeat

这就解释了为什么 Claude 有时候看起来「绕弯路」。它不是一个从输入到输出的直线程序，它是一个不断探索和调整的循环体。每一步都在根据最新的观察做决策。

身份在变：从写代码到构建产品