Claude Code CLI 常用指令完全指南：提高 AI 编码效率的必备手册

你是否有过这样的经历：在终端里对着 AI 助手反复描述同样的项目规范，或者在每次对话开始时手动配置相同的偏好？

Claude Code CLI 提供了一套丰富的指令系统和配置机制，让你一次配置、持续受益。本文将系统梳理常用的 CLI 指令、Slash 命令和实用配置技巧。

一、什么是 Claude Code CLI？

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，它会主动探索和理解你的代码仓库，在终端中提供实时的代码编写、调试、重构和问题解答能力。它不仅仅是一个聊天机器人——它能读取文件、搜索代码、执行命令、创建和管理 Git 提交，甚至自动修复 lint 错误。

二、CLI 启动指令

2.1 基本启动

1
2
3
4
5
6
7
8
9
10
11
# 启动交互式会话
claude

# 在特定目录下启动
claude /path/to/project

# 直接传入问题（单次问答模式）
claude -p "这段代码的时间复杂度是多少？"

# 从 stdin 传入内容
cat error.log | claude -p "分析这个错误日志"

2.2 常用启动参数

参数 说明 示例
-p, --prompt 传入问题文本，非交互模式 claude -p "解释 SELECT 语句"
-m, --model 指定使用的模型 claude -m sonnet
-f, --file 从文件读取问题 claude -f prompt.md
--output-format 输出格式：text、json、stream-json claude -p "..." --output-format json
--max-turns 最大对话轮次 claude --max-turns 10
--continue 继续上次对话 claude --continue
--resume 恢复指定会话 claude --resume <session-id>
--verbose 详细输出模式 claude --verbose
--debug 调试模式 claude --debug 
1
2
3
4
5
# 指定模型处理复杂问题
claude -m opus -p "重构这个模块，将其拆分为职责单一的函数"

# 批量处理——将输出格式设为 JSON 便于脚本解析
claude -p "列出所有 TODO" --output-format json | jq '.result'

2.3 Session 管理

1
2
3
4
5
6
7
8
# 列出所有历史会话
claude session list

# 恢复某个会话
claude --resume <session-id>

# 删除指定会话
claude session delete <session-id>

三、Slash 命令（交互式指令）

在交互式会话中，你可以输入以 / 开头的命令来执行特定操作。这些是最高频使用的指令：

3.1 会话控制

命令 说明
/help 显示帮助信息
/clear 清除当前对话上下文
/compact 压缩上下文，释放 token 配额（保留摘要和关键信息）
/cost 查看当前会话的 token 使用量和费用
/stats 查看会话统计数据 
1
2
3
> /cost
Token usage: 12,345 input | 2,345 output
Estimated cost: $0.21

3.2 模式与行为

命令 说明
/config 打开配置面板，修改主题、模型、权限等设置
/model 切换当前使用的模型（如 opus/sonnet/haiku）
/fast 切换快速模式（仅在 Opus 4.6 上可用）
/ide 显示 IDE 集成状态或配置信息
/status 显示当前会话状态 
1
2
3
4
5
6
> /model
Available models:
  - claude-opus-4-7   (recommended for complex reasoning)
  - claude-sonnet-4-6 (balanced speed and quality)
  - claude-haiku-4-5  (fastest, for simple tasks)
Current: claude-sonnet-4-6

3.3 代码工作流

命令 说明
/init 为当前项目生成 CLAUDE.md 文档
/review 对当前分支进行代码审查
/security-review 对当前分支进行安全审查
/simplify 检查代码变更的可复用性、质量和效率，并修复问题 
1
2
3
4
5
6
7
# 在一个 PR 分支上运行审查
> /review
┌─────────────────────────────────────────┐
│ Reviewing changes on feature/user-auth... │
│ 3 files changed, 0 issues found           │
│ ✅ Safe to merge                          │
└─────────────────────────────────────────┘

3.4 自动化与循环

命令 说明
/loop 按指定间隔重复运行某个命令，用于轮询或持续检查
/babysit-prs 监控 PR 状态变化（需配合 /loop 使用） 
1
2
3
4
5
# 每 5 分钟检查一次部署状态
> /loop 5m /status

# 停止循环任务
> /loop

3.5 内容创作

命令 说明
/blog-post 撰写博客文章
/update-config 修改 settings.json 配置（权限、hooks、环境变量等）

3.6 权限与安全

1
2
3
4
5
6
# 允许当前项目的所有 bash 命令
> /update-config
# 然后在配置面板中设置 permissions

# 降低安全控制的频次
> /permissions

四、配置系统：一次配置，长期受益

4.1 CLAUDE.md —— 项目级配置

/init 命令会在项目根目录创建一个 CLAUDE.md 文件，用于记录项目规范：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# CLAUDE.md

## Build Commands
- Build: `make build`
- Test: `go test ./...`
- Lint: `golangci-lint run`

## Code Style
- Use Go standard formatting (gofmt)
- Error messages should be lowercase, no trailing punctuation
- Prefer explicit error handling over panic

## Project Conventions
- Database migrations live in `migrations/` directory
- API handlers are in `handlers/` package
- Always write tests for new handlers

Claude Code 在每次对话时会自动读取这些信息，你就无需反复说明项目规范。

4.2 settings.json —— 全局与项目配置

配置按优先级分三级：

  1. 用户级：~/.claude/settings.json —— 适用于所有项目
  2. 项目级：.claude/settings.json —— 当前项目专用
  3. 本地项目级：.claude/settings.local.json —— 本地覆盖，不入 git
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "model": "sonnet",
  "theme": "dark",
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(go test ./...)"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  },
  "env": {
    "DEBUG": "true",
    "NODE_ENV": "development"
  }
}

4.3 Hooks —— 自动化钩子

在 settings.json 中配置 hooks，让 Claude Code 在特定时机自动执行脚本：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [{
          "type": "command",
          "command": "gofmt -w $CLAUDE_TOOL_FILE_PATH"
        }]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{
          "type": "command",
          "command": "echo 'About to run: $CLAUDE_TOOL_INPUT'"
        }]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [{
          "type": "command",
          "command": "notify-send 'Claude Code' 'Task completed'"
        }]
      }
    ]
  }
}

可用的 Hook 事件：

事件 触发时机
PreToolUse 使用任何工具之前
PostToolUse 工具使用完成后
Notification Claude Code 生成通知时
UserPromptSubmit 用户提交 prompt 时

五、记忆系统：让 Claude 记住你的偏好

Claude Code 有一个持久化的记忆系统，存储在 ~/.claude/projects/ 下。可以通过对话自然语言来管理：

1
2
3
4
5
6
# 自动保存记忆
> "记住，我偏好使用 table-driven tests"
Claude Code 会保存这条偏好，后续对话中自动应用。

# 查看记忆
claude memory list

记忆类型分为四类：

  • 用户记忆：你的角色、偏好、知识背景
  • 反馈记忆：你纠正过的行为模式
  • 项目记忆：项目背景、目标、决策
  • 引用记忆：外部系统的位置（如看板、监控面板）

六、IDE 集成

Claude Code 支持主流 IDE 的插件集成：

1
2
3
4
5
# 安装 VS Code 插件
code --install-extension anthropic.claude-code

# 安装 JetBrains 插件
# 在 Plugin Marketplace 搜索 "Claude Code"

在 IDE 中使用时，Claude Code 可以直接读取当前打开的文件和光标位置，提供更精准的上下文感知。

七、实用技巧与最佳实践

7.1 批量文件分析

1
2
# 对多个文件提问
claude -p "这些文件中哪些函数没有单元测试？" -f src/

7.2 Git 工作流集成

1
2
> 检查我在 feature/payment 分支上的所有变更，写一个清晰的 commit message，
> 按逻辑拆分为多个 commit

Claude Code 会分析 diff，提出拆分建议，甚至帮你生成 commit message。

7.3 错误诊断

1
2
# 管道传入编译错误
go build ./... 2>&1 | claude -p "分析这些编译错误并逐个给出修复建议"

7.4 快速模式切换

1
2
3
> /fast          # 快速模式（更快响应）
> /model opus    # 切换到最强模型处理复杂问题
> /model haiku   # 切换回轻量模型做简单修改

7.5 使用 ! 前缀运行交互式命令

有些命令需要交互（如 gcloud auth login），可以在对话中建议用户：

1
在终端运行: ! gcloud auth login

八、常用场景速查

场景 命令/操作
理解陌生代码库 claude 启动后问：“解释这个项目的架构”
快速修复 bug 描述 bug 现象，Claude Code 会自动定位和修复
代码审查 /review
安全审查 /security-review
生成项目文档 /init
添加新的权限 /update-config，在 allow 列表中添加
定时轮询 /loop 10m <command>
切换模型 /model opus
查看费用 /cost
查看所有命令 /help

九、总结

Claude Code CLI 的核心能力远不止"聊天"——它是一套完整的终端开发者工具链：

  • Slash 命令让你在对话中快速切换模式和管理会话
  • CLAUDE.md 和 settings.json 提供了项目级和用户级的持久化配置
  • 记忆系统让 Claude Code 越用越懂你的偏好
  • IDE 集成将 AI 能力无缝嵌入你的日常开发环境

掌握这些指令，你将从一个"偶尔问 AI 问题"的用户，变成"让 AI 成为日常开发流程的一部分"的高效开发者。