Claude Code 实用技巧与最佳实践
Claude Code 实用技巧与最佳实践
本指南汇总了 Claude Code 的实用技巧、快捷操作和最佳实践，帮助开发者更高效地使用这个强大的 AI 开发工具。
一、基础操作技巧
1.1 项目初始化
# 自动生成 CLAUDE.md
/init
# 或手动指定
claude /init "这是一个 Node.js + React 项目"
1.2 快速引用上下文
# 引用单个文件
@src/auth.ts
# 引用整个目录
@src/components/
# 引用多个文件
@src/auth.ts @src/user.ts @src/database.ts
# 引用 MCP 服务器
@mcp:github
# 模糊匹配
@auth # 自动匹配 auth.ts, auth.controller.ts 等
1.3 即时执行 Bash 命令
# 查看状态
!git status
# 运行测试
!npm test
# 查看进程
!ps aux | grep node
# 组合使用
!git diff && echo "=== Changes Summary ==="
1.4 回退操作
# 双击 ESC
ESC ESC
选项：
- 仅回退对话
- 仅回退代码
- 同时回退对话和代码
注意： 已执行的 Bash 命令无法回退
二、效率提升技巧
2.1 反向搜索历史提示词
Ctrl+R # 开始搜索
Ctrl+R # 循环匹配项
Enter # 运行
Tab # 编辑后运行
2.2 提示词暂存
Ctrl+S # 暂存当前提示词
# ... 处理其他事务 ...
# 恢复暂存内容继续工作
类似 Git stash，但用于提示词
2.3 智能提示补全
Claude 甚至能预测你接下来想问什么：
# 当你看到灰色的建议文字时
Tab # 接受建议并编辑
Enter # 直接运行建议
价值：
- 减少打字量
- 发现隐藏功能
- 学习最佳实践
三、会话管理高级技巧
3.1 Continue & Resume
# 终端意外关闭？电脑没电了？
claude --continue # 瞬间恢复上一次对话
claude --resume # 显示历史会话列表供选择
# 上下文完美保留，工作流永不丢失
3.2 Named Sessions
# 像管理 Git 分支一样管理会话
/rename api-migration # 给当前会话命名
/resume api-migration # 按名称恢复会话
# 用途：为不同任务创建独立会话
/rename feature-auth
/rename bugfix-login
/resume feature-auth
3.3 Claude Code Remote
# 在网页版 claude.ai/code 上开始任务
# 回家后用终端继续开发
claude --teleport session_id # 把云端会话"拉"到本地
# 利用"传送(Teleport)"功能
# 在终端和网页间同步上下文
# 甚至早上起床和白天休息时，用手机版 Claude App 查看进度
四、自定义状态栏
/statusline
可显示信息：
- Git 分支
- 当前模型
- Token 用量
- 上下文占比
- 任务进度
配置示例
{
"statusline": {
"segments": [
"git.branch",
"model.name",
"context.usage",
"token.cost"
],
"refreshInterval": 1000
}
}
五、可视化上下文
/context
显示：
- 当前 token 使用情况
- 上下文占用百分比
- 各文件占用大小
- 建议优化方向
六、使用统计与监控
6.1 查看使用习惯
/stats # 查看你的使用习惯、最爱用的模型、连续使用天数等
/usage # 查看当前的费率限制和使用进度
6.2 统计内容
| 统计项 | 说明 |
|--------|------|
| 使用频率 | 每天/每周使用时长 |
| 模型偏好 | 最常使用的模型 |
| 任务类型 | 代码编写、调试、文档等 |
| 效率提升 | 相比之前的效率提升 |
价值：
- 了解自己的使用模式
- 监控费用消耗
- 晒 Claude Code 统计（现在比晒 GitHub 提交记录更流行）
七、文件夹管理技巧
7.1 工作空间隔离
最佳实践：
# 为每个任务创建独立文件夹
project-1/
project-2/
task-a/
task-b/
7.2 快速启动
# Windows: 在地址栏输入 cmd
# macOS: 在右键菜单选择"服务 > 新建终端位于文件夹"
# 然后启动 Claude Code
claude
7.3 拖拽文件
支持操作：
- 拖拽单个文件
- 拖拽整个文件夹
- 拖拽多个文件
使用场景：
# 拖拽文件后直接描述任务
[拖入 auth.ts]
这个认证模块有安全问题,请帮我审查并修复
八、粘贴技巧
8.1 文本粘贴
| 操作 | 方式 |
|------|------|
| 在 CC 中粘贴文本 | 鼠标右键 → 粘贴 |
| 在普通命令行粘贴 | Ctrl+V |
| 在 CC 中粘贴图片 | 复制图片 → Alt+V (Windows) / Ctrl+V (macOS) |
8.2 注意事项
- CC 中不能用 Ctrl+V 粘贴文本
- CC 中不能用 Ctrl+A 全选
- 图片必须在打开状态复制，预览状态无法粘贴
九、常用斜杠命令速查
| 命令 | 功能 | 使用频率 |
|------|------|----------|
| /clear | 清空对话历史 | ⭐⭐⭐⭐⭐ |
| /compact | 清空对话但保留摘要 | ⭐⭐⭐⭐⭐ |
| /context | 可视化上下文使用 | ⭐⭐⭐⭐⭐ |
| /model | 切换模型 | ⭐⭐⭐⭐ |
| /cost | 显示费用统计 | ⭐⭐⭐⭐ |
| /export | 导出对话 | ⭐⭐⭐⭐ |
| /add-dir | 添加工作目录 | ⭐⭐⭐⭐ |
| /status | 查看系统状态 | ⭐⭐⭐ |
| /mcp | 管理 MCP 服务器 | ⭐⭐⭐ |
| /skills | 列出可用技能 | ⭐⭐⭐ |
| /hooks | 管理钩子 | ⭐⭐ |
| /agents | 管理子代理 | ⭐⭐ |
| /vim | 切换 Vim 模式 | ⭐⭐ |
| /theme | 更换主题 | ⭐ |
| /doctor | 诊断环境 | ⭐⭐⭐⭐ |
十、最佳实践
10.1 项目组织最佳实践
目录结构规范
project/
├── .claude/ # Claude Code 配置
│ ├── settings.json # 项目级设置
│ ├── agents.json # 子代理配置
│ ├── rules/ # 模块化规则
│ │ ├── auth.md
│ │ ├── database.md
│ │ └── api.md
│ └── mcp.json # MCP 配置
├── src/ # 源代码
├── tests/ # 测试代码
├── docs/ # 文档
├── CLAUDE.md # 项目主配置
└── README.md # 项目说明
CLAUDE.md 层级配置
用户级 ~/.claude/CLAUDE.md
↓
项目级 CLAUDE.md
↓
模块级 src/.claude/CLAUDE.md
↓
特定规则 .claude/rules/*.md
↓
最终合并配置
10.2 工作流最佳实践
探索-规划-编码-提交工作流
前置准备：
# 1. 安装代码分析 MCP（可选）
claude mcp add github npx -y @modelcontextprotocol/server-github
# 2. 安装 commit skill
npx skills-installer install @anthropics/claude-code/commit --client claude-code
# 3. 安装 Chrome DevTools MCP（可选）
claude mcp add chrome-devtools npx chrome-devtools-mcp@latest
详细工作流程：
第 1 步：探索阶段
# 启动 Claude Code
claude
# 探索项目架构
请帮我分析这个项目的架构,重点关注:
1. 整体项目结构
2. 认证模块的实现
3. 依赖关系
4. 技术栈
# 使用@引用特定目录
@src/
# 如果有 GitHub 仓库
请使用 github MCP 查看最近的 commit 历史和 issue
第 2 步：规划阶段
# 进入 Plan 模式
Shift+Tab, Shift+Tab
# 或使用命令
/plan
# 明确任务需求
我需要添加 OAuth2.0 认证支持,请规划实现方案,包括:
1. 需要创建哪些新文件
2. 需要修改哪些现有文件
3. 需要安装哪些依赖
4. 实现步骤顺序
5. 潜在的风险点
# 确认后开始实施
yes
第 3 步：编码阶段
# 让 Claude 按照计划实施
按照上面的计划开始实施
# 运行测试
!npm test
# 修复失败的测试
测试失败了,请帮我修复
第 4 步：提交阶段
# 使用 commit skill
使用 commit skill 为这些更改创建一个规范的 commit 消息
# 或手动指导 commit
请帮我创建 git commit
commit 消息格式: feat(auth): 添加 OAuth2.0 认证支持
10.3 测试驱动开发（TDD）工作流
前置准备：
# 1. 安装测试相关工具
npx skills-installer install @anthropics/claude-code/testing --client claude-code
TDD 工作流：
# 第 1 步：编写测试
使用 testing skill 为用户认证模块编写测试用例
# Claude 会：
# 1. 分析认证模块
# 2. 生成单元测试
# 3. 生成集成测试
# 第 2 步：运行测试（应该失败）
!npm test
# 第 3 步：实现功能
请实现用户认证功能,确保通过所有测试
# 第 4 步：验证测试
!npm test
# 第 5 步：重构代码
使用 code-simplifier agent 优化代码质量
十一、常见问题解决
11.1 性能问题
上下文过大
# 清理上下文
/compact
# 查看上下文使用
/context
# 优化建议
# - 移除不需要的文件引用
# - 分割长对话为多个会话
# - 使用 /compact 保留摘要
响应变慢
# 检查模型负载
/model
# 切换到更快的模型
/model claude-sonnet-4
# 检查网络连接
!ping api.anthropic.com
11.2 配置问题
配置不生效
# 重启 Claude Code
exit
claude
# 检查配置格式
cat ~/.claude/settings.json | jq .
# 查看错误日志
claude /doctor
权限问题
# 检查权限配置
/permissions
# 修改权限
编辑 ~/.claude/settings.json
# 重启生效
exit
claude
11.3 连接问题
API 连接失败
# 检查网络
!curl -I https://api.anthropic.com
# 检查 API Key
echo $ANTHROPIC_AUTH_TOKEN
# 检查 Base URL
echo $ANTHROPIC_BASE_URL
# 测试连接
claude --test-connection
十二、安全最佳实践
12.1 敏感信息处理
# 使用环境变量
export API_KEY="your-api-key"
# 不要在对话中暴露敏感信息
# 如果需要使用，在 Claude Code 外部设置环境变量
# 使用 MCP 时配置认证
{
"mcpServers": {
"github": {
"env": {
"GITHUB_TOKEN": "your-token-here"
}
}
}
}
12.2 权限控制
# 使用 Sandbox 模式
/permissions
# 限制危险操作
{
"permissions": {
"deny": {
"bash": ["rm -rf *", "format *"]
}
}
}
12.3 代码审查
# 重要操作前先审查
# 在执行修改前要求 Claude Code 展示计划
# 使用 Plan 模式确认后再执行
# 敏感操作使用 Hook 拦截
十三、效率提升建议
13.1 自动化重复任务
# 创建 Slash Commands
/claude /commands
# 选择 "Create new command"
# 封装常用操作
# 例如：代码审查、测试运行、文档生成等
13.2 建立项目模板
# 为常见项目类型创建模板
.claude/
├── templates/
│ ├── react-app/
│ │ ├── CLAUDE.md
│ │ └── settings.json
│ ├── node-api/
│ │ ├── CLAUDE.md
│ │ └── settings.json
│ └── python-project/
│ ├── CLAUDE.md
│ └── settings.json
13.3 团队协作
# 共享 CLAUDE.md
git add CLAUDE.md
git commit -m "docs: 更新项目配置"
# 共享常用命令
git add .claude/commands/
git commit -m "feat: 添加团队常用命令"
# 建立使用规范
# - 统一的提交信息格式
# - 统一的代码风格
# - 统一的测试要求
十四、资源与参考
14.1 官方资源
14.2 社区资源
14.3 学习路径
初学者
↓
├── 基础使用（安装、配置、简单任务）
├── 项目配置（CLAUDE.md、规则）
└── 常用功能（MCP、Skills）
进阶
├── 自动化（Hooks、Slash Commands）
├── 高级功能（Subagents、Plan 模式）
└── 团队协作（共享配置、最佳实践）
专家
├── 自定义开发（创建 Skills、Plugins）
├── 深度集成（CI/CD、自动化工作流）
└── 性能优化（上下文管理、资源使用）
十五、总结
通过本指南，你已经了解了：
- ✅ 基础操作技巧和快捷方式
- ✅ 效率提升方法和会话管理
- ✅ 常用斜杠命令速查
- ✅ 项目组织和工作流最佳实践
- ✅ 常见问题解决方案
- ✅ 安全和效率最佳实践
这些技巧和最佳实践将帮助你更高效地使用 Claude Code，提升开发效率和代码质量。
持续学习和探索： Claude Code 是一个快速发展的工具，建议定期查看官方文档和社区资源，了解新功能和最佳实践。