Appearance
这不是一份"命令清单式"的速查文档，而是一篇从认知、上手到进阶扩展，尽量帮你把Claude Code真正用进开发流程的完整整理。
先说为什么值得认真学一次Claude Code
很多人第一次接触Claude Code，会先把它当成"能在终端里聊天的AI"，或者"比补全强一点的代码助手"。但真开始用进项目里之后，你会发现它真正有价值的地方，不是回答得多快，而是它能不能进入你的真实开发流程：读代码、改文件、跑命令、做验证、接外部系统、持续推进一个任务直到收尾。
1. 30秒速览版
如果你只想先快速抓重点，记住这几条：
- Claude Code不是单文件补全工具，而是能读项目、改文件、跑命令、做验证的代理式编码工具
- 最常见的起手式：
claude→ 先问代码库结构 → 再下明确任务 - 小任务直接做；多文件、重构、方案不明确时先
/plan - 想少被打断，就配好
CLAUDE.md、settings.json、/permissions - 想把重复动作自动化，就用 skill、hook、MCP、subagent
- 真正决定效果的，不是"提示词花不花"，而是你有没有给它明确目标和验证标准
2. 新手速查表
2.1 先做这4步
bash
cd /path/to/project
claude
# 进会话后先说：
give me an overview of this codebase
# 然后再给明确任务：
fix the login bug in src/auth.
run the related tests after the fix.2.2 最常用8条命令
| 命令 | 用途 |
|---|---|
claude | 启动交互式会话 |
claude -c | 继续当前目录最近一次会话 |
claude -p "..." | 一次性执行 |
/plan | 先研究再出方案 |
/clear | 开新对话，清理上下文 |
/compact | 压缩上下文，保留重点 |
/status | 看当前状态与配置 |
/memory | 查看CLAUDE.md和auto memory |
2.3 4个高频判断
| 场景 | 做法 |
|---|---|
| 小改动 | 直接让它改 |
| 多文件/不确定方案 | 先 /plan |
| 上下文开始变乱 | 用 /clear |
| 搜索/日志特别多 | 用 subagent |
2.4 最好这样下指令
尽量同时给3件事：
- 改哪里
- 要达到什么结果
- 怎么验证
示例：
Update src/auth/session.ts to handle expired tokens. Add a regression test. Run the auth test suite after the change.
2.5 别一上来就踩这几个坑
- ❌ 不要一个会话里混很多无关任务
- ❌ 不要只说"帮我看看"，要限定范围
- ❌ 不要让它改完就结束，要给验证动作
- ❌ 不要把一次性任务细节全塞进
CLAUDE.md
2.6 长期用顺手的关键
- 项目规则写进
CLAUDE.md - 常用权限配进
settings.json - 重复流程做成 skill
- 强制检查做成 hook
- 外部系统接 MCP
第一部分：先把Claude Code的使用边界想清楚
3. Claude Code是什么
官方定义：Claude Code是一个agentic coding tool，可在terminal、IDE、desktop app、browser中使用。
核心能力包括：
- 读取整个代码库，而不是只看当前文件
- 编辑文件、创建文件、重构多文件代码
- 运行shell命令、测试、构建、git操作
- 搜索代码、查文档、读取网页内容
- 通过MCP连接外部系统与工具
- 通过hooks、skills、subagents做自动化扩展
最适合它的场景有3类：
- 读代码库：快速理解项目结构、入口、模块关系、认证流程、数据模型
- 做开发任务：修bug、加功能、重构、补测试、写文档、整理提交信息
- 连外部系统：通过MCP访问GitHub、Sentry、数据库、Notion、Jira等
4. Claude Code可以在哪些地方用
4.1 主要使用界面：
| 界面 | 特点 |
|---|---|
| Terminal CLI | 最完整、最灵活 |
| VS Code扩展 | 图形化diff、@文件引用、计划审阅 |
| JetBrains插件 | IDE内diff、选择内容共享 |
| Desktop app | 本地原生应用，可并行会话 |
| Web/claude.ai/code | 浏览器里运行，适合长任务 |
5. Claude Code平时怎么工作
Claude Code的核心是一个agentic loop：
gather context → take action → verify results搜文件、读代码、了解结构 → 编辑文件、跑命令、调工具 → 跑测试、看输出、检查结果
这个循环会持续到任务完成。
第二部分：从安装到真正跑起来
6. 安装与登录
6.1 Terminal安装
bash
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex6.2 其他安装方式
bash
# Homebrew
brew install --cask claude-code
# WinGet
winget install Anthropic.ClaudeCode7. 5分钟上手流程
最短路径就是下面这几步：
bash
cd /path/to/your/project
claude
# 进入后可以直接问：
what does this project do?
where is the main entry point?
explain the folder structure
# 然后开始让它做事：
add a hello world function to the main file
there's a bug where users can submit empty forms - fix it
commit my changes with a descriptive message8. 最常用的CLI命令
| 命令 | 用途 |
|---|---|
claude | 启动交互式会话 |
claude -c | 继续当前目录最近一次会话 |
claude -r | 打开会话选择器，恢复历史会话 |
claude -p "..." | 一次性执行并退出 |
claude --model claude-sonnet-4-6 | 指定模型 |
claude --worktree feature-auth | 在隔离worktree里启动会话 |
9. 最常用的slash commands
| 命令 | 用途 |
|---|---|
/plan [description] | 直接进入计划模式 |
/clear | 开启新对话，清空当前上下文 |
/compact [instructions] | 压缩上下文，保留重点 |
/permissions | 管理allow/ask/deny规则 |
/skills | 查看可用skills |
/mcp | 管理MCP连接 |
/agents | 管理subagents |
/review [PR] | 本地review PR |
第三部分：进入日常使用状态之后
10. Permission Modes：权限模式怎么选
| 模式 | 不询问即可执行 | 适合场景 |
|---|---|---|
default | 只读 | 初次使用、敏感任务 |
acceptEdits | 读、文件编辑、常见文件系统命令 | 正常写代码 |
plan | 只读 | 先研究再改 |
auto | 几乎所有动作，有后台安全检查 | 长任务 |
dontAsk | 仅预先允许的工具 | CI、严格受限环境 |
bypassPermissions | 全放开 | 隔离容器/VM内 |
会话中按 Shift+Tab 循环切换常见模式
11. CLAUDE.md与Auto Memory
CLAUDE.md放哪儿：
| 作用域 | 位置 |
|---|---|
| 组织级 | /Library/Application Support/ClaudeCode/CLAUDE.md |
| 用户级 | ~/.claude/CLAUDE.md |
| 项目级 | ./CLAUDE.md 或 ./.claude/CLAUDE.md |
| 本地项目级 | ./.claude.local.md |
CLAUDE.md适合写什么：
- ✅ 构建/测试命令
- ✅ 项目约定
- ✅ 代码风格
- ✅ 常见坑
- ❌ 巨
