Claude Code 终极使用指南（2026最新版 v2.1.150）

🚀 Claude Code 终极使用指南（2026最新版 v2.1.150）

本文基于 Claude Code v2.1.150（2026年5月23日发布）官方文档编写，涵盖 25个CLI命令、58个flags、60+斜杠命令，是目前中文社区最全面、最详细、最接地气的 Claude Code 使用指南。

无论你是第一次听说 Claude Code 的小白，还是想深入挖掘高级功能的资深开发者，这篇文章都能让你从零上手到精通。

一、Claude Code 是什么？——30秒搞懂

想象一下，你的终端里坐着一个全能AI编程助手——它能读懂你的代码、自动修Bug、重构文件、执行命令、搜索代码库、甚至帮你操作浏览器。这就是 Claude Code。

一句话定义

Claude Code 是 Anthropic 推出的终端AI编程代理（agentic coding tool），它在你的命令行中运行，能理解你的项目、读写代码、执行Shell命令，像一个不知疲倦的超级搭档。

6大核心能力

三种使用姿势

二、安装与环境准备（全平台）

系统要求

安装方式（4种）

方式一：原生安装（官方推荐 ✅）

一行命令搞定，自动后台更新，永远保持最新版：

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方式二：Homebrew（macOS/Linux）

# 稳定版（通常比最新版晚约1周）
brew install --cask claude-code

# 最新版（跟随最新发布）
brew install --cask claude-code@latest

⚠️ Homebrew 安装不会自动更新，需要手动 brew upgrade claude-code

方式三：WinGet（Windows）

winget install Anthropic.ClaudeCode

⚠️ WinGet 安装同样不会自动更新，需要 winget upgrade Anthropic.ClaudeCode

方式四：Desktop App（GUI版）

不熟悉终端？直接用桌面应用：

# macOS 下载
https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect

# Windows 下载
https://claude.com/download

认证方式（3种）

验证安装

claude --version
# 输出类似: 2.1.150

三、5分钟快速上手

场景一：交互式对话（最常用）

# 进入你的项目目录
cd my-project

# 启动 Claude Code
claude

# 你会看到一个对话界面，直接打字就行：
> 帮我看看这个项目的结构，告诉我主要用了什么技术栈

Claude Code 会自动扫描你的项目文件，分析后给出回答。你可以接着追问：

> 帮我给 User 模型加一个 email 字段，并且写好迁移脚本

场景二：管道模式（脚本/CI用）

# 直接提问，输出结果后退出
claude -p "解释一下 src/auth.ts 的认证逻辑"

# 管道输入文件内容
cat error.log | claude -p "分析这段错误日志，给出修复建议"

# 输出为 JSON 格式
claude -p "列出所有 TODO 注释" --output-format json

场景三：继续上次对话

# 继续最近的对话
claude -c

# 继续特定会话（按名称或ID）
claude --resume "my-feature-work"

# 列出所有历史会话
claude sessions list

场景四：后台运行 NEW

# 启动后台任务
claude --bg "调查为什么测试一直失败"

# 查看后台任务状态
claude sessions list

四、CLI 命令完整参考（25个命令）

所有命令均可通过 claude --help 查看。以下是按使用场景分类的完整列表：

基础交互类

会话管理类

配置与维护类

开发工作流类 NEW

五、CLI Flags 大全（58个标志）

Flags 是附加在命令后面的选项，用来微调 Claude Code 的行为。下面按功能分类：

🔧 会话控制类

🧠 模型与输出控制类

🛡️ 权限与安全类

📝 提示词与上下文类

⚙️ 高级功能类

# 交互模式 + 高努力度 + 自动权限
claude --effort high --enable-auto-mode

# 管道模式 + JSON输出 + 限制轮数
claude -p "review code" --output-format json --max-turns 5

# Worktree隔离 + 指定模型
claude -w fix-bug --model claude-sonnet-4-20250514

# 后台运行 + 自动模式
claude --bg --enable-auto-mode "run full test suite"

六、系统提示词自定义

系统提示词是告诉 Claude Code "你是谁、该怎么做事" 的核心指令。Claude Code 提供了 4个不同层级 的自定义方式：

实用示例

# 让 Claude 扮演 Go 语言专家
claude --system-prompt "你是一个资深 Go 工程师，回答使用中文"

# 在默认基础上追加规则
claude --append-system-prompt "每次修改代码前先解释你的思路"

# 组合使用：指定模型 + 追加提示词
claude --model claude-sonnet-4-20250514 --append-system-prompt "遵循项目的 ESLint 配置"

七、斜杠命令完全指南（60+命令，按场景分类）

斜杠命令是 Claude Code 交互模式下的快捷操作。在对话中输入 / 即可看到所有可用命令。以下是按使用场景分类的完整列表：

📂 项目探索类

🔧 代码操作类

📊 质量保障类

🤖 代理与工作流类

🔍 调试与监控类

💡 高级命令

八、权限模式与安全机制（5种模式）

Claude Code 能读写文件、执行命令——这很强大，但也需要安全护栏。权限模式决定了 Claude Code 在执行操作前是否需要你确认。

5种权限模式对比

如何设置权限模式

# 方式一：命令行 flag
claude --permission-mode auto
claude --enable-auto-mode        # 快捷方式，等同 auto

# 方式二：在对话中随时切换
# 输入 Shift+Tab 可在模式间切换

# 方式三：配置文件设置
claude config set permissionMode acceptEdits

工具级权限控制

你还可以精确控制哪些工具允许或禁止：

# 只允许文件编辑和 git 操作
claude --allowedTools "Edit,Bash(git *)"

# 禁止删除操作
claude --disallowedTools "Bash(rm *)"

# 组合：Auto模式 + 禁止危险命令
claude --permission-mode auto --disallowedTools "Bash(rm -rf *)"

九、MCP（Model Context Protocol）工具扩展

想象 Claude Code 是一部手机，那 MCP 就是应用商店——通过它，你可以给 Claude Code 安装各种外部工具，连接数据库、调用 API、操作浏览器、搜索网络……

9.1 MCP 是什么？（通俗解释）

MCP（Model Context Protocol）是一个开放标准协议，由 Anthropic 发起，目的是让 AI 工具能标准化地连接外部数据源和工具服务。

通俗地说：

• 没有 MCP → Claude Code 只能操作你电脑上的文件和命令
• 有了 MCP → Claude Code 能连数据库、搜网页、操作 GitHub、读 Slack 消息……能力无限扩展

MCP 的架构很简单：Claude Code（客户端） ↔ MCP 服务器（中间层） ↔ 外部服务（GitHub/数据库/浏览器等）。MCP 服务器就像一个"翻译官"，把 Claude Code 的请求翻译成外部服务能理解的格式。

9.2 配置 MCP 服务器——两种方式

方式一：CLI 命令添加（适合快速试用）

# 基本语法
claude mcp add <名称> -t stdio -- <启动命令>

# 带环境变量（API Key 等）
claude mcp add github -t stdio -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github

# SSE 类型（远程服务器）
claude mcp add my-remote -t sse https://mcp.example.com/sse

方式二：配置文件（推荐，适合团队协作）

在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "BSA_xxx" }
    }
  }
}

9.3 常用 MCP 服务器一览

9.4 详细实战案例

📝 案例1：连接 PostgreSQL 数据库

场景：你有一个电商数据库，想让 Claude Code 帮你查数据、分析用户行为。

# 第1步：添加 MCP 服务器
claude mcp add postgres -t stdio -- \
  npx -y @modelcontextprotocol/server-postgres \
  postgresql://admin:password@localhost:5432/ecommerce

# 第2步：启动 Claude Code
claude

# 第3步：直接用自然语言查询
> "查询上个月销量前10的商品"
> "分析最近7天的新用户注册趋势"
> "找出从来没有下过单的注册用户"

# Claude Code 会自动：
# 1. 通过 MCP 连接 PostgreSQL
# 2. 生成 SQL 查询
# 3. 执行并返回结果
# 4. 用表格/图表展示（如果配合其他工具）

🐙 案例2：GitHub 项目管理

场景：你想让 Claude Code 帮你管理 GitHub Issues 和 PR。

# 第1步：添加 GitHub MCP 服务器
claude mcp add github -t stdio \
  -e GITHUB_TOKEN=ghp_your_token_here -- \
  npx -y @modelcontextprotocol/server-github

# 第2步：启动并操作
claude

> "查看 my-org/my-repo 仓库最近7天新开的 Issue"
> "创建一个新 Issue：标题'修复登录页面样式错误'，标签 bug"
> "给 PR #42 添加 review 评论：'建议把数据库查询改为异步'"
> "列出所有 milestone 为 v2.0 的未关闭 Issue"

# Claude Code 会直接通过 GitHub API 完成操作

🌐 案例3：浏览器自动化（Puppeteer）

场景：你想让 Claude Code 帮你自动操作网页——填写表单、截图、爬数据。

# 第1步：添加 Puppeteer MCP 服务器
claude mcp add browser -t stdio -- \
  npx -y @modelcontextprotocol/server-puppeteer

# 第2步：启动并操作
claude

> "打开 https://example.com 并截图"
> "在 Google 搜索 'Claude Code MCP' 并获取前5个结果"
> "打开管理后台，填写表单：姓名=张三，邮箱=test@example.com，提交"

# Claude Code 会：
# 1. 启动 Puppeteer 浏览器
# 2. 导航到指定页面
# 3. 执行点击/输入/截图操作
# 4. 返回结果

🔍 案例4：网络搜索 + 网页抓取

场景：你想让 Claude Code 搜索最新技术文档并总结。

# 第1步：添加搜索 + 抓取 MCP
claude mcp add search -t stdio \
  -e BRAVE_API_KEY=BSA_xxx -- \
  npx -y @modelcontextprotocol/server-brave-search

claude mcp add fetch -t stdio -- \
  npx -y @modelcontextprotocol/server-fetch

# 第2步：搜索 + 抓取组合使用
claude

> "搜索 React 19 的新特性，打开排名前3的文章，总结要点"

# Claude Code 会：
# 1. 通过 Brave Search 搜索
# 2. 通过 Fetch 抓取文章内容
# 3. 阅读并总结关键信息

📊 案例5：多工具组合——自动故障排查

场景：线上出 Bug，你想让 Claude Code 自动排查：查日志 + 查数据库 + 搜索解决方案。

# 配置多个 MCP 服务器
# .mcp.json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/prod_db"]
    },
    "sentry": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sentry"],
      "env": { "SENTRY_TOKEN": "xxx" }
    },
    "search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "xxx" }
    }
  }
}

# 使用
claude

> "用户反馈下单失败。请：
> 1. 查 Sentry 最近的错误日志
> 2. 查数据库最近失败的订单记录
> 3. 搜索这个错误信息的解决方案
> 4. 给我一份故障报告和修复建议"

# Claude Code 会自动协调3个 MCP 服务器联合工作！

9.5 管理 MCP 服务器

# 列出所有已配置的服务器
claude mcp list

# 查看某个服务器详情
claude mcp get github

# 删除服务器
claude mcp remove github

# 重置所有 MCP 配置
claude mcp reset

# 在交互模式中管理
> /list-mcp-servers    # 查看连接状态
> /mcp                 # 管理服务器

9.6 MCP 通信模式

十、Hooks 生命周期钩子

Hooks 让你在 Claude Code 执行操作的特定时机自动运行自定义脚本。就像 Git Hooks 一样——在某个动作发生前/后触发你的代码。

可用的 Hook 类型

配置 Hooks

在项目的 .claude/settings.json 中配置：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo '即将执行命令: $TOOL_INPUT' >> /tmp/claude-log.txt"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write $FILE_PATH"
          }
        ]
      }
    ]
  }
}

实用 Hook 示例

# 示例1：每次编辑文件后自动运行 lint
{
  "PostToolUse": [{
    "matcher": "Edit",
    "hooks": [{ "type": "command", "command": "npx eslint --fix $FILE_PATH" }]
  }]
}

# 示例2：阻止删除操作
{
  "PreToolUse": [{
    "matcher": "Bash",
    "hooks": [{
      "type": "command",
      "command": "if echo '$TOOL_INPUT' | grep -q 'rm'; then echo 'BLOCKED: 不允许删除'; exit 1; fi"
    }]
  }]
}

# 示例3：会话结束通知
{
  "Stop": [{
    "matcher": "",
    "hooks": [{ "type": "command", "command": "notify-send 'Claude Code 任务完成'" }]
  }]
}

十一、Skills 技能系统 NEW

Skills 是 Claude Code 的可复用指令模板——你可以把常用的操作流程封装成一个 Skill，下次直接调用。可以理解为"自定义斜杠命令"。

什么是 Skill？

一个 Skill 就是一个Markdown 文件，里面写好了详细的指令。当你在对话中使用 /skill 调用它时，Claude Code 会按照文件中的指令执行操作。

创建自定义 Skill

在项目的 .claude/skills/ 目录下创建 Markdown 文件：

# .claude/skills/code-review.md

# Code Review Skill

你是一个资深代码审查专家。请执行以下步骤：

1. 查看当前 git diff，了解所有变更
2. 对每个变更文件进行审查，关注：
   - 代码质量和可读性
   - 潜在的 Bug 和安全漏洞
   - 性能问题
   - 是否符合项目编码规范
3. 给出分级的审查意见：
   - 🔴 必须修改（会阻塞合并）
   - 🟡 建议修改（强烈推荐）
   - 🟢 可选优化（锦上添花）
4. 总结变更的整体质量评分（1-10）

使用 Skill

# 在交互模式中调用
> /skill code-review

# 或者通过 CLI flag 指定
claude --skill code-review

# 也可以通过斜杠命令查看所有可用 Skills
> /skill list

内置 Skills vs 自定义 Skills

十二、Computer Use 浏览器操控

想象 Claude Code 不只能操作代码，还能看到屏幕、操控浏览器——点击按钮、填写表单、截图分析，就像一个远程协助的同事。

什么是 Computer Use？

Computer Use 是 Claude Code 的浏览器自动化能力，基于 Chrome DevTools Protocol（CDP）。它让 Claude 能够：

• 📱 截取浏览器屏幕截图并分析内容
• 🖱️ 点击页面元素、填写表单
• 📋 执行自定义 JavaScript
• 🔄 导航页面、处理弹窗

启用 Computer Use

# 方式一：使用 Chrome MCP 服务器（推荐）
claude mcp add chrome -t stdio -- npx @anthropic/mcp-chrome

# 方式二：在 .mcp.json 中配置
{
  "mcpServers": {
    "chrome": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-chrome"]
    }
  }
}

实战场景

# 场景：让 Claude 帮你测试网页
> 请打开 http://localhost:3000，截个图看看页面长什么样

# 场景：自动填写表单
> 在登录页面填入用户名 admin 和密码 test123，然后点击登录按钮

# 场景：网页数据抓取
> 打开这个新闻网站，把首页所有文章标题提取出来

# 场景：UI 回归测试
> 对比当前页面截图和之前的基准截图，看看有什么变化

十三、Routines 自动化例程 NEW · 研究预览

Routines 让 Claude Code 在没有你监控的情况下自动执行任务——可以定时触发、API 触发、或 GitHub 事件触发。就像给 Claude Code 设了闹钟，到点自己干活。

触发方式

创建 Routine

# 在项目的 .claude/routines.json 中定义
{
  "routines": [
    {
      "name": "daily-review",
      "trigger": {
        "type": "scheduled",
        "cron": "0 9 * * 1-5"
      },
      "prompt": "检查昨天所有的代码变更，给出审查意见。重点关注安全漏洞和性能问题。",
      "model": "claude-sonnet-4-20250514"
    },
    {
      "name": "pr-review",
      "trigger": {
        "type": "github",
        "events": ["pull_request.opened", "pull_request.synchronize"]
      },
      "prompt": "审查这个 PR 的所有变更，给出详细的审查意见。",
      "permissionMode": "plan"
    }
  ]
}

管理 Routines

# 列出所有 Routines
claude routines list

# 手动触发某个 Routine
claude routines run daily-review

# 查看 Routine 运行历史
claude routines history

十四、Sub-Agents 子代理系统 NEW

想象你是一个项目经理——遇到复杂任务时，你可以派出专门的子代理去处理不同部分，最后汇总结果。Sub-Agents 就是这样的机制。

什么是 Sub-Agent？

Sub-Agent 是一个独立的 Claude Code 实例，有自己的系统提示词、工具权限和上下文。主代理可以把任务委托给它，并行处理多个子任务。

创建自定义 Agent

# 在项目的 .claude/agents/ 目录下创建 agent 配置

# .claude/agents/tester.md
你是一个专业的测试工程师。你的职责是：
1. 阅读代码变更
2. 编写对应的单元测试和集成测试
3. 确保测试覆盖率 > 80%
4. 运行测试并报告结果

规则：
- 使用项目已有的测试框架
- 遵循 AAA 模式（Arrange-Act-Assert）
- 测试命名使用 describe/it 风格

# .claude/agents/reviewer.md
你是一个严格的代码审查专家。你的职责是：
1. 审查所有变更的代码
2. 检查安全漏洞、性能问题、代码风格
3. 给出改进建议
4. 确保符合项目编码规范

使用 Sub-Agent

# 通过 CLI flag 指定 agent
claude --agent tester
claude --agent reviewer

# 在交互模式中切换
> /agent tester    # 切换到测试工程师模式
> /agent reviewer  # 切换到审查专家模式

# 定义多个 agent（命令行）
claude --agents "tester=测试工程师,reviewer=代码审查专家"

Agent View NEW

Agent View 让你能实时观察子代理的工作过程——看到它在做什么、执行了哪些工具调用、当前进度如何。

# 启用 Agent View
claude --agent-view

# 在对话中查看
> /agent            # 查看 agent 状态和日志