Claude Code 快速参考卡片

核心工具速查

📁 文件操作

工具	用途	示例指令
Read	读取文件	"读取 src/App.js"
Write	创建新文件	"创建一个新的配置文件"
Edit	修改文件	"将函数名改为 newName"
Glob	查找文件	"找到所有 .tsx 文件"

🔍 搜索工具

工具	用途	示例指令
Grep	搜索内容	"搜索所有 TODO 注释"
Glob	文件名匹配	"找到所有测试文件"

💻 命令执行

工具	用途	示例指令
Bash	执行命令	"运行 npm test"
	Git 操作	"提交当前更改"
	包管理	"安装 axios"

🤖 高级功能

工具	用途	示例指令
Task	启动代理	"探索认证相关代码"
LSP	代码智能	"跳转到定义"
TodoWrite	任务管理	自动创建

常用命令模式

Git 工作流

复制代码

"提交更改" → 自动分析 + 生成提交信息 + 提交
"创建 PR" → 分析分支 + 生成描述 + 创建 PR
"查看状态" → git status
"查看差异" → git diff

代码搜索

复制代码

"搜索函数 X" → Grep 搜索
"找到所有 .js 文件" → Glob 查找
"显示 X 的使用" → Grep + content 模式

代码修改

复制代码

"重命名 X 为 Y" → Grep 查找 + Edit 替换
"添加函数 X" → Read + Edit
"创建新文件 X" → Write

测试和构建

复制代码

"运行测试" → npm test / pytest
"运行 lint" → npm run lint
"构建项目" → npm run build

文件操作模式

Read（读取）

复制代码

✅ 用于：查看文件内容
✅ 何时：修改前、理解代码、调试
❌ 不用于：搜索多个文件（用 Grep）

Write（写入）

复制代码

✅ 用于：创建新文件
❌ 不用于：修改现有文件（用 Edit）
⚠️  注意：会覆盖现有文件

Edit（编辑）

复制代码

✅ 用于：精确修改现有文件
✅ 特点：字符串替换、保持格式
⚠️  注意：old_string 必须唯一
💡 技巧：提供更多上下文确保唯一

Grep 搜索模式

基础搜索

复制代码

搜索文本：pattern="searchTerm"
忽略大小写：-i=true
文件类型：type="js" 或 glob="**/*.js"

输出模式

复制代码

files_with_matches (默认) → 只显示文件名
content → 显示匹配行
count → 显示匹配数���

上下文显示

复制代码

-A=3  → 显示后 3 行
-B=2  → 显示前 2 行
-C=5  → 显示前后各 5 行

正则表达式

复制代码

函数定义：pattern="function\\s+\\w+"
类定义：pattern="class\\s+\\w+"
导入语句：pattern="import.*from"

Bash 命令模式

Git 命令

bash 复制代码

git status              # 查看状态
git diff                # 查看差异
git log --oneline -10   # 查看历史
git branch              # 查看分支
git checkout <branch>   # 切换分支

NPM 命令

bash 复制代码

npm install             # 安装依赖
npm install <package>   # 安装包
npm test                # 运行测试
npm run build           # 构建
npm run dev             # 开发服务器

Python 命令

bash 复制代码

pip install <package>   # 安装包
pytest                  # 运行测试
python script.py        # 运行脚本

系统命令

bash 复制代码

ls -la                  # 列出文件
pwd                     # 当前目录
mkdir <dir>             # 创建目录
rm <file>               # 删除文件

任务复杂度指南

简单任务（直接执行）

单文件修改
简单搜索
运行单个命令
查看文件内容

中等任务（可能需要 TODO）

多文件修改
功能增强
Bug 修复
3-5 个步骤

复杂任务（需要计划模式）

新功能实现
架构变更
大规模重构
多种实现方案

安全检查清单

Git 操作

✅ 提交前检查 git diff
✅ 不提交敏感文件（.env 等）
✅ 遵循项目提交风格
❌ 不强制推送到 main
❌ 不跳过 hooks

文件操作

✅ 修改前先读取
✅ 保持代码风格
✅ 验证重要更改
❌ 不盲目覆盖文件

命令执行

✅ 理解命令作用
✅ 路径有空格要引用
✅ 长命令设置超时
❌ 不执行危险命令

效率提升技巧

1. 并行操作

复制代码

"同时运行测试和检查 git 状态"
→ Claude Code 并行执行

2. 清晰指令

复制代码

好：在 src/App.js 的第 10 行添加 console.log
差：加个日志

3. 提供上下文

复制代码

好：我在实现登录功能，需要保存 token 到 localStorage
差：保存 token

4. 分步骤

复制代码

1. 先搜索相关代码
2. 理解现有实现
3. 再进行修改

5. 利用代理

复制代码

"探索这个大型项目的架构"
→ 启动 Explore 代理系统性分析

常见错误和解决

Edit 失败

复制代码

原因：old_string 不唯一或缩进不匹配
解决：提供更多上下文或使用 replace_all

找不到文件

复制代码

原因：路径错误或文件不存在
解决：使用 Glob 搜索文件

命令超时

复制代码

原因：命令运行时间过长
解决：增加 timeout 或后台运行

Git 冲突

复制代码

原因：本地和远程有冲突
解决：先 pull，解决冲突，再 push

Glob 模式速查

复制代码

**/*.js           # 所有 JS 文件
**/*.{ts,tsx}     # 所有 TS/TSX 文件
src/**/*.test.js  # src 下的测试文件
**/config.*       # 所有 config 文件
**/__tests__/**   # 所有测试目录
components/**/*.jsx  # components 下的 JSX

正则表达式速查

复制代码

function\\s+\\w+        # 函数定义
class\\s+\\w+           # 类定义
import.*from            # import 语句
export\\s+(default|const)  # export 语句
console\\.log           # console.log
TODO:|FIXME:            # 注释标记
\\w+@\\w+\\.\\w+        # 邮箱地址
https?://               # URL

工作流程模板

功能开发流程

复制代码

1. "探索相关代码" → 理解现有实现
2. "创建新分支" → git checkout -b
3. "实现功能" → 编写代码
4. "运行测试" → 验证功能
5. "提交更改" → git commit
6. "创建 PR" → gh pr create

Bug 修复流程

复制代码

1. "搜索错误相关代码" → 定位问题
2. "读取相关文件" → 理解上下文
3. "修复 bug" → 修改代码
4. "运行测试" → 验证修复
5. "提交更改" → git commit

代码重构流程

复制代码

1. "搜索需要重构的代码" → 找到所有位置
2. "分析影响范围" → 评估风险
3. "执行重构" → 修改代码
4. "运行测试" → 确保功能不变
5. "提交更改" → git commit

记住这些原则

先理解，再修改 - 总是先读取和搜索
使用正确的工具 - 文件操作用专用工具，不用 bash
并行提效 - 独立操作同时执行
安全第一 - 重要操作前确认
清晰沟通 - 提供足够的上下文
验证结果 - 修改后运行测试
保持风格 - 遵循项目约定
分步处理 - 复杂任务分解

快速命令参考

需求	指令
查看文件	"读取 <文件路径>"
搜索代码	"搜索 <关键词>"
修改代码	"将 X 改为 Y"
创建文件	"创建 <文件名>"
运行测试	"运行测试"
提交代码	"提交更改"
创建 PR	"创建 Pull Request"
安装包	"安装 <包名>"
查看状态	"git status"
探索代码	"探索 <功能> 相关代码"

获取帮助

复制代码

"如何使用 <功能>？"
"<工具> 的最佳实践是什么？"
"帮我理解这段代码"
"这个错误是什么意思？"

Claude Code 会根据上下文提供帮助和建议！