Claude Code

关注公众号 jb51net

关闭
AI > Claude Code >

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

jiayong23

文件操作命令

读取文件 (Read)

功能:读取文件内容,支持分段读取大文件。

基本用法

"读取 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"

特点

最佳实践

编辑文件 (Edit)

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

基本语法

修改文件:<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

常见错误

最佳实践

写入文件 (Write)

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

基本用法

"创建一个新文件 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. 绝对路径:必须使用绝对路径

最佳实践

文件搜索 (Glob)

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

基本语法

"查找所有 .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 handle\w+

# 过滤文件类型
"在 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
function\s+\w+          # function 关键字后的函数名
\bTODO\b                # 完整单词 TODO
^import                 # 行首的 import
(get|set)\w+            # get 或 set 开头的标识符

最佳实践

Bash 命令执行

基本用法

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

示例

# 查看 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 操作

创建提交

标准流程

"创建一个 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>

安全规则

创建 Pull Request

标准流程

"创建一个 Pull Request"

Claude Code 会自动

  1. 运行 git statusgit diff
  2. 检查远程分支状态
  3. 运行 git loggit 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 操作

# 查看状态
"运行 git status"

# 查看差异
"运行 git diff"

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

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

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

AWS CLI 操作

资源查询

# 列出 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

自动创建场景

示例

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

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

任务状态

最佳实践

高级功能

并行操作

同时执行多个独立操作

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

智能代理 (Task Tool)

用于复杂的多轮任务

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

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

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

MCP 服务器

添加自定义工具

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

使用场景

快捷命令

内置命令

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

常用组合

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

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

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

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