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

文件操作命令
读取文件 (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"
特点:
- 自动显示行号(从 1 开始)
- 支持图片、PDF、Jupyter Notebook
- 超过 2000 行会提示分段读取
- 必须使用绝对路径
最佳实践:
- 修改文件前必须先读取
- 对于大文件,先读取关键部分
- 并行读取多个相关文件以提高效率
编辑文件 (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)"
重要规则:
- 必须先读取文件:编辑前必须用 Read 工具读取
- 精确匹配:
old_string必须与文件内容完全一致 - 保持缩进:严格保持原有的空格和制表符
- 唯一性:如果
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 文档..."
重要规则:
- 覆盖警告:会完全覆盖现有文件
- 必须先读取:如果文件已存在,必须先读取
- 优先编辑:对于现有文件,优先使用 Edit 而非 Write
- 绝对路径:必须使用绝对路径
最佳实践:
- 仅用于创建新文件
- 对现有文件使用 Edit 进行部分修改
- 不要主动创建文档文件(除非用户明确要求)
- 避免使用 emoji(除非用户要求)
文件搜索 (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 进行内容搜索
- 并行执行多个搜索模式
- 使用具体的模式减少结果数量
内容搜索 (Grep)
功能:在文件内容中搜索文本,支持正则表达式。
基本语法:
"在代码中搜索 'function calculateTotal'" "查找所有使用 'useState' 的地方" "搜索 TODO 注释"
输出模式:
- files_with_matches(默认):只显示文件路径
- content:显示匹配的行内容
- 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 开头的标识符
最佳实践:
- 先用 files_with_matches 快速定位
- 再用 content 模式查看详情
- 使用文件类型过滤提高效率
- 复杂搜索使用正则表达式
- 对于多轮搜索,考虑使用 Task 工具
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 会自动:
- 运行
git status查看未跟踪文件 - 运行
git diff查看更改 - 运行
git log了解提交风格 - 分析更改并起草提交信息
- 添加相关文件到暂存区
- 创建提交
- 验证提交成功
提交信息格式:
简洁的描述(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
标准流程:
"创建一个 Pull Request"
Claude Code 会自动:
- 运行
git status和git diff - 检查远程分支状态
- 运行
git log和git diff [base]...HEAD查看所有提交 - 分析所有更改(不只是最新提交)
- 起草 PR 摘要
- 推送到远程(如需要)
- 使用
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
自动创建场景:
- 复杂的多步骤任务(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"
智能代理 (Task Tool)
用于复杂的多轮任务:
# 探索代码库 "使用 explore 代理查找所有 API 端点的实现" # 规划实现 "使用 plan 代理设计用户认证功能的实现方案" # 通用任务 "使用 general-purpose 代理搜索并分析所有性能瓶颈"
MCP 服务器
添加自定义工具:
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常用命令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
相关文章
本文介绍了在Windows上安装并使用ClaudeCode(Anthropic开发的AI编程助手)的步骤,从安装Node.js、Git等依赖开始,到配置API Key、初次运行及常用命令,感兴趣的朋友一起看2026-04-09
本文介绍了三种在国内稳定使用ClaudeCode的方法:包括使用API中转、替换国产大模型和本地部署三种方案,,分析了每种方案的优缺点,并提供了详细配置指南,帮助开发者根据需2026-04-10
2026最新Claude Code的安装并连接VScode的保姆级教程(使用CC Switch或o
本文详细介绍了使用ClaudeCode和CCSwitch在本地部署Claude,并连接深Seek、智谱AI、Ollama等模型的过程,最后说明了在VScode中使用Claude的方法,本文结合图文、示例代码给大2026-04-10
Claude Code完整安装使用教程(含国内模型接入方案)
文章介绍了AI编程助手ClaudeCode的安装、使用和配置方法,包括安装步骤、接入国内编程模型、简单使用案例及注意事项等内容,需要的朋友可以参考下2026-04-09
Claude Code 国内合规使用教程(2026年最新分享)
ClaudeCode是Anthropic官方的终端AI编程助手,本文详细介绍了安装准备、获取API令牌、配置环境变量、启动ClaudeCode等步骤,并提供了国内网络环境的使用方案与常见问题排查,2026-04-09







最新评论