wesammustafa/Claude-Code-Everything-You-Need-to-Know

Claude Code – 实用指南

是什么 – 本仓库是 Anthropic 官方命令行接口 Claude Code 的逐步教程。该工具允许您直接在终端中运行 Claude（公司的大型语言模型）。本指南将引导您完成 CLI 安装、认证、向 Claude 发送指令以读取和编辑代码，并通过自定义 Skills、Hooks、Sub-agents、Workflows 和 MCP 服务器扩展工具。

适合人群 –

• 新手：从未使用过 Claude Code 的用户可按照「设置 → 提示工程 → 第一个技能」路径，在约 15 分钟内上手。
• 资深用户：可深入学习 Skills、Hooks 以及 Model-Context-Protocol（MCP）的深层内容。
• 团队负责人 / 自动化工程师：可学习如何构建多代理团队、动态工作流，以及适用于大型项目的 BMAD 框架。

涵盖的关键概念

功能	作用	文件位置
Skills（斜杠命令）	可复用的 Markdown 提示，可通过 /skill-name 调用 Claude。适用于重复性任务（如打开 PR、运行测试）。	.claude/commands/*.md
Hooks	在会话启动、工具使用或子代理终止等事件时自动运行的脚本。	.claude/settings.json（连接到 .claude/hooks/ 中的 Python 脚本）
Sub-agents	拥有独立上下文的隔离 Claude 会话，适用于大型子任务。	.claude/agents/*.md
Workflows	JavaScript 文件，用于协调多个代理和工具以解决复杂任务。	.claude/workflows/*.js
MCP（Model-Context-Protocol）服务器	使 Claude 能够从 CLI 调用外部服务（浏览器、数据库、API 等）。按项目配置。	项目特定配置文件（无固定路径）

本仓库如何帮助您

• .claude/ 目录 是一个可直接复制使用的示例项目，包含每种扩展点（7 个斜杠技能、5 个子代理、动态工作流、Python Hooks 等）各一个。
• 详细的 Markdown 指南（docs/skills.md、docs/reference/effort-levels.md 等）解释了 effort levels、提示工程 以及构建 AI 代理框架的 BMAD 方法背后的思维模型。
• 速查链接和表格可轻松选择合适的模型（Sonnet 5、Opus 4.8、Fable 5 等）和适当的努力等级（low → ultracode）。

为何重要 – Claude Code 将 LLM 驱动的编码辅助引入开发者的原生 shell 工作流，使模型能够：

1. 读取整个仓库（文件树、导入、grep 结果），而不仅仅是粘贴的片段。
2. 就地编辑文件 并自动运行测试套件，提供即时反馈。
3. 通过斜杠命令、钩子和外部 MCP 服务与您现有的工具链集成。

通过提供具体、可复制粘贴的示例，本指南降低了团队采用 AI 驱动自动化时的门槛，而无需锁定在特定编辑器或 IDE 中。

---

快速开始

npm install -g @anthropic-ai/claude-code   # 安装 CLI
claude                                    # 认证（打开浏览器）
cd my-project && claude                    # 启动 Claude 会话
/explain what this codebase does           # 示例提示