Claude Code 快速入门与核心概念

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-提效技巧大全