2026年Claude Code常用命令与操作详解

目录

• 文件操作命令
• 读取文件 (Read)
• 编辑文件 (Edit)
• 写入文件 (Write)
• 文件搜索 (Glob)
• 内容搜索 (Grep)
• Bash 命令执行
• 基本用法
• 命令链
• 后台任务
• 路径处理
• 超时控制
• 禁止的命令
• Git 操作
• 创建提交
• 创建 Pull Request
• 其他 Git 操作
• AWS CLI 操作
• 资源查询
• 资源管理
• 最佳实践
• 任务管理
• 高级功能
• 并行操作
• 智能代理 (Task Tool)
• MCP 服务器
• 快捷命令
• 内置命令
• 常用组合

功能：读取文件内容，支持分段读取大文件。

基本用法：

"读取 src/index.js 文件"
"查看 README.md 的内容"
"显示 config/settings.json"

高级用法：

# 读取特定行范围
"读取 src/app.js 的第 100-200 行"

# 同时读取多个文件
"读取 src/auth.js 和 src/api.js 和 src/utils.js"

# 读取图片文件
"查看 screenshots/error.png"

# 读取 PDF 文件
"读取 docs/manual.pdf"

特点：

• 自动显示行号（从 1 开始）
• 支持图片、PDF、Jupyter Notebook
• 超过 2000 行会提示分段读取
• 必须使用绝对路径

最佳实践：

• 修改文件前必须先读取
• 对于大文件，先读取关键部分
• 并行读取多个相关文件以提高效率

功能：通过精确字符串匹配修改文件内容。

基本语法：

修改文件：<file_path>
旧内容：<old_string>
新内容：<new_string>

示例：

# 修改函数实现
"在 src/utils.js 中，将
function add(a, b) {
  return a + b;
}
改为
function add(a, b) {
  return Number(a) + Number(b);
}"

# 修改配置
"在 config.json 中，将 'port': 3000 改为 'port': 8080"

# 批量替换
"在 src/api.js 中，将所有的 'oldApiUrl' 替换为 'newApiUrl'（使用 replace_all）"

重要规则：

1. 必须先读取文件：编辑前必须用 Read 工具读取
2. 精确匹配：old_string 必须与文件内容完全一致
3. 保持缩进：严格保持原有的空格和制表符
4. 唯一性：如果 old_string 不唯一，需要提供更多上下文或使用 replace_all

常见错误：

• 缩进不匹配
• 包含行号前缀
• 字符串不唯一
• 未先读取文件

最佳实践：

• 包含足够的上下文使匹配唯一
• 保持原有的代码风格
• 一次修改一个逻辑单元
• 修改后运行测试验证

功能：创建新文件或完全覆盖现有文件。

基本用法：

"创建一个新文件 src/newModule.js，内容是..."
"写入以下内容到 config/database.yml：..."

示例：

# 创建新的 JavaScript 模块
"创建 src/logger.js 文件：
export class Logger {
  log(message) {
    console.log(`[${new Date().toISOString()}] ${message}`);
  }
}"

# 创建配置文件
"创建 .env.example 文件：
DATABASE_URL=postgresql://localhost:5432/mydb
API_KEY=your_api_key_here
PORT=3000"

# 创建 README
"创建 docs/API.md 文件，包含 API 文档..."

重要规则：

1. 覆盖警告：会完全覆盖现有文件
2. 必须先读取：如果文件已存在，必须先读取
3. 优先编辑：对于现有文件，优先使用 Edit 而非 Write
4. 绝对路径：必须使用绝对路径

最佳实践：

• 仅用于创建新文件
• 对现有文件使用 Edit 进行部分修改
• 不要主动创建文档文件（除非用户明确要求）
• 避免使用 emoji（除非用户要求）

功能：使用模式匹配快速查找文件。

基本语法：

"查找所有 .js 文件"
"搜索 src 目录下的 .tsx 文件"
"找到所有测试文件"

Glob 模式：

**/*.js          # 所有 JS 文件（递归）
src/**/*.ts      # src 下所有 TS 文件
**/*test*.js     # 文件名包含 test 的 JS 文件
*.{js,ts}        # 当前目录的 JS 或 TS 文件
**/components/** # components 目录下的所有文件

示例：

# 查找 React 组件
"查找所有 .tsx 文件"
→ 使用模式：**/*.tsx

# 查找配置文件
"找到所有 config 相关的 JSON 文件"
→ 使用模式：**/*config*.json

# 查找测试文件
"列出所有测试文件"
→ 使用模式：**/*.test.js 或 **/*.spec.js

特点：

• 基于文件名匹配，速度极快
• 按修改时间排序
• 适用于任何规模的代码库
• 支持复杂的模式组合

最佳实践：

• 用于快速定位文件
• 结合 Grep 进行内容搜索
• 并行执行多个搜索模式
• 使用具体的模式减少结果数量

功能：在文件内容中搜索文本，支持正则表达式。

基本语法：

"在代码中搜索 'function calculateTotal'"
"查找所有使用 'useState' 的地方"
"搜索 TODO 注释"

输出模式：

1. files_with_matches（默认）：只显示文件路径
2. content：显示匹配的行内容
3. count：显示每个文件的匹配数量

示例：

# 基本搜索
"搜索 'import React' 在哪些文件中"
→ 模式：import React
→ 输出：文件列表

# 显示内容
"搜索 'TODO' 并显示具体内容"
→ 模式：TODO
→ 输出模式：content
→ 显示行号和匹配行

# 正则表达式
"搜索所有以 'handle' 开头的函数"
→ 模式：function handlew+

# 过滤文件类型
"在 Python 文件中搜索 'class'"
→ 模式：class
→ 类型：py

# 显示上下文
"搜索 'error' 并显示前后 3 行"
→ 模式：error
→ 上下文：-C 3

高级选项：

-i              # 忽略大小写
-A <n>          # 显示匹配后 n 行
-B <n>          # 显示匹配前 n 行
-C <n>          # 显示匹配前后 n 行
glob: "*.js"    # 只搜索 JS 文件
type: "py"      # 只搜索 Python 文件
multiline: true # 跨行匹配

正则表达式示例：

log.*Error              # log 后跟任意字符再跟 Error
functions+w+          # function 关键字后的函数名
bTODOb                # 完整单词 TODO
^import                 # 行首的 import
(get|set)w+            # get 或 set 开头的标识符

最佳实践：

• 先用 files_with_matches 快速定位
• 再用 content 模式查看详情
• 使用文件类型过滤提高效率
• 复杂搜索使用正则表达式
• 对于多轮搜索，考虑使用 Task 工具

功能：在系统中执行终端命令。

示例：

# 查看 Git 状态
"运行 git status"

# 安装依赖
"执行 npm install"

# 运行测试
"运行 pytest tests/"

# 构建项目
"执行 npm run build"

# 查看进程
"运行 ps aux | grep node"

顺序执行（必须成功）：

"运行 git add . && git commit -m 'Update' && git push"

顺序执行（忽略失败）：

"运行 mkdir temp ; cd temp ; ls"

条件执行：

"运行 npm test || echo 'Tests failed'"

长时间运行的命令：

"在后台运行 npm run dev"
"后台启动 python server.py"

监控后台任务：

"查看任务状态"
"获取任务输出"

包含空格的路径：

✅ cd "/Users/name/My Documents"
❌ cd /Users/name/My Documents

最佳实践：

# 使用绝对路径，避免 cd
✅ pytest /foo/bar/tests
❌ cd /foo/bar && pytest tests

# 默认超时：2 分钟
# 最大超时：10 分钟

"运行 npm test（超时 5 分钟）"

❌ 不要使用 find（使用 Glob 工具）
❌ 不要使用 grep（使用 Grep 工具）
❌ 不要使用 cat（使用 Read 工具）
❌ 不要使用 sed/awk（使用 Edit 工具）
❌ 不要使用 echo >（使用 Write 工具）
❌ 不要使用交互式命令（git rebase -i）

标准流程：

"创建一个 Git 提交"

Claude Code 会自动：

1. 运行 git status 查看未跟踪文件
2. 运行 git diff 查看更改
3. 运行 git log 了解提交风格
4. 分析更改并起草提交信息
5. 添加相关文件到暂存区
6. 创建提交
7. 验证提交成功

提交信息格式：

简洁的描述（1-2 句话）

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

安全规则：

• 只在用户明确要求时创建提交
• 不提交包含密钥的文件（.env 等）
• 遵循项目的提交信息风格
• 不修改 git config
• 不执行 force push（除非明确要求）
• 不跳过 hooks（–no-verify）
• 不 amend 已推送的提交

标准流程：

"创建一个 Pull Request"

Claude Code 会自动：

1. 运行 git status 和 git diff
2. 检查远程分支状态
3. 运行 git log 和 git diff [base]...HEAD 查看所有提交
4. 分析所有更改（不只是最新提交）
5. 起草 PR 摘要
6. 推送到远程（如需要）
7. 使用 gh pr create 创建 PR

PR 格式：

## Summary
- 要点 1
- 要点 2
- 要点 3

## Test plan
- [ ] 测试项 1
- [ ] 测试项 2

🤖 Generated with [Claude Code](https://claude.com/claude-code)

# 查看状态
"运行 git status"

# 查看差异
"运行 git diff"

# 查看日志
"运行 git log --oneline -10"

# 创建分支
"创建并切换到新分支 feature/new-feature"

# 查看 PR 评论
"运行 gh api repos/owner/repo/pulls/123/comments"

# 列出 EC2 实例
"运行 aws ec2 describe-instances"

# 查看 S3 存储桶
"运行 aws s3 ls"

# 查看 Lambda 函数
"运行 aws lambda list-functions"

# 查看 RDS 数据库
"运行 aws rds describe-db-instances"

# 创建 S3 存储桶
"运行 aws s3 mb s3://my-bucket"

# 上传文件到 S3
"运行 aws s3 cp file.txt s3://my-bucket/"

# 更新 Lambda 函数
"运行 aws lambda update-function-code --function-name myFunc --zip-file fileb://function.zip"

# 使用 --query 过滤输出
"运行 aws ec2 describe-instances --query 'Reservations[*].Instances[*].[InstanceId,State.Name]'"

# 使用 --output 格式化
"运行 aws s3 ls --output table"

# 使用 --profile 指定配置
"运行 aws s3 ls --profile production"

Todo List

自动创建场景：

• 复杂的多步骤任务（3+ 步骤）
• 用户提供多个任务
• 非平凡的复杂任务

示例：

用户："添加暗黑模式切换功能，并确保测试通过"

Claude Code 创建 Todo：
1. ⏳ 创建暗黑模式切换组件
2. ⏸️ 添加暗黑模式状态管理
3. ⏸️ 实现暗黑主题样式
4. ⏸️ 更新现有组件支持主题切换
5. ⏸️ 运行测试并修复问题

任务状态：

• pending (⏸️)：待开始
• in_progress (⏳)：进行中（同时只能有一个）
• completed (✅)：已完成

最佳实践：

• 实时更新任务状态
• 完成后立即标记
• 遇到阻塞时创建新任务
• 只在完全完成时标记为 completed

同时执行多个独立操作：

"请同时：
1. 读取 src/auth.js 和 src/api.js
2. 搜索所有 TODO 注释
3. 运行 npm test"

用于复杂的多轮任务：

# 探索代码库
"使用 explore 代理查找所有 API 端点的实现"

# 规划实现
"使用 plan 代理设计用户认证功能的实现方案"

# 通用任务
"使用 general-purpose 代理搜索并分析所有性能瓶颈"

添加自定义工具：

kiro-cli config add-mcp-server <server-name> <config>

使用场景：

• 连接数据库
• 调用外部 API
• 集成专有工具
• 扩展 Claude Code 能力

/quit       # 退出应用
/help       # 显示帮助
/clear      # 清除对话历史
/tasks      # 查看后台任务

# 快速开发流程
"读取 src/app.js，修改 handleClick 函数添加错误处理，然后运行测试"

# 调试流程
"搜索所有 console.log，读取相关文件，然后移除调试代码"

# 部署流程
"运行测试，如果通过则构建项目，然后创建提交和 PR"

到此这篇关于2026年Claude Code常用命令与操作详解的文章就介绍到这了,更多相关Claude Code常用命令内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！