Claude Code 实用命令
Base URL
https://superapi.buzz这页整理 Claude Code 日常使用中最常见的命令、输入方式和上下文管理方法。核心原则是:先给足上下文,再让模型分步骤执行。
初始化项目
进入项目目录后,先执行:
text
/initClaude Code 会根据当前项目生成 CLAUDE.md。建议让它记录:
- 项目目标和主要目录。
- 构建、测试、启动命令。
- 代码风格和禁止事项。
- 部署、数据库、外部服务等注意点。
如果项目已有类似文档,可以让 Claude Code 先阅读再补充,不要重复生成互相冲突的说明。
用 @ 提供上下文
当问题和具体文件有关,直接引用路径:
text
请检查 @src/api/auth.ts 和 @src/components/Login.vue,找出登录失败原因。也可以引用目录:
text
请只阅读 @src/server/ 下面和支付回调相关的文件,先总结调用链,不要改代码。这样比让模型全局猜更稳定,也能减少无关 token 消耗。
用 ! 运行 Bash 命令
在 Claude Code 交互里可以让它运行命令,例如:
text
!git status常用检查命令:
bash
git status
npm test
npm run build
rg "关键字" .权限提醒
让模型运行命令前,确认当前目录可信。涉及删除、重启、数据库写入、部署的命令要格外谨慎。
清理和压缩上下文
长会话会让上下文变大,模型可能开始遗漏细节。常用命令:
text
/clear清空当前上下文,适合开始全新任务。
text
/compact压缩已有上下文,适合长任务中途保留摘要继续做。
text
/context查看当前上下文使用情况。
常用斜杠命令
| 命令 | 用途 |
|---|---|
/help | 查看帮助和可用命令 |
/init | 初始化项目说明文件 |
/clear | 清空上下文,开启新任务 |
/compact | 压缩上下文并继续当前任务 |
/context | 查看上下文使用情况 |
/model | 切换模型 |
/status | 查看账户、模型、版本和连接状态 |
/doctor | 诊断本地 Claude Code 安装 |
/cost | 查看当前会话费用和时长 |
/export | 导出当前会话,便于复盘 |
/add-dir | 添加新的工作目录 |
/mcp | 管理 MCP 服务 |
/permissions | 管理工具访问权限 |
/review | 审查当前分支或 PR |
不同版本的 Claude Code 命令可能略有差异,以 /help 显示为准。
基本交互方式
先分析再修改
推荐这样提需求:
text
先分析原因,不要修改代码。确认方案后,只改最小范围,并说明需要验证的命令。这样可以避免模型直接大范围改动。
限定范围
text
只允许修改 src/api 目录,不要改 UI 和数据库迁移。范围明确后,模型更容易保持改动聚焦。
分批处理
复杂任务不要一次塞满所有要求。推荐拆成:
- 复现或定位问题。
- 给出改动方案。
- 实施最小修复。
- 运行相关测试。
- 总结风险和回滚方式。
文件夹操作
如果要处理某个新目录,先进入目录再启动:
bash
cd /path/to/project
claude或者在 Claude Code 里使用:
text
/add-dir只把必要目录加入上下文,不要把无关大目录、依赖目录或日志目录全部加入。
拖拽文件和粘贴
多数终端支持把文件拖进窗口,自动插入路径。对截图、日志、报错:
- 能复制文本就复制文本。
- 长日志只保留关键上下文。
- 不要一次粘贴超大构建输出。
换行输入
不同终端换行方式不同:
| 终端 | 常见换行方式 |
|---|---|
| PowerShell | Alt + Enter |
| CMD | Alt + Enter |
| WSL / Bash | Ctrl + Enter 或终端自带多行输入 |
如果不确定,先用短文本测试。
危险模式
Claude Code 支持跳过权限确认:
bash
claude --dangerously-skip-permissions只建议在可信仓库、可信机器上使用。生产服务器、含密钥目录、数据库机器不要随便使用危险模式。
深度思考模式
部分版本可以用 Shift + Tab 切换思考模式。复杂任务可以要求:
text
这个问题涉及线上风险,请先详细分析边界条件,再给出最小改动方案。快捷键建议
- 需要开始新任务:用
/clear。 - 上下文变大但任务未结束:用
/compact。 - 发现模型开始忘细节:补充关键事实,不要只说“继续”。
- 做线上操作前:要求模型先列出将执行的命令。
示例任务
text
把当前文件夹里所有不规范的文件名改成英文短横线命名。
要求:
1. 先列出计划改名列表。
2. 不改文件内容。
3. 保留原编号。
4. 确认后再执行。