📺 Claude Code 从 0 到 1 全攻略（详细版）

第一部分：环境搭建与基础交互

1.1 安装 Claude Code

# macOS 安装
brew install claude-code

# 或通过 npm
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

1.2 登录与授权

# 首次登录
claude login

# 使用 Anthropic API Key 登录
claude login --api-key YOUR_API_KEY

# 退出登录
claude logout

1.3 三种模式详解

# 默认模式 - 简单对话
claude

# 自动模式 - 自动执行操作
claude --dangerously-auto-approve

# 规划模式 - 先规划再执行
# 在对话中输入 /plan 或通过指令触发

---

第二部分：复杂任务处理与终端控制

2.1 执行终端命令 (Bash)

# 直接在对话中让 Claude 执行命令
# 例如：帮我安装 Node.js 依赖
npm install

# 或执行任意 shell 命令
ls -la

2.2 规划模式 (Plan Mode)

# 启用规划模式
claude --plan

# 在会话中启用
/plan

# 查看计划
/plan show

# 执行计划
/plan execute

2.3 跳过权限检测

# 危险命令自动批准
claude --dangerously-skip-permissions

# 在对话中
# 当遇到权限确认时，输入 "yes" 或 "always"

2.4 后台任务管理

# 后台执行任务
claude --background "npm run build"

# 或在会话中使用后台任务
# 后台运行某个长时间任务

# 查看后台任务
jobs

# 管理后台进程
fg / bg

---

第三部分：多模态与上下文管理

3.1 版本回滚 (Rewind)

# 回滚到之前的版本
claude rewind [版本数]

# 查看历史
claude history

# 恢复特定版本
claude restore [version-id]

3.2 图片处理

# 查看图片
# 直接在对话中发送图片，Claude 会自动分析

# 描述图片内容
# 发送图片后询问："描述这张图片"

3.3 安装 MCP Server（以 Figma 为例）

# 全局安装
npm install -g @anthropic/mcp-figma

# 或通过 npx
npx @anthropic/mcp-figma

# 配置 MCP（通常在 claude_config.json 中）
{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-figma"]
    }
  }
}

3.4 恢复历史会话

# 查看历史会话
claude sessions list

# 恢复特定会话
claude sessions resume [session-id]

# 或使用 Resume 功能
/resume [session-id]

3.5 上下文压缩与清除

# 压缩上下文
/compress

# 清除上下文
/clear

# 查看 token 使用情况
/tokens

3.6 项目记忆文件 (CLAUDE.md)

# 在项目根目录创建 CLAUDE.md
# Claude 会自动读取此文件作为项目上下文

# 示例 CLAUDE.md 内容：
# # 项目名称
# - 技术栈：React + TypeScript
# - 常用命令：npm run dev
# - 代码风格：使用 ESLint + Prettier

---

第四部分：高级功能扩展与定制

4.1 Hook

// 创建 hooks/commit-msg.js
module.exports = {
  'commit-msg': async (context) => {
    // 自动检查 commit message 格式
    const msg = context.message;
    if (!msg.match(/^(feat|fix|docs|style|refactor|test|chore):/)) {
      throw new Error('Commit message 格式不符合规范');
    }
  }
};

4.2 Agent Skill

# 创建 skill 目录
mkdir -p ~/.claude/skills

# 创建 skill 文件 (例如：skill-name/SKILL.md)
# 格式：描述 skill 功能和用法

4.3 SubAgent

# 使用 SubAgent
# 在对话中使用 @ 调用子代理
@subagent [任务描述]

# 常用子代理：
# - Code Review Agent
# - Test Agent
# - Refactor Agent

4.4 Skill vs SubAgent 区别

特性	Skill	SubAgent
用途	扩展命令和能力	独立任务执行
调用方式	/skill-name	@agent-name
生命周期	会话级	可独立运行
适用场景	常用操作模板	复杂独立任务

4.5 Plugin

# 安装插件
claude plugin install [plugin-name]

# 官方插件示例
claude plugin install @anthropic/plugin-code-review

# 配置插件
# 在 claude_config.json 中添加
{
  "plugins": {
    "code-review": {
      "enabled": true
    }
  }
}

---

📌 常用命令速查表

# 基础命令
claude                    # 启动对话
claude -p [prompt]        # 快速执行
claude --version          # 查看版本

# 会话管理
claude sessions list      # 列出所有会话
claude sessions resume    # 恢复会话
claude sessions delete    # 删除会话

# 配置
claude config edit        # 编辑配置
claude config show        # 查看配置

# 权限
--dangerously-auto-approve    # 自动批准
--dangerously-skip-permissions # 跳过权限