[特殊字符] Claude Code 完全使用手册（2025版）

剑laii

1904人浏览 · 2026-01-06 11:24:36

剑laii · 2026-01-06 11:24:36 发布

🤖 Claude Code 完全使用手册（2025版）

文档定位：本指南是Claude Code的完整使用手册，涵盖从入门到精通的全部内容，包括端到端开发、自动化工作流、插件系统等高级功能。

📋 目录

Claude Code 概述
安装与配置
核心功能详解
端到端开发实战
高级特性
插件系统
最佳实践
常见问题

一、Claude Code 概述

1.1 什么是Claude Code

Claude Code 是Anthropic推出的AI驱动的命令行编程工具，它不仅仅是一个代码补全工具，更是一个全自主的AI编程代理。

核心特性：

✅ CLI驱动：完全在终端中工作，无需离开开发环境
✅ 全自主代理：能理解整个代码库，执行多步骤复杂任务
✅ 30+小时连续编码：可处理长达30小时的自主开发任务
✅ 多代理协作：支持多个子代理并行工作
✅ 检查点恢复：支持进度保存和断点续传
✅ 浏览器自动化：原生控制Chrome进行E2E测试

1.2 与传统AI编程工具的区别

维度	传统AI编程工具	Claude Code
工作流	IDE插件，需要切换窗口	CLI驱动，完全在终端
任务处理	单一任务	多步骤复杂任务
代码库理解	单文件或当前文件	整个代码库
自主性	需要人工指导	高度自主
持续时间	几分钟到几十分钟	数小时到数天
协作能力	单一AI	多AI并行
可扩展性	固定功能	插件系统、MCP

1.3 能力边界

✅ 擅长：

理解大型代码库
重构和迁移
修复大量bug
编写测试
端到端功能开发
文档生成
代码审查

⚠️ 不适合：

需要高度创造性设计的任务
需要丰富领域知识（除非提供）
超长对话（超过100轮）
极其复杂的架构决策

二、安装与配置

2.1 系统要求

支持的操作系统：

macOS（Intel和Apple Silicon）
Linux（Ubuntu、Debian、CentOS等）
Windows（通过WSL2）
Windows（原生支持，正在完善中）

依赖项：

Node.js 18+ 或 Python 3.8+
Git
curl 或 wget

2.2 安装方法

方法1：npm安装（推荐）

npm install -g @anthropic-ai/claude-code

方法2：pip安装

pip install claude-code

方法3：通过Homebrew（macOS）

brew install claude-code

方法4：手动安装

# 下载最新版本
curl https://claude.ai/api/claude-code/latest/install.sh -o install.sh
chmod +x install.sh
./install.sh

2.3 配置文件详解

配置文件位置

全局配置：

macOS/Linux: ~/.claude/settings.json
Windows: %USERPROFILE%\.claude\settings.json

项目配置：

<project-root>/.claude/settings.json

个人配置（不提交到Git）：

<project-root>/.claude/settings.local.json

settings.json 完整配置示例

{
  // API配置
  "apiKey": "your-api-key-here",
  "apiBase": "https://api.anthropic.com",

  // 模型选择
  "model": "claude-sonnet-4.5",
  "thinkingBudget": 100000,

  // MCP服务器配置
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
    }
  },

  // 权限配置
  "permissions": {
    "allowedTools": ["read", "write", "execute", "search"],
    "allowedPaths": [
      "/path/to/project",
      "/path/to/another/project"
    ],
    "deniedPaths": [
      "/etc",
      "/usr/bin"
    ]
  },

  // 信任配置
  "trust": {
    "autoApprove": false,
    "trustedDomains": [
      "github.com",
      "gitlab.com"
    ]
  },

  // CLI行为配置
  "cli": {
    "pager": "less",
    "editor": "vim",
    "confirmDangerous": true,
    "showThinking": false,
    "maxFileSize": 10485760
  },

  // Git集成
  "git": {
    "autoCommit": false,
    "commitTemplate": "feat: {summary}\n\n{body}",
    "signCommits": false
  },

  // 通知配置
  "notifications": {
    "enabled": true,
    "sound": true,
    "desktop": true
  }
}

2.4 环境变量配置

# API密钥
export ANTHROPIC_API_KEY="your-api-key-here"

# API基础URL（如果使用代理）
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

# 模型选择
export CLAUDE_MODEL="claude-sonnet-4.5"

# 默认编辑器
export CLAUDE_EDITOR="vim"

# 调试模式
export CLAUDE_DEBUG="true"

三、核心功能详解

3.1 Plan Mode（规划模式）

什么是Plan Mode：

一种让Claude先规划后执行的工作模式
适合3个步骤以上的复杂任务
生成计划文件 → 用户审核 → 执行

触发方式：

自动触发：任务复杂度>=3步
手动触发：使用--plan标志
显式请求：告诉Claude"进入plan mode"

Plan Mode工作流：

1. 理解任务
2. 探索代码库
3. 设计实现方案
4. 写入计划文件
5. 等待用户批准
6. 执行计划
7. 报告完成

计划文件格式：

位置：~/.claude/plans/<plan-name>.md
内容：任务描述、实现步骤、关键文件
作用：用户可编辑计划，批准后再执行

3.2 子代理（Sub-Agents）

什么是Sub-Agents：

并行执行多个子任务
每个子代理专注于特定领域
最大化效率

子代理类型：

general-purpose：通用代理，处理复杂查询
Explore：代码库探索代理
Plan：规划代理
claude-code-guide：Claude Code使用指南代理

使用场景：

同时探索多个代码区域
并行运行测试
多文件同时重构
同时处理多个bug

示例：

用户："修复这些10个bug"

Claude：
1. 启动10个Explore代理（并行）
2. 每个代理探索一个bug相关代码
3. 汇总所有发现
4. 制定修复计划
5. 执行修复

3.3 TodoWrite（任务追踪）

什么是TodoWrite：

任务管理和追踪工具
适合复杂、多步骤任务
实时显示进度

使用方法：

用户："实现一个新功能，包含前端、后端、测试"

Claude：
1. 自动使用TodoWrite
2. 创建任务列表：
   - [ ] 设计API
   - [ ] 实现后端
   - [ ] 实现前端
   - [ ] 编写测试
   - [ ] 部署
3. 执行时更新状态（pending → in_progress → completed）
4. 完成后清空列表

任务状态：

pending：待处理
in_progress：进行中（同一时间只能有一个）
completed：已完成

3.4 检查点（Checkpoints）

什么是检查点：

保存当前进度
支持断点续传
长时间任务的保险

自动检查点：

每30分钟自动保存
每完成一个主要步骤保存
遇到错误前自动保存

手动检查点：

用户："创建一个检查点"

Claude：
1. 保存当前状态
2. 记录已完成的工作
3. 记录待办任务
4. 输出检查点ID

恢复检查点：

用户："从检查点abc123恢复"

Claude：
1. 读取检查点状态
2. 恢复上下文
3. 继续执行

3.5 Git集成

自动Git操作：

自动创建分支
自动提交（可配置）
自动生成commit message
支持PR创建

Git Hook集成：

pre-commit：代码审查、测试
pre-push：完整测试套件
commit-msg：验证commit格式

示例工作流：

用户："实现用户认证功能"

Claude：
1. 创建分支：feature/user-auth
2. 实现代码
3. 运行测试
4. 自动提交：
   git add .
   git commit -m "feat: implement user authentication"
5. 用户审核后
6. 推送并创建PR

四、端到端开发实战

4.1 端到端开发的定义

端到端开发是指从需求分析到部署上线的完整开发流程，包括：

需求分析：理解用户需求
架构设计：设计系统架构
数据库设计：设计数据模型
后端开发：API实现
前端开发：UI实现
测试编写：单元测试、集成测试
部署配置：Docker、CI/CD
文档编写：API文档、使用手册

4.2 完整示例：开发一个博客API

阶段1：需求分析（0-30分钟）

用户输入：

"我想开发一个博客API，支持：
- 文章的CRUD
- 用户认证
- 评论功能
- 标签分类
- 请使用Node.js + Express + MongoDB"

Claude的行动：

询问细节（如果需要）
分析技术栈
设计API规范
设计数据库Schema
生成项目结构

阶段2：项目初始化（30-60分钟）

Claude的行动：

创建项目目录结构
初始化npm项目
安装依赖
配置TypeScript
配置ESLint、Prettier
创建.gitignore
初始化Git仓库

命令：

npx create-express-api blog-api
cd blog-api
npm install mongoose jsonwebtoken bcrypt
npm install -D typescript @types/node @types/express

阶段3：数据库模型（60-120分钟）

Claude的行动：

设计User Schema
设计Post Schema
设计Comment Schema
设计Tag Schema
创建Mongoose模型
添加索引和验证

文件结构：

src/
  models/
    User.ts
    Post.ts
    Comment.ts
    Tag.ts

阶段4：后端API实现（120-240分钟）

Claude的行动：

实现认证中间件
实现用户注册/登录API
实现文章CRUD API
实现评论API
实现标签API
添加错误处理
添加请求验证

并行策略：

子代理1：实现认证相关API
子代理2：实现文章CRUD
子代理3：实现评论功能
子代理4：实现标签功能

主代理：协调、汇总、测试

阶段5：测试编写（60-120分钟）

Claude的行动：

编写单元测试（Jest）
编写集成测试
编写API测试（Supertest）
设置测试覆盖率
编写E2E测试（Playwright）

阶段6：部署配置（60-120分钟）

Claude的行动：

创建Dockerfile
创建docker-compose.yml
配置Nginx
配置环境变量
创建CI/CD pipeline
编写部署文档

阶段7：文档生成（30-60分钟）

Claude的行动：

生成API文档（Swagger）
生成README.md
生成 CONTRIBUTING.md
生成CHANGELOG.md
生成架构图

4.3 端到端开发的时间线

小项目（1-3天工作量）：

需求分析：30分钟
架构设计：30分钟
开发：4-8小时（Claude可加速3-5倍）
测试：2-3小时
部署：1-2小时
总计：8-14小时（1-2个工作日）

中项目（1-2周工作量）：

需求分析：1-2小时
架构设计：2-4小时
开发：16-32小时（Claude可加速3-5倍）
测试：8-12小时
部署：4-6小时
总计：31-56小时（4-7个工作日）

大项目（1-3月工作量）：

需求分析：1-2天
架构设计：2-4天
开发：40-80小时（Claude可加速3-5倍）
测试：20-30小时
部署：10-15小时
总计：73-131小时（9-16个工作日）

4.4 让Claude自主工作的技巧

技巧1：提供充分的上下文

❌ 不好：

"实现一个用户注册功能"

✅ 好：

"实现一个用户注册功能，要求：
1. 使用邮箱+密码注册
2. 密码需要bcrypt加密
3. 注册后发送验证邮件
4. 使用JWT进行认证
5. 参考项目中的auth.ts文件
6. 遵循项目的代码风格
7. 包含单元测试"

技巧2：明确工作流程

❌ 不好：

"做前端和后端"

✅ 好：

"按以下顺序工作：
1. 先设计API规范（RESTful）
2. 实现后端API（Express + MongoDB）
3. 编写API测试
4. 实现前端UI（React）
5. 集成前后端
6. 编写E2E测试
7. 每完成一个阶段向我汇报"

技巧3：使用Plan Mode

适用场景：

任务包含3个以上步骤
需要架构设计
需要重构
不确定实现路径

使用方法：

"进入plan mode，设计一个博客系统的架构"

或者：

"使用plan mode规划如何重构这个模块"

技巧4：利用CLAUDE.md

CLAUDE.md的作用：

项目记忆
代码规范
常用命令
架构说明

CLAUDE.md示例：

# 项目名称

## 项目概述
这是一个电商API项目，使用Node.js + Express + MongoDB。

## 代码规范
- 使用TypeScript
- 遵循Airbnb Style Guide
- 函数名使用camelCase
- 类名使用PascalCase

## 常用命令
# 开发
npm run dev

# 测试
npm test

# 构建
npm run build

# 部署
npm run deploy

## 架构说明
- src/api：API路由
- src/models：数据模型
- src/services：业务逻辑
- src/middleware：中间件
- src/utils：工具函数

## Git工作流
- main：生产环境
- develop：开发环境
- feature/*：功能分支

## 测试策略
- 单元测试：覆盖率>80%
- 集成测试：所有API
- E2E测试：关键流程

技巧5：提供验证标准

❌ 不好：

"写测试"

✅ 好：

"编写单元测试，要求：
1. 使用Jest框架
2. 覆盖率>80%
3. 测试所有API端点
4. 测试错误情况
5. 运行测试并确保全部通过
6. 生成覆盖率报告"

技巧6：设置合理的检查点

长时间任务：

"开发这个功能，这是一个大任务。
请每完成一个模块就创建检查点：
1. 数据模型检查点
2. API检查点
3. 前端检查点
4. 测试检查点

这样如果出错，我可以从上一个检查点恢复。"

技巧7：使用子代理并行

适用场景：

多个独立的子任务
需要同时探索多个代码区域
需要同时运行多个测试

示例：

"重构这5个模块，使用5个子代理并行工作"

五、高级特性

5.1 MCP（Model Context Protocol）

什么是MCP：

AI工具集成的开放标准
就像AI界的"USB协议"
让Claude连接数百个外部工具和数据源

MCP服务器类型：

GitHub：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

文件系统：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"]
    }
  }
}

PostgreSQL：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/db"]
    }
  }
}

Puppeteer（浏览器自动化）：

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

MCP使用示例：

用户："从GitHub读取这个issue，分析需求，然后实现解决方案"

Claude：
1. 使用GitHub MCP读取issue
2. 理解需求
3. 设计方案
4. 实现代码
5. 运行测试
6. 提交PR

5.2 Hooks（钩子系统）

什么是Hooks：

在特定工作流节点自动执行shell命令
自动化CI/CD集成
自定义工作流

Hook类型：

pre-command：命令执行前

{
  "hooks": {
    "pre-command": "npm run lint"
  }
}

post-command：命令执行后

{
  "hooks": {
    "post-command": "npm run test"
  }
}

pre-commit：Git提交前

{
  "hooks": {
    "pre-commit": "npm run test && npm run lint"
  }
}

post-commit：Git提交后

{
  "hooks": {
    "post-commit": "npm run notify && git push"
  }
}

Hook示例：

{
  "hooks": {
    "pre-command": [
      "echo 'Running pre-command checks...'",
      "npm run format-check",
      "npm run lint-check"
    ],
    "post-command": [
      "echo 'Running post-command tasks...'",
      "npm run test",
      "npm run build"
    ]
  }
}

5.3 Skills（技能系统）

什么是Skills：

知识封装系统
自定义AI能力
将通用AI转变为专用AI

Skill目录结构：

.claude/skills/my-skill/
├── SKILL.md          # 技能定义
├── prompt.md         # 提示词模板
├── script.sh         # 脚本文件
├── template.md       # 代码模板
└── resources/        # 资源文件

SKILL.md示例：

# 技能名称：React组件生成器

## 描述
自动生成React组件，包含TypeScript类型、测试、Story。

## 使用场景
- 快速创建新组件
- 确保代码风格一致
- 自动生成测试

## 触发关键词
"创建一个React组件"
"生成一个按钮组件"
"写一个表单组件"

Skills开发流程：

定义技能（SKILL.md）
编写提示词（prompt.md）
准备模板（template.md）
编写脚本（script.sh）
测试技能
部署技能

5.4 自定义命令（Slash Commands）

什么是自定义命令：

简化常用操作
封装复杂工作流
提高开发效率

命令定义：

.claude/commands/deploy.md

deploy.md示例：

---
description: 部署应用到生产环境
---

请执行以下部署流程：
1. 运行测试
2. 构建项目
3. 运行Docker容器
4. 健康检查
5. 回滚（如果失败）

使用方法：

claude /deploy

命令参数：

---
description: 创建API端点
arguments:
  - name: endpoint
    description: API端点路径
    required: true
  - name: method
    description: HTTP方法
    required: false
---

请创建一个{{method}} {{endpoint}}端点

使用方法：

claude /create-api endpoint:/users method:POST

5.5 浏览器自动化

什么是浏览器自动化：

原生控制Chrome
E2E测试
UI调试
Web抓取

配置Puppeteer MCP：

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

使用示例：

用户："测试用户登录流程"

Claude：
1. 打开浏览器
2. 导航到登录页面
3. 输入用户名和密码
4. 点击登录按钮
5. 验证登录成功
6. 截图保存
7. 关闭浏览器
8. 生成测试报告

六、插件系统

6.1 插件架构

插件的4大核心组件：

Slash Commands（斜线命令）：
- 自定义命令
- 参数化命令
- 命令链
Sub Agents（子代理）：
- 专用代理
- 并行执行
- 任务分解
MCP Servers：
- 工具集成
- 数据源连接
- API扩展
Hooks：
- 工作流自动化
- CI/CD集成
- 自定义触发器

6.2 插件开发示例

场景：自动化博客发布工作流

插件结构：

.claude/plugins/blog-publisher/
├── plugin.json         # 插件配置
├── commands/
│   ├── new-post.md     # 创建新文章
│   └── publish.md      # 发布文章
├── skills/
│   └── markdown-writer/
├── hooks/
│   └── pre-publish.sh
└── resources/
    └── templates/

plugin.json：

{
  "name": "blog-publisher",
  "version": "1.0.0",
  "description": "自动化博客发布工作流",
  "author": "Your Name",
  "commands": [
    "new-post",
    "publish"
  ],
  "skills": [
    "markdown-writer"
  ],
  "hooks": {
    "pre-publish": "./hooks/pre-publish.sh"
  },
  "mcpServers": {
    "cms": {
      "command": "node",
      "args": ["./integrations/cms.js"]
    }
  }
}

6.3 插件安装与管理

安装插件：

# 从GitHub安装
claude plugin install username/blog-publisher

# 从本地安装
claude plugin install ./blog-publisher

# 从URL安装
claude plugin install https://github.com/username/blog-publisher

启用/禁用插件：

# 启用插件
claude plugin enable blog-publisher

# 禁用插件
claude plugin disable blog-publisher

# 查看插件状态
claude plugin list

插件开发最佳实践：

模块化设计
充分测试
文档完善
版本管理
社区共享

七、最佳实践

7.1 Boris的9条实战技巧

Boris是谁：

Claude Code之父
Anthropic首席工程师
亲身使用者

9条技巧：

并行处理：
- 使用子代理并行执行任务
- 提高效率3-5倍
学会规划：
- 复杂任务使用Plan Mode
- 先设计后实现
积累CLAUDE.md：
- 记录项目知识
- 记录代码规范
- 记录常用命令
提供验证手段：
- 测试命令
- 检查脚本
- 自动化验证
利用MCP：
- 连接外部工具
- 扩展能力边界
自定义命令：
- 封装重复工作
- 提高效率
使用Hooks：
- 自动化工作流
- 集成CI/CD
监控成本：
- 追踪token使用
- 选择合适模型
- 优化提示词
社区协作：
- 分享插件
- 分享技能
- 分享最佳实践

7.2 提示词工程最佳实践

原则1：具体明确

❌ "优化代码"
✅ "优化user.ts中的fetchUsers函数，
   减少API调用次数，使用缓存"

原则2：提供上下文

❌ "实现一个登录功能"
✅ "参考src/auth/auth.ts中的现有认证逻辑，
   实现OAuth登录，支持Google和GitHub"

原则3：明确输出格式

❌ "生成一个文档"
✅ "生成一个Markdown格式的API文档，
   包含：端点、参数、响应、示例"

原则4：设置验证标准

❌ "写测试"
✅ "写Jest测试，覆盖率>80%，
   包含正常和异常情况，
   所有测试必须通过"

原则5：提供示例

❌ "遵循项目代码风格"
✅ "参考src/services/userService.ts的代码风格，
   使用相同的命名约定和错误处理模式"

7.3 项目组织最佳实践

目录结构：

my-project/
├── .claude/                    # Claude Code配置
│   ├── settings.json          # 项目配置
│   ├── CLAUDE.md              # 项目记忆
│   ├── commands/              # 自定义命令
│   ├── skills/                # 技能
│   └── plugins/               # 插件
├── src/                       # 源代码
│   ├── api/                   # API
│   ├── models/                # 数据模型
│   ├── services/              # 业务逻辑
│   ├── utils/                 # 工具函数
│   └── types/                 # 类型定义
├── tests/                     # 测试
│   ├── unit/                  # 单元测试
│   ├── integration/           # 集成测试
│   └── e2e/                   # E2E测试
├── docs/                      # 文档
│   ├── api/                   # API文档
│   └── guides/                # 指南
├── scripts/                   # 脚本
│   ├── build.sh
│   ├── deploy.sh
│   └── test.sh
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

CLAUDE.md模板：

# 项目名称

## 项目概述
[项目描述]

## 技术栈
- 后端：Node.js + Express + MongoDB
- 前端：React + TypeScript
- 测试：Jest + Playwright

## 代码规范
- 使用TypeScript
- 遵循ESLint规则
- 使用Prettier格式化

## 常用命令
```bash
# 开发
npm run dev

# 测试
npm test

# 构建
npm run build

# 部署
npm run deploy

架构说明

[架构描述]

Git工作流

main：生产环境
develop：开发环境
feature/*：功能分支

重要文件

src/api/auth.ts：认证相关API
src/models/User.ts：用户数据模型
src/services/authService.ts：认证业务逻辑

开发注意事项

所有API需要认证
使用async/await处理异步
错误处理统一使用error中间件
所有敏感信息使用环境变量

测试策略

单元测试：覆盖率>80%
集成测试：所有API
E2E测试：关键流程

7.4 成本优化

模型选择策略：

简单任务 → Claude Haiku（最快、最便宜）
中等任务 → Claude Sonnet 3.5
复杂任务 → Claude Sonnet 4.5
超复杂任务 → Claude Opus

提示词优化：

精简提示词
删除冗余信息
使用具体指令
避免重复上下文

缓存策略：

{
  "cache": {
    "enabled": true,
    "maxSize": 1000,
    "ttl": 3600
  }
}

监控token使用：

# 查看token使用情况
claude stats

# 设置token预算
export CLAUDE_TOKEN_BUDGET=1000000

7.5 安全最佳实践

权限管理：

{
  "permissions": {
    "allowedTools": ["read", "write"],
    "allowedPaths": ["/path/to/project"],
    "deniedPaths": [
      "/etc",
      "/usr/bin",
      "~/.ssh"
    ]
  }
}

敏感信息处理：

使用环境变量
不要在代码中硬编码
使用.env文件
添加到.gitignore

代码审查：

claude "审查这个PR，重点关注：
1. 安全漏洞
2. SQL注入
3. XSS攻击
4. 认证授权
5. 敏感信息泄露"

八、常见问题

8.1 安装问题

Q: npm install失败
A: 尝试以下方法：

# 清理npm缓存
npm cache clean --force

# 使用cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install -g @anthropic-ai/claude-code

# 使用yarn
yarn global add @anthropic-ai/claude-code

Q: 找不到claude命令
A: 检查npm全局路径：

npm config get prefix
# 将输出路径添加到PATH
export PATH=$PATH:$(npm config get prefix)/bin

8.2 配置问题

Q: API密钥不生效
A: 检查配置文件：

# 查看当前配置
claude config show

# 测试API密钥
claude api test

# 重置配置
claude config reset

Q: MCP服务器无法连接
A: 检查MCP配置：

# 查看MCP服务器状态
claude mcp list

# 测试MCP服务器
claude mcp test <server-name>

# 重启MCP服务器
claude mcp restart <server-name>

8.3 使用问题

Q: Plan Mode不工作
A: 确保任务足够复杂：

# 至少3个步骤才触发Plan Mode
"分析代码、设计架构、实现功能"  ✓

# 单一任务不会触发
"实现一个函数"  ✗

Q: 子代理无法并行
A: 检查任务独立性：

# 独立任务可以并行
"修复这3个bug"  ✓

# 依赖任务必须串行
"先实现A，再实现B"  ✗

Q: 检查点无法恢复
A: 检查检查点ID：

# 列出所有检查点
claude checkpoint list

# 恢复检查点
claude checkpoint restore <checkpoint-id>

8.4 性能问题

Q: 响应速度慢
A: 优化策略：

使用更快的模型（Haiku）
简化提示词
减少上下文
使用缓存

Q: 内存占用高
A: 优化策略：

限制thinking budget
定期重启Claude Code
清理缓存

Q: Token使用过多
A: 优化策略：

监控token使用
设置token预算
优化提示词
使用更便宜的模型

8.5 调试技巧

启用调试模式：

export CLAUDE_DEBUG=true
claude "test"

查看详细日志：

claude --log-level debug "test"

保存对话记录：

claude --save-conversation conversation.json "test"

回放对话：

claude --load-conversation conversation.json

📚 附录

A. 快速参考

常用命令：

# 基本使用
claude "提示词"
claude --plan "提示词"
claude --model opus "提示词"

# 文件操作
claude --read file.txt "分析这个文件"
claude --write output.txt "写入这个文件"

# Git集成
claude --git "提交这些更改"
claude --branch feature/test "创建新分支"

# 插件管理
claude plugin list
claude plugin install <name>
claude plugin enable <name>

# 技能管理
claude skill list
claude skill run <name>

# 检查点
claude checkpoint save
claude checkpoint restore <id>
claude checkpoint list

B. 资源链接

官方文档：

社区资源：

教程和指南：

C. 版本历史

v1.0（2024年初）：初始版本

基本代码生成
简单任务处理

v2.0（2024年中）：重大更新

Plan Mode
子代理
检查点
Hooks

v3.0（2024年末）：插件系统

插件架构
MCP集成
Skills系统
自定义命令

v4.0（2025年当前）：自主代理

30+小时连续编码
多代理协作
浏览器自动化
完整端到端开发

AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

拒绝“脱缰野马”：如何给 AI Agent 立好规矩？

AI Agent技术社区

企业级Agent怎么搭建，腾讯云给出了标准答案

AI Agent技术社区

Android 工程师的 AI 搭档：Android CLI + Skills 实战笔记

AI Agent技术社区

所有评论(0)

查看更多评论

剑laii

@qq2474842866

已为社区贡献3条内容

[特殊字符] Claude Code 完全使用手册（2025版）

剑laii

🤖 Claude Code 完全使用手册（2025版）

📋 目录

一、Claude Code 概述

1.1 什么是Claude Code

1.2 与传统AI编程工具的区别

1.3 能力边界

二、安装与配置

2.1 系统要求

2.2 安装方法

方法1：npm安装（推荐）

方法2：pip安装

方法3：通过Homebrew（macOS）

方法4：手动安装

2.3 配置文件详解

配置文件位置

settings.json 完整配置示例

2.4 环境变量配置

三、核心功能详解

3.1 Plan Mode（规划模式）

3.2 子代理（Sub-Agents）

3.3 TodoWrite（任务追踪）

3.4 检查点（Checkpoints）

3.5 Git集成

四、端到端开发实战

4.1 端到端开发的定义

4.2 完整示例：开发一个博客API

阶段1：需求分析（0-30分钟）

阶段2：项目初始化（30-60分钟）

阶段3：数据库模型（60-120分钟）

阶段4：后端API实现（120-240分钟）

阶段5：测试编写（60-120分钟）

阶段6：部署配置（60-120分钟）

阶段7：文档生成（30-60分钟）

4.3 端到端开发的时间线

4.4 让Claude自主工作的技巧

技巧1：提供充分的上下文

技巧2：明确工作流程

技巧3：使用Plan Mode

技巧4：利用CLAUDE.md

技巧5：提供验证标准

技巧6：设置合理的检查点

技巧7：使用子代理并行

五、高级特性

5.1 MCP（Model Context Protocol）

5.2 Hooks（钩子系统）

5.3 Skills（技能系统）

5.4 自定义命令（Slash Commands）

5.5 浏览器自动化

六、插件系统

6.1 插件架构

6.2 插件开发示例

6.3 插件安装与管理

七、最佳实践

7.1 Boris的9条实战技巧

7.2 提示词工程最佳实践

7.3 项目组织最佳实践

架构说明

Git工作流

重要文件

开发注意事项

测试策略

7.4 成本优化

7.5 安全最佳实践

八、常见问题

8.1 安装问题

8.2 配置问题

8.3 使用问题

8.4 性能问题

8.5 调试技巧

📚 附录

A. 快速参考

B. 资源链接

C. 版本历史

所有评论(0)

温馨提示：您尚未绑定手机号

剑laii