Claude Code 命令大全——每个命令怎么用、什么时候用

上一篇讲了怎么装 Claude Code、怎么绕过登录、怎么换模型。这篇讲怎么用——每个命令、每个参数、什么场景下用哪个。

基本概念

Claude Code 有两种模式：

交互模式：在终端里直接敲 claude，进入一个对话界面，像聊天一样跟它交互。适合探索性的任务——不确定要改什么，先聊聊。

非交互模式：用 -p 参数一句话丢给它，跑完就退出。适合明确的任务——“帮我把这个函数重构了”。

# 交互模式
claude

# 非交互模式 —— 一句话任务
claude -p "解释这个项目是干什么的"

日常干活我大部分时间用交互模式。非交互模式适合写脚本、CI/CD 里跑，或者你很清楚要什么不需要来回聊。

核心命令（交互模式下）

进交互模式后，你可以用自然语言说话，但它也有一套前缀命令，打 / 就能看到。

`/help` —— 看帮助

进去之后第一件事。会列出所有可用命令和当前版本信息。

`/clear` —— 清空对话

聊了一大轮，上下文快满了，或者话题完全换了，清一下。不清的话模型会带着之前的对话继续聊，浪费 token 也容易跑偏。

`/cost` —— 看花了多少钱

显示当前会话的 token 消耗和费用。经常看看，心里有数。用 Opus 的时候尤其要看，别月底收到账单才后悔。

`/compact` —— 压缩上下文

Claude Code 会自动在上下文快满的时候提示你压缩。这个命令是手动触发。压缩会把之前的对话总结成摘要，释放空间继续聊。大的重构任务中间常用。

`/add-dir` —— 加一个目录进来

默认 Claude Code 只看当前工作目录。如果你项目引用了外面的库或者有多个目录，用这个加进来。比如：

/add-dir ../shared-lib

`/ide` —— 在 IDE 里打开

如果你同时开着 VS Code 或者 JetBrains，这个命令可以让 Claude Code 操作 IDE 里的文件，而不是直接在终端改。适合习惯 IDE 看代码的人。

`/status` —— 看当前状态

显示当前会话信息：模型、项目路径、token 用量。

`/config` —— 改配置

进配置界面，可以改模型选择、主题、权限等。

`/memory` —— 管理记忆

Claude Code 有持久记忆功能，可以在项目级或用户级保存信息。比如你可以告诉它”这个项目用 TypeScript 严格模式”，它会记住，下次打开自动知道。

上面这些是系统命令。下面说实际干活时怎么用。

使用场景

场景一：理解一个陌生项目

刚接手一个新项目，或者看一个开源库的源码，完全不知道从哪看起。

操作：

cd 项目目录
claude

进去之后直接问：

帮我梳理一下这个项目的结构，主要模块是干什么的，入口在哪里

Claude Code 会自动读 package.json、目录结构、入口文件，然后给你一个清晰的架构图。

比你自己一个个文件翻快十倍。

场景二：修 bug

比如线上报了一个 bug，你知道大概在哪个文件但不确定具体原因。

用户登录之后偶尔会 500，帮我看下 auth.ts 里的逻辑，找到可能的原因

Claude Code 会读文件、分析逻辑、找到可疑路径，然后直接帮你改。改完你 review 一下 diff，没问题就提交。

关键是它会自己跑测试（如果有的话），确认修改没有破坏其他东西。

场景三：加新功能

比如要给博客加个搜索功能。

帮我给这个 Astro 博客加一个客户端搜索，用 fuse.js，搜索框放在导航栏

Claude Code 会：

读项目结构，搞清楚路由和组件
装 fuse.js
写搜索组件
改导航栏加上搜索框
告诉你改了什么、为什么这么改

你只需要说”行”还是”不行”。不行它继续改。

场景四：重构

一个函数写了三百行，你自己都不想看。

把 userService.ts 里的 handleLogin 函数拆成几个小函数，每个函数不超过 30 行

Claude Code 读完代码，做拆分，提取子函数，处理好类型和引用，保证重构后逻辑一模一样。

这是我觉得最实用的场景。重构这种体力活，人做容易出错还烦，AI 做又稳又快。

场景五：写测试

给 src/utils/format.ts 里的函数写单元测试，用 vitest

它会读源文件，理解每个函数的输入输出和边界条件，然后生成完整的测试文件。

场景六：代码审查

review 一下 src/pages/api/ 里所有文件的代码，找出安全问题、性能问题和逻辑错误

它会逐个文件读，给出审查意见，严重程度分级，附带修改建议。

场景七：写文档

给这个项目写一份 README，包含安装步骤、项目结构说明、部署方式

Claude Code 会基于实际项目内容写文档，不会瞎编。

非交互模式的常用参数

非交互模式的核心参数是 -p（prompt），还有一些配套参数：

# 基础用法
claude -p "把这个文件里的 console.log 全删了"

# 指定用哪个模型
claude -p "解释这段代码" --model claude-sonnet-4-6

# 允许自动执行命令（CI/CD 里用）
claude -p "跑测试并修复失败的用例" --allowedTools "Bash,Read,Edit"

# 输出为 JSON 格式
claude -p "列出所有导出的函数" --output-format json

# 用系统提示词
claude -p "..." --system-prompt "你是一个严格的代码审查员"

常用参数速查

参数	作用
`-p`	直接给 prompt，跑完退出
`--model`	指定模型
`--allowedTools`	限制可用的工具
`--output-format`	输出格式（text/json/stream-json）
`--system-prompt`	自定义系统提示词
`--max-turns`	最大对话轮数
`--verbose`	显示详细日志

配置文件

Claude Code 的配置存在 ~/.claude/settings.json（用户级）和项目根目录的 .claude/settings.json（项目级）。

几个常用的配置项：

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run *)",
      "Bash(ls *)",
      "Bash(git diff *)",
      "Bash(git log *)"
    ]
  }
}

把常用命令加进 allow 白名单，Claude Code 跑这些命令时不会再问你确认，省时间。

还有 CLAUDE.md 文件——放在项目根目录，或者 ~/.claude/CLAUDE.md。Claude Code 启动时会自动读这个文件，把它当作项目说明。通常放项目结构、技术栈、编码规范这些信息，让它一开始就知道上下文。

配合外部工具

用管道传内容

# 把报错日志丢给 Claude Code 分析
cat error.log | claude -p "分析这些报错，给出修复方案"

# 把 git diff 丢给它写 commit message
git diff HEAD~1 | claude -p "给这个改动写一条英文 commit message"

在脚本里用

#!/bin/bash
# 自动生成 changelog
git log --oneline v1.0..HEAD | claude -p "根据这些 commit 写一份 changelog，中文，按功能分组"

几点经验

明确比模糊好。 “帮我看下这个项目”不如”帮我找一下这个项目里处理用户登录的代码在哪几个文件”。

先让它读再让它改。 不确定的时候先让 Claude Code 分析、解释，确认理解对了再让它动手。不要一上来就说”帮我改了”。

小步快跑。 一个大的改动拆成多个小步骤，每步确认一下。一次让它改全站的路由，大概率会漏或者改错。

善用记忆。 /memory 把你项目的规则存进去——“别用 any 类型""组件用函数式写法”——之后每次对话它都会遵守。

看 /cost。 养成习惯。Opus 跑一个小时可能吃掉几十块钱。日常用 DeepSeek 接 CC Switch，大活才切 Claude 原版。

命令这东西，看一遍记不住。收藏这篇，用的时候回来查。有问题评论区聊。