Claude Code 快速入门与核心概念
基于 GitHub anthropics/claude-code 仓库(110K+ Stars)的社区实践整理
一、Claude Code 是什么
Claude Code 是 Anthropic 官方推出的终端 AI 编程代理,可以:
- 理解整个代码库,用自然语言下达编码指令
- 自动编辑文件、运行命令、管理 Git 工作流
- 在终端、VS Code、JetBrains 等 IDE 中使用
- 在 GitHub 上通过
@claude调用
二、三个你必须知道的核心概念
1. CLAUDE.md — 你的”项目说明书”
这是 Claude Code 最重要的配置文件,相当于你给 AI 的项目操作手册。
支持三级配置,从全局到局部逐层覆盖:
~/.claude/CLAUDE.md ← 全局(你的个人偏好、通用规则)
项目根目录/CLAUDE.md ← 项目级(构建命令、代码规范)
项目子目录/CLAUDE.md ← 模块级(特定模块的上下文)
推荐写入的内容:
# 项目概述
Android 桌面 Launcher 项目,基于 Kotlin + Compose
# 构建与运行
- 编译: ./gradlew assembleDebug
- 测试: ./gradlew testDebugUnitTest
- Lint: ./gradlew lintDebug
# 代码规范
- 使用 Kotlin,禁止 Java 新代码
- 命名:驼峰命名法
- 每个 PR 必须有对应测试
# 安全规则
- 不要读取 .env 文件
- 不要提交包含密钥的文件来源:Issue #6235 (4645 reactions), #1091, #87
2. MCP (Model Context Protocol) — 工具扩展系统
MCP 让 Claude Code 可以连接外部工具,比如:
| MCP Server | 功能 |
|---|---|
| GitHub MCP | 搜索 Issue/PR、读写代码 |
| Playwright MCP | 浏览器自动化测试 |
| 飞书 MCP | 读写飞书文档、表格 |
| Jira MCP | 管理 Jira 任务 |
管理命令:
claude mcp add <name> -- <command> # 添加
claude mcp remove <name> # 移除
claude mcp list # 查看所有来源:Issue #6915 (379 reactions), #7328 (225 reactions)
3. 子 Agent — 并行处理复杂任务
当你给出复杂任务时,Claude Code 会自动派出多个子 agent 并行工作:
你: "分析这个项目的架构、测试覆盖率和依赖关系"
Claude Code 内部:
├── Agent A → 分析架构(同时)
├── Agent B → 分析测试(同时)
└── Agent C → 分析依赖(同时)
→ 汇总后一次性返回给你
你的最佳实践: 一次说清楚多个独立问题,给 Claude 并行的机会。
来源:Issue #6915 (379 reactions), #4476 (183 reactions)
三、常用命令速查
| 命令 | 功能 |
|---|---|
claude | 启动交互式会话 |
claude --resume | 恢复上次会话 |
claude -p "问题" | 单次提问(不进入交互) |
/compact | 压缩对话上下文,释放空间 |
/status | 查看当前用量 |
/rewind | 回退对话到之前的状态 |
/model | 切换模型 |
/help | 查看帮助 |
Tab 键 | 切换 thinking 模式 |
四、安装方式
# macOS / Linux(推荐)
curl -fsSL https://claude.ai/install.sh | sh
# 或用 npm(已弃用但仍可用)
npm install -g @anthropic-ai/claude-code下一篇: 02-提效技巧大全