Claude Code 实用命令指南

引言

Claude Code 是 Anthropic 推出的一款 CLI（命令行）AI 编程助手，它能直接在终端中与你的代码库进行交互——编辑文件、执行命令、搜索代码、管理 Git 等。与传统的 IDE 插件不同，Claude Code 以终端原生的方式工作，直接读取你的项目文件和上下文，不需要手动复制粘贴代码片段。本文将梳理 Claude Code 中最常用、最实用的命令，帮助你快速上手并提升开发效率

安装与认证

安装

1
2
3
4
5

# macOS / Linux（推荐）
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew
brew install --cask claude-code

认证与版本

安装完成后，需要先登录认证：

1
2
3
4
5

# 登录（支持 OAuth、SSO、API Key 等方式）
claude auth login

# 查看认证状态
claude auth status --text

1
2
3
4

# 输出示例：
Login method: Claude Max Account
Organization: Henry He
Email: oboooks@gmail.com

1
2
3
4
5

# 查看当前版本
claude --version

# 输出示例：
# 2.1.89 (Claude Code)

1
2

# 更新到最新版本
claude update

启动与会话管理

启动方式

Claude Code 提供了多种启动方式，适应不同的使用场景：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 启动交互式会话（最常用）
claude

# 用于‌跳过所有权限确认提示
claude --dangerously-skip-permissions

# 带初始提示直接启动
claude "帮我看看这个项目的目录结构"

# 非交互模式（执行完即退出，适合脚本和管道）
claude -p "解释这段代码的功能"

# 管道输入（将其他命令的输出传给 Claude）
cat main.py | claude -p "这段代码有什么bug？"
git diff | claude -p "总结这次改动"

-p（--print）是非交互模式的核心参数，它让 Claude 像一个普通的命令行工具一样，处理完输入后直接输出结果并退出。这使得 Claude Code 可以无缝集成到 Shell 脚本和 CI/CD 流程中

会话恢复

Claude Code 会自动保存会话历史，支持随时恢复之前的对话：

1
2
3
4
5
6
7
8
9
10
11
12
13

# 继续当前目录最近的会话
claude -c
# 或
claude --continue

# 恢复历史回话，在持续开发的时候非常有用
claude --resume

# 恢复指定会话 ID
claude -r "session-id"

# 为会话命名（方便后续恢复）
claude -n "auth-refactor"

给会话命名是一个好习惯，后续可以通过 claude -r auth-refactor 快速恢复对应的工作上下文

工作区隔离

在进行多分支并行开发时，--worktree 参数非常有用：

1
2
3
4
5

# 在独立的 git worktree 中启动（不影响主工作区）
claude -w feature-auth

# 配合 tmux 使用
claude -w feature-auth --tmux

这意味着你可以同时运行多个 Claude 会话，各自在独立的工作目录中操作，互不干扰

会话内斜杠命令

在交互式会话中，Claude Code 提供了丰富的斜杠命令（/command），用于控制会话、切换模式和管理工具。以下是使用频率最高的命令：

上下文管理

• /clear 是最常用的命令之一。当你在一个会话中完成了某个任务，准备开始一个不相关的新任务时，建议先执行 /clear。混杂的上下文会降低 Claude 的响应质量
• /compact 在长对话中非常有用。当上下文窗口即将耗尽时，系统会自动压缩，但你也可以主动执行。加上说明可以告诉 Claude 哪些信息需要保留，例如 /compact 保留关于认证模块的讨论

模型与模式

• /model 支持在对话中随时切换模型。例如简单任务用 Sonnet 节省额度，复杂架构分析切换到 Opus
• /plan 进入只读模式后，Claude 只会分析和给出建议，不会实际修改任何文件。这在进行架构评审或代码分析时非常安全

信息查看

• /cost 对于控制使用成本非常重要，尤其是使用 API Key 付费时
• /diff 可以让你在提交前回顾 Claude 做了哪些修改

会话操作

• /rewind 是一个很实用的”后悔药”。当 Claude 的修改方向不对时，可以回退到之前的检查点，重新给出指令

项目配置

• /init 会扫描项目结构并自动生成一份 CLAUDE.md，其中包含项目的技术栈、常用命令、代码规范等信息，让 Claude 更好地理解你的项目
• CLAUDE.md 是 Claude Code 的核心配置机制，它相当于给 Claude 的一份”项目说明书”

CLI 核心参数

模型控制

1
2
3
4
5
6
7
8
9

# 指定模型启动
claude --model sonnet
claude --model opus

# 设置思考深度
claude --effort high

# 设置备选模型（主模型过载时自动切换）
claude -p --fallback-model sonnet "分析这段代码"

输出格式

1
2
3
4
5

# 纯文本输出（默认）
claude -p "你好"

# JSON 格式输出（包含 token 用量、费用等元信息）
claude -p --output-format json "1+1等于几"

JSON 输出示例：

1
2
3
4
5
6
7
8
9
10

{
  "type": "result",
  "result": "2",
  "duration_ms": 3737,
  "total_cost_usd": 0.058,
  "usage": {
    "input_tokens": 3,
    "output_tokens": 5
  }
}

权限模式

1
2
3
4
5
6
7
8

# 自动接受文件编辑（bash 命令仍需确认）
claude --permission-mode acceptEdits

# 只读计划模式
claude --permission-mode plan

# 自动模式（分类器自动审查安全性）
claude --permission-mode auto

在交互式会话中，可以按 Shift+Tab 快速循环切换权限模式

预算控制

1
2
3
4
5

# 限制最大花费（单位：美元）
claude -p --max-budget-usd 0.5 "重构这个模块"

# 限制最大对话轮次
claude -p --max-turns 3 "修复这个 bug"

自定义系统提示

1
2
3
4
5

# 替换系统提示
claude --system-prompt "你是一个专注于代码安全审计的助手"

# 追加到默认系统提示
claude --append-system-prompt "所有回复使用中文"

键盘快捷键

在交互式会话中，以下快捷键可以显著提升操作效率：

生成控制

模式切换

输入技巧

快速前缀

Claude Code 支持几种特殊的输入前缀，提供快捷操作：

• ! 前缀等效于在终端中执行命令，但输出会自动加入到对话上下文中，Claude 可以看到命令的输出结果
• @ 前缀支持自动补全，可以快速引用项目中的文件，省去描述文件路径的麻烦

MCP 服务器管理

MCP（Model Context Protocol）是 Claude Code 的扩展机制，允许你接入外部工具和数据源：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 列出已配置的 MCP 服务器
claude mcp list

# 添加一个 stdio 类型的 MCP 服务器
claude mcp add my-server node server.js

# 添加 HTTP 类型的 MCP 服务器
claude mcp add --transport http my-api http://localhost:3000/mcp

# 从 Claude Desktop 导入 MCP 配置
claude mcp add-from-claude-desktop

# 删除 MCP 服务器
claude mcp remove my-server

CLAUDE.md 配置体系

CLAUDE.md 是 Claude Code 最重要的配置文件，它告诉 Claude 关于你的项目的一切——技术栈、代码规范、常用命令等。Claude 在每次会话开始时都会自动读取它

配置文件层级

按优先级从高到低：

1. 项目级 CLAUDE.md — 放在项目根目录，团队共享
2. 个人级 CLAUDE.local.md — 放在项目根目录，加入 .gitignore
3. 全局级 ~/.claude/CLAUDE.md — 适用于所有项目

快速生成

1
2

# 自动扫描项目并生成 CLAUDE.md
claude /init

编写建议

• 只写 Claude 无法从代码本身推断的信息（如特殊的构建步骤、部署流程）
• 保持简洁，避免冗长的规则
• 重要规则用 IMPORTANT 标注

实用工作流

代码审查

1
2
3
4
5

# 审查最近的 Git 改动
git diff | claude -p "审查这段代码改动，指出潜在问题"

# 审查某个文件
claude "审查 @src/auth.py 的安全性"

Git 提交

在交互式会话中，直接对 Claude 说：

1

帮我提交这些改动

Claude 会自动执行 git diff、分析变更、生成 commit message 并提交

Bug 修复

1
2

# 描述 bug，让 Claude 定位并修复
claude "用户反馈登录页面报 500 错误，请排查并修复"

批量操作

1
2

# 管道 + 非交互模式，批量处理
find . -name "*.py" | head -5 | xargs -I{} claude -p "检查 {} 的代码质量"

环境变量

一些常用的环境变量可以设置默认行为：

最佳实践

• 给 Claude 验证自身工作的手段：提供测试命令、预期输出或截图，让 Claude 能够自检修改是否正确。这是提升 Claude 工作质量最有效的方式
• 先计划再编码：对于复杂任务，先用 /plan 模式做只读分析和方案设计，确认方案后再切回正常模式执行
• 善用 @ 引用文件：直接告诉 Claude 你要操作的文件，比描述路径更高效
• 及时清理上下文：不相关任务之间用 /clear 重置，避免上下文污染
• 两次纠正失败就重来：如果 Claude 连续两次没理解你的意图，/clear 后用更清晰的方式重新描述

参考文献

• [1] Claude Code Overview
• [2] Claude Code CLI Reference
• [3] Claude Code Slash Commands
• [4] Claude Code Best Practices
• [5] Claude Code GitHub Repository

• ← Previous Post
• Next Post →