张会挽's Blog

Claude Code 完整使用指南：AI 编程助手的核心用法

Posted on In

Claude Code 是 Anthropic 官方推出的智能体编程环境，不仅是一个聊天机器人，更是一个能读取代码仓库、跨文件编辑、执行 shell 命令、集成开发工具的 AI 编码助手。本文详细介绍其安装、核心概念和实用技巧。

Claude Code 是什么

核心定位

Claude Code 不是普通的 AI 聊天机器人，而是一个智能体编程环境（Agentic Coding System），具备以下能力：

  • 读取整个代码仓库
  • 跨多个文件编辑、创建文件
  • 执行 shell 命令、运行测试
  • 集成 git / GitHub / CI 等开发工具
  • 通过 MCP 接入 Jira、Slack、数据库等外部系统

支持的环境

环境 说明
CLI 终端 原生安装，跨平台
VS Code 官方扩展
JetBrains IDE 插件
桌面 App macOS / Windows
Web claude.ai/code

安装与启动

CLI 安装

macOS / Linux / WSL

1
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

1
irm https://claude.ai/install.ps1 | iex

Homebrew

1
2
brew install --cask claude-code      # 稳定版
brew install --cask claude-code@latest  # 最新版

WinGet

1
winget install Anthropic.ClaudeCode

VS Code 扩展安装

  1. VS Code 版本要求 ≥ 1.98.0
  2. 扩展市场搜索 “Claude Code” 安装
  3. 启动方式：
    • 编辑器右上角火花图标
    • 左侧活动栏火花图标
    • 状态栏右下角 “Claude Code”
    • 命令面板：Cmd+Shift+P → “Claude Code: Open in New Tab”

首次启动

1
2
cd your-project
claude

首次启动会引导登录 Anthropic 账号。

核心概念速览

概念 说明
Session 一次 claude 运行，有独立对话历史
Context Window 上下文窗口：对话 + 文件 + 输出的总容量
CLAUDE.md 项目级/全局说明文件，每次会话自动加载
Plan Mode 只读模式：只探索提问，不改文件
Accept Edits Mode 自动批准文件编辑（危险操作仍需确认）
Tool Claude 可调用的工具：读文件、编辑、执行命令等
MCP 接入外部系统的标准协议
Subagent 子代理：专注子任务，有独立上下文
Hook 特定事件自动执行的脚本（编辑后、提交前等）
Skill 打包的工作流指令，像 /xxx 一样调用

基础指令详解

Slash 命令

在提示框输入 / 可查看所有可用命令：

命令 作用
/help 列出所有可用命令
/init 探索代码库并生成初始 CLAUDE.md
/clear 清空当前会话历史（项目记忆保留）
/compact 压缩对话为摘要，腾出上下文
/btw 问旁注问题，不计入主对话
/rewind 回退到某个检查点
/model 查看/切换模型
/cost 查看 token 消耗
/usage 查看套餐用量和限速
/context 可视化当前上下文占用
/memory 查看/编辑当前 CLAUDE.md
/permissions 查看工具审批状态
/config 修改配置（主题、编辑模式等）
/plan 进入 Plan Mode
/diff 打开交互式 diff 查看器
/mcp 管理 MCP 服务器
/agents 管理 subagents
/hooks 查看 hook 配置
/skills 列出可用 skill
/doctor 诊断安装问题
/exit 退出 CLI

工作模式切换

快捷键 模式
Shift+Tab 循环切换：Default / Accept Edits / Plan Mode

VS Code 扩展操作

打开方式

方式 说明
编辑器右上角火花图标 需有文件打开
左侧活动栏火花图标 侧边栏打开
状态栏 “Claude Code” 快速打开
Cmd+Shift+P → “Open in New Tab” 新标签页

常用快捷键

命令 快捷键 说明
Focus Input Cmd+Esc / Ctrl+Esc 切换编辑器/输入框焦点
Open in New Tab Cmd+Shift+Esc / Ctrl+Shift+Esc 新标签页打开
New Conversation Cmd+N / Ctrl+N 新建对话
Insert @-Mention Option+K / Alt+K 插入文件引用

@ 引用文件

1
2
3
@src/auth/login.ts         # 引用文件
@src                       # 引用目录
@src/auth/login.ts:10-20   # 引用特定行范围

选中代码后按 Option+K / Alt+K 自动插入带行范围的引用。

扩展与定制

CLAUDE.md —— 项目记忆

  • 项目级：./CLAUDE.md（项目根目录）
  • 全局：~/.claude/CLAUDE.md（用户主目录）

每次会话自动加载，建议内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 项目说明

## 技术栈
- Python 3.11 + FastAPI
- PostgreSQL 15

## 目录结构
- src/: 源代码
- tests/: 测试

## 编码规范
- 命名：snake_case
- 测试覆盖率 > 80%

## 常用命令
- 启动：npm run dev
- 测试：npm test
- 部署：npm run deploy

技巧：不要一开始就写 CLAUDE.md，当发现反复说同一句话时，再让 Claude 帮你写。

Skills —— 可复用工作流

  • 放在 .claude/skills/ 下的 markdown 文件
  • 调用方式类似 /review-pr、/deploy-staging
1
2
3
4
5
6
7
8
{
  "skills": {
    "code-review": {
      "description": "代码审查",
      "prompt": "请审查当前代码，关注：\n1. 代码质量\n2. 潜在 bug\n3. 性能建议\n4. 安全问题"
    }
  }
}

Hooks —— 自动脚本

特定事件自动执行：

1
2
3
4
5
6
7
8
9
10
11
12
{
  "hooks": {
    "on_edit": {
      "command": "npx prettier --write {path}",
      "patterns": ["*.ts", "*.js"]
    },
    "pre_commit": {
      "command": "npm test",
      "allow_failure": false
    }
  }
}

常见场景：

  • 编辑后自动运行 prettier / eslint –fix
  • 提交前跑测试

MCP —— 外部系统集成

1
2
3
4
5
6
7
8
9
# 配置示例
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"]
    }
  }
}

典型用法：

  • 接 Jira：读/更新需求
  • 接 Slack：发通知
  • 接数据库：查询数据

Subagents —— 子代理

适合：

  • 大型代码库中做探索/搜索
  • 长时间任务（让子代理盯 CI，主代理继续写代码）

实用小技巧

1. 上下文管理

  • 上下文窗口是稀缺资源，对话越长越容易遗忘早期指令
  • 每个新话题开新会话
  • 长任务中途主动 /compact
  • 用 /context 查看上下文占用

2. 经典工作流

1
探索(Plan Mode) → 规划 → 实现 → 验证
  1. Explore：Plan Mode 下读代码、提问
  2. Plan：让它给出实现方案
  3. Implement：写代码、跑命令
  4. Verify：跑测试、看截图

3. 给验证手段

  • 给测试用例，让它跑测试
  • UI 改动给截图，实现后对比
  • 错误修复贴完整错误信息

4. 用 /btw 问临时问题

/btw 不写入主对话，不占上下文：

1
/btw 这个库的 API 怎么查？

5. 用 /rewind 回滚

Claude 改错或跑偏时：

1
/rewind

回到检查点，比手动撤销更安全。

6. 管道组合

1
2
3
4
5
# 分析日志
tail -200 app.log | claude -p "发现异常就通知我"

# 批量 review
git diff main --name-only | claude -p "审查这些改动"

7. CLI 与 VS Code 组合

  • VS Code 内嵌终端可用完整 CLI
  • @browser 控制浏览器（需安装 Chrome 扩展）

8. 定期检查权限

建议定期用 /permissions 查看，避免误批准危险命令：

1
2
# 危险操作示例
rm -rf ~  # 千万别批准

完整使用示例

添加邮箱校验函数

1
2
cd your-project
claude

1. 初始化

1
/init

让 Claude 读懂项目，生成 CLAUDE.md。

2. 探索（Plan Mode）

1
/plan

然后：

1
读一下 src/utils 目录，我们通常把工具函数放在哪里？这个项目用什么测试框架？

3. 明确任务

退出 Plan Mode（Shift+Tab），然后：

1
2
3
4
5
6
7
在 src/utils/validation.ts 中实现 validateEmail 函数。

要求：
- 只接受正常邮箱格式
- 拒绝异常格式如 user@.com
- 写完后在 tests/validation.test.ts 添加测试
- 运行测试通过后再提交

4. 查看改动

1
/diff

5. 提交

1
创建分支 feature/add-validate-email，提交改动，创建 draft PR

6. 如需回退

1
/rewind

相关资源

官方资源

社区资源

总结

Claude Code 使用要点：

方面 建议
启动 先 /init 了解项目
工作流 探索→规划→实现→验证
上下文 长对话定期 /compact
安全 定期检查 /permissions
效率 用 /btw 问临时问题
定制 CLAUDE.md + Skills + Hooks

核心思路：把 Claude 当成搭档而非工具，先探索再行动，给它验证手段，信任但也要检查。