Skip to content

Claude Code 实用命令

这页整理 Claude Code 日常使用中最常见的命令、输入方式和上下文管理方法。核心原则是:先给足上下文,再让模型分步骤执行。

初始化项目

进入项目目录后,先执行:

text
/init

Claude 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 和数据库迁移。

范围明确后,模型更容易保持改动聚焦。

分批处理

复杂任务不要一次塞满所有要求。推荐拆成:

  1. 复现或定位问题。
  2. 给出改动方案。
  3. 实施最小修复。
  4. 运行相关测试。
  5. 总结风险和回滚方式。

文件夹操作

如果要处理某个新目录,先进入目录再启动:

bash
cd /path/to/project
claude

或者在 Claude Code 里使用:

text
/add-dir

只把必要目录加入上下文,不要把无关大目录、依赖目录或日志目录全部加入。

拖拽文件和粘贴

多数终端支持把文件拖进窗口,自动插入路径。对截图、日志、报错:

  • 能复制文本就复制文本。
  • 长日志只保留关键上下文。
  • 不要一次粘贴超大构建输出。

换行输入

不同终端换行方式不同:

终端常见换行方式
PowerShellAlt + Enter
CMDAlt + Enter
WSL / BashCtrl + Enter 或终端自带多行输入

如果不确定,先用短文本测试。

危险模式

Claude Code 支持跳过权限确认:

bash
claude --dangerously-skip-permissions

只建议在可信仓库、可信机器上使用。生产服务器、含密钥目录、数据库机器不要随便使用危险模式。

深度思考模式

部分版本可以用 Shift + Tab 切换思考模式。复杂任务可以要求:

text
这个问题涉及线上风险,请先详细分析边界条件,再给出最小改动方案。

快捷键建议

  • 需要开始新任务:用 /clear
  • 上下文变大但任务未结束:用 /compact
  • 发现模型开始忘细节:补充关键事实,不要只说“继续”。
  • 做线上操作前:要求模型先列出将执行的命令。

示例任务

text
把当前文件夹里所有不规范的文件名改成英文短横线命名。
要求:
1. 先列出计划改名列表。
2. 不改文件内容。
3. 保留原编号。
4. 确认后再执行。

SuperAPI 文档仅用于帮助用户正确配置客户端。