Claude Code 完全使用指南
本文档详细介绍 Claude Code 的所有指令、工具及使用场景，帮助开发者提升工作效率。
目录
Claude Code 简介
什么是 Claude Code
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，基于 Claude 大语言模型，专门为开发者设计。
核心价值
| 价值 | 说明 |
|---|---|
| 代码理解 | 深度理解项目结构、代码逻辑和架构设计 |
| 自动化任务 | 执行代码生成、重构、测试、调试等任务 |
| 知识复用 | 通过技能系统固化最佳实践 |
| 效率提升 | 减少重复劳动，专注于核心逻辑 |
适用场景
- 代码审查与重构
- 新功能开发
- Bug 定位与修复
- 技术文档编写
- 学习与知识探索
- 技术方案设计
安装与配置
系统要求
- 操作系统: Windows 10/11, macOS 10.15+, Linux
- Node.js: v18 或更高版本
- npm: v9 或更高版本
安装步骤
# 全局安装
npm install -g @anthropic-ai/claude-code
# 或使用 npx 直接运行
npx @anthropic-ai/claude-code
认证配置
# 首次运行会自动引导认证
claude
# 或手动配置 API Key
export ANTHROPIC_API_KEY='your-api-key'
配置文件
用户级配置位于：
- Windows: ~/.claude.json
- macOS/Linux: ~/.claude.json
{
"theme": "dark",
"fontSize": 14,
"autoSave": true,
"model": "claude-opus-4-6"
}
基础指令
对话指令
| 指令 | 作用 | 使用场景 |
|---|---|---|
/help |
显示帮助信息 | 查看可用命令 |
/clear |
清除当前对话历史 | 开始新话题 |
/exit |
退出 Claude Code | 结束会话 |
Slash 命令详解
/help - 获取帮助
/help # 显示所有可用命令
/help <command> # 显示特定命令的帮助
/clear - 清除上下文
/clear # 清除对话历史，释放上下文空间
使用场景：
- 切换话题时
- 上下文过长时
- 需要重新开始对话时
/exit - 退出程序
/exit # 或 Ctrl+C 退出
核心工具
Claude Code 提供以下核心工具来完成编程任务：
1. Read - 读取文件
作用：读取文件内容，支持大文件分块读取。
# 自动调用场景
- 用户请求读取特定文件
- 需要理解现有代码结构
使用示例：
用户：帮我看看 MainActivity.kt 的实现
Claude: [使用 Read 工具读取文件]
2. Edit - 编辑文件
作用：对现有文件进行精确修改。
使用场景：
- 修复 Bug
- 添加小功能
- 重构代码
编辑策略：
- 最小改动原则
- 保持原有风格
- 精确字符串匹配
3. Write - 创建文件
作用：创建新文件或完全覆盖现有文件。
使用场景：
- 创建新类/组件
- 编写文档
- 生成配置文件
4. Bash - 执行命令
作用：在终端执行系统命令。
可用命令：
# 文件操作
ls, cat, cp, mv, rm, mkdir
# Git 操作
git status, git diff, git add, git commit
# 构建命令
npm install, ./gradlew build, cargo build
# 测试命令
npm test, pytest, go test
安全限制：
- 危险命令需要用户确认
- 不支持交互式命令
- 网络请求需要授权
5. Glob - 文件搜索
作用：根据模式匹配查找文件。
使用场景：
# 查找特定类型文件
**/*.kt # 所有 Kotlin 文件
src/**/*.java # src 目录下所有 Java 文件
**/test* # 所有测试文件
6. Grep - 内容搜索
作用：在文件内容中搜索关键词。
使用场景：
- 查找特定函数/类的引用
- 搜索代码模式
- 定位问题代码
搜索示例：
搜索模式：function.*login
文件类型：*.kt
结果：显示所有包含 login 函数的 Kotlin 文件
7. Agent - 创建子代理
作用：启动专门的子代理处理复杂任务。
子代理类型：
| 类型 | 用途 |
|---|---|
general-purpose |
通用任务，复杂多步骤工作 |
Explore |
代码库探索，快速查找文件和代码 |
Plan |
架构设计，制定实现计划 |
使用场景：
- 大型代码库搜索
- 复杂功能实现
- 需要并行处理的任务
高级功能
1. 计划模式 (Plan Mode)
作用：在实施前制定详细的实现计划。
启用方式：
用户：帮我设计一个用户认证系统
Claude: [进入计划模式，输出详细方案]
计划模式输出：
1. 需求分析
2. 技术方案设计
3. 文件修改清单
4. 实施步骤
5. 风险评估
2. 后台任务 (Background Tasks)
作用：在后台运行长时间任务。
# 启动后台任务
/task run <command>
# 查看任务状态
/task list
# 获取任务输出
/task output <task-id>
# 停止任务
/task stop <task-id>
使用场景：
- 长时间编译
- 测试套件运行
- 文件批量处理
3. 定时任务 (Cron)
作用：定时执行提示词或命令。
# 创建定时任务
/cron create "0 9 * * *" "检查是否有未提交的代码"
# 查看定时任务
/cron list
# 删除定时任务
/cron delete <job-id>
Cron 表达式示例：
*/5 * * * * # 每 5 分钟
0 9 * * * # 每天早上 9 点
0 9 * * 1-5 # 工作日早上 9 点
30 14 1 * * # 每月 1 号下午 2:30
4. 工作区隔离 (Worktree)
作用：创建隔离的 Git 工作区进行实验性开发。
# 创建工作区
/worktree create <name>
# 切换工作区
/worktree use <name>
# 退出工作区
/worktree exit
使用场景：
- 功能分支开发
- 实验性修改
- 并行开发多个特性
技能系统
什么是技能
技能（Skills）是 Claude Code 的扩展机制，允许定义可复用的专业能力和工作流程。
技能结构
---
name: skill-name
description: 技能描述
tools: [Read, Edit, Write, Bash]
version: "1.0"
---
# 技能标题
## 角色定义
...
## 工作流程
...
## 输出格式
...
技能存储位置
| 位置 | 路径 | 特点 |
|---|---|---|
| 项目级 | .claude/skills/ |
团队共享，版本控制 |
| 用户级 | ~/.claude/skills/ |
个人全局使用 |
技能调用方式
1. 显式调用
/skill <skill-name>
# 示例
/skill android-engineer
/skill review-code
2. 自然语言触发
用户：请以 Android 工程师的身份帮我设计...
用户：帮我审查这段代码...
3. 自动检测
Claude Code 根据对话内容自动识别并建议使用相关技能。
内置技能示例
Android 工程师技能
---
name: android-engineer
description: Android 全栈工程师
tools: [Read, Edit, Write, Bash]
---
## 技术栈
- Kotlin, Java
- Jetpack, RxJava
- JT808, 北斗三号协议
## 工作流程
1. 需求分析
2. 方案设计
3. 代码实现
4. 文档输出
代码审查技能
---
name: review-code
description: 代码审查
tools: [Read, Grep]
---
## 审查清单
1. 内存安全
2. 生命周期管理
3. 线程安全
4. 代码规范
5. 性能优化
Agent Teams
什么是 Agent Teams
Agent Teams 允许配置多个专业化 Agent，模拟真实团队的协作模式。
团队配置
配置文件：~/.claude/teams/<team-name>/config.json
{
"teamId": "my-project",
"name": "My Project Team",
"members": [
{
"agentId": "product-manager@myproject",
"name": "product-manager",
"agentType": "general-purpose",
"model": "claude-opus-4-6",
"prompt": "产品总监角色设定...",
"color": "blue"
},
{
"agentId": "fullstack-engineer@myproject",
"name": "fullstack-engineer",
"agentType": "general-purpose",
"model": "claude-opus-4-6",
"prompt": "全栈工程师角色设定...",
"color": "green"
},
{
"agentId": "qa-engineer@myproject",
"name": "qa-engineer",
"agentType": "general-purpose",
"model": "claude-opus-4-6",
"prompt": "测试工程师角色设定...",
"color": "red"
}
]
}
典型团队角色
产品经理 (Product Manager)
## 职责
- 需求分析
- 竞品分析
- PRD 文档撰写
- 产品规划
## 输出
docs/product/ 目录
全栈工程师 (Fullstack Engineer)
## 职责
- 架构设计
- 代码实现
- 技术选型
- 性能优化
## 原则
- 约定优于配置
- 宏伟的单体
- 程序员幸福感
UI/UX 设计师 (Designer)
## 职责
- 视觉设计
- 用户流程
- 原型设计
- 可用性测试
测试工程师 (QA Engineer)
## 职责
- 测试用例设计
- 自动化测试
- 性能测试
- 安全测试
团队协作流程
1. 产品经理 → 定义需求和功能
2. 设计师 → 设计界面和交互
3. 工程师 → 实现功能
4. 测试工程师 → 保证质量
最佳实践
1. 提示词技巧
明确具体
❌ "帮我写代码"
✅ "帮我写一个 Kotlin 函数，实现 Ymodem 协议的 CRC 校验"
提供上下文
❌ "这个有问题"
✅ "这个 RecyclerView 在快速滚动时卡顿，可能是 ViewHolder 复用问题"
分步请求
1. "先帮我分析需求"
2. "再给出技术方案"
3. "最后实现代码"
2. 上下文管理
- 定期使用
/clear清理上下文 - 重要信息主动重复
- 长任务分解为多个对话
3. 工具使用策略
| 任务类型 | 推荐工具 |
|---|---|
| 理解代码 | Read + Grep |
| 代码搜索 | Glob + Agent(Explore) |
| 文件修改 | Edit (小改动) / Write (大改动) |
| 复杂任务 | Agent(Plan) + Agent(general-purpose) |
| 验证结果 | Bash (运行测试) |
4. 代码审查流程
1. /skill review-code
2. 提供代码文件或路径
3. 审查输出：严重问题 → 改进建议 → 优点
4. 逐项修复
5. 再次审查验证
5. 文档编写
- 技术方案保存到固定目录
- 使用统一的命名规范
- 包含代码示例和注意事项
- 记录踩坑经验
常见问题
安装问题
Q: 安装失败，提示权限错误
# 解决方案
sudo npm install -g @anthropic-ai/claude-code
# 或使用 npx
npx @anthropic-ai/claude-code
Q: 认证失败
# 检查 API Key
export ANTHROPIC_API_KEY='sk-ant-...'
# 重新认证
claude --auth
使用问题
Q: 命令执行失败
原因：
- 沙盒限制
- 权限不足
- 路径错误
解决：
- 确认命令安全性
- 使用绝对路径
- 检查工作目录
Q: 响应过慢
原因：
- 上下文过长
- 任务复杂
- 网络问题
解决：
- 使用 /clear 清理上下文
- 分解复杂任务
- 使用后台任务
Q: 技能未生效
排查：
1. 检查技能文件名和格式
2. 确认位于 .claude/skills/ 目录
3. 验证 frontmatter 格式
4. 重启 Claude Code
代码问题
Q: 生成的代码无法运行
解决：
1. 提供完整错误信息
2. 说明运行环境
3. 提供相关代码上下文
Q: 代码风格不一致
解决：
1. 在项目中配置 .editorconfig
2. 在提示词中说明代码规范
3. 使用 CLAUDE.md 定义项目约定
参考资源
官方文档
本项目文档
社区资源
文档版本: 1.0
更新日期: 2026-03-11
适用版本: Claude Code 2.1.72+
当前文章价值8.42元，扫一扫支付后添加微信提供帮助！（如不能解决您的问题，可以申请退款）
评论已关闭！