Claude Code CLI 命令：完整备忘单 (2026)

Claude Code CLI 命令：2026 年完整速查表

Claude Code 是 Anthropic 官方提供的命令行界面（CLI），用于在终端和代码库中直接与 Claude 进行交互。无论您是将其用于代码生成、调试、重构还是全功能开发，掌握其 CLI 命令和参数对于最大化提升生产力至关重要。

本速查表涵盖了截至 2026 年初 Claude Code 中可用的所有主要命令、斜杠命令、标志位（flags）和配置选项。

安装

通过 npm 全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

更新至最新版本：

npm update -g @anthropic-ai/claude-code

基础用法

在任何目录下以交互模式启动 Claude Code：

claude

无需进入交互模式，发送单次提示词（one-shot prompt）：

claude "explain what this project does"

通过管道将输入传给 Claude Code：

cat error.log | claude "explain this error and suggest a fix"

恢复最近的一次对话：

claude --resume

CLI 标志位（Flags）参考

标志位	简写	描述
`--version`	`-v`	输出已安装的版本
`--help`	`-h`	显示帮助信息
`--resume`	`-r`	恢复最近的一次对话
`--continue`	`-c`	继续上一次对话
`--print`	`-p`	打印模式：直接响应，不进入交互式会话
`--model`	`-m`	指定要使用的模型
`--output-format`		设置输出格式：`text`, `json`, `stream-json`
`--max-turns`		限制 Agent 运行的轮次上限
`--system-prompt`		提供自定义系统提示词
`--allowedTools`		限制可用的工具
`--disallowedTools`		排除特定工具
`--mcp-config`		MCP 服务器配置文件的路径
`--permission-mode`		设置权限模式：`default`, `plan`, `auto-edit`
`--verbose`		启用详细日志输出
`--dangerously-skip-permissions`		跳过所有权限确认（请谨慎使用）

标志位使用示例

使用特定模型并在打印模式下运行 Claude：

claude -p -m claude-sonnet-4 "write a Python function to parse CSV files"

限制 Agent 轮次以防止失控操作：

claude --max-turns 5 "refactor the auth module"

在脚本中使用 JSON 格式输出：

claude -p --output-format json "list all TODO comments in this project"

使用自定义系统提示词运行：

claude --system-prompt "You are a security auditor. Review code for vulnerabilities." "audit src/"

斜杠命令（交互模式）

在交互式 Claude Code 会话中，可以使用以下斜杠命令：

命令	描述
`/help`	显示可用命令和用法信息
`/clear`	清除对话历史并重新开始
`/compact`	压缩对话以节省上下文窗口容量
`/config`	查看或修改配置设置
`/cost`	显示当前会话的 Token 使用情况和预估费用
`/doctor`	运行诊断以检查配置问题
`/init`	在当前项目中初始化 `CLAUDE.md` 文件
`/login`	登录您的 Anthropic 账号进行身份验证
`/logout`	退出当前会话
`/mcp`	查看或管理 MCP 服务器连接
`/model`	在对话过程中切换当前的活动模型
`/permissions`	查看或修改工具权限
`/review`	对暂存区（staged）的更改请求代码审查
`/status`	显示当前会话状态和配置
`/terminal-setup`	配置终端集成（快捷键、Shell 等）
`/vim`	切换 Vim 快捷键模式

CLAUDE.md 文件

Claude Code 会读取项目根目录下的 CLAUDE.md 文件，以了解项目的特定背景。可以使用以下命令初始化：

claude /init

或者手动创建。一个典型的 CLAUDE.md 文档包含：

# Project Overview
这是一个使用 TypeScript 和 Tailwind CSS 的 Next.js 14 应用。

# Tech Stack
- Framework: Next.js 14 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS + shadcn/ui
- Database: PostgreSQL via Prisma
- Auth: NextAuth.js v5

# Coding Conventions
- 使用带 Hooks 的函数式组件
- 优先使用具名导出（named exports）
- 使用带有 @/ 前缀的绝对导入
- 使用 Vitest 编写测试

# File Structure
- src/app/ - Next.js app router 页面
- src/components/ - 可复用的 UI 组件
- src/lib/ - 工具函数和共享逻辑
- prisma/ - 数据库 Schema 和迁移文件

配置

查看当前配置：

claude /config

配置存储在 ~/.claude/ 目录下，包括：

文件	用途
`~/.claude/settings.json`	全局用户设置
`~/.claude/mcp_servers.json`	MCP 服务器配置
`.claude/settings.json`	项目级设置（可提交至仓库）
`CLAUDE.md`	项目上下文文件
`~/.claude/CLAUDE.md`	全局上下文文件（适用于所有项目）

权限模式

Claude Code 提供三种权限模式来控制 AI 的自主程度：

模式	行为
`default`	在写入文件和执行命令前请求许可
`plan`	只读模式；Claude 可以分析但不能修改文件
`auto-edit`	自动批准文件编辑，但执行命令仍需询问

启动时设置模式：

claude --permission-mode plan "analyze the architecture of this project"

或者在 .claude/settings.json 中配置特定工具的权限：

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npm run lint)"
    ],
    "deny": [
      "Bash(rm *)",
      "Bash(git push)"
    ]
  }
}

MCP 服务器管理

列出已连接的 MCP 服务器：

claude /mcp

通过位于 ~/.claude/mcp_servers.json 的配置文件添加 MCP 服务器：

{
  "github": {
    "command": "npx",
    "args": ["@anthropic/mcp-server-github"],
    "env": {
      "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
    }
  }
}

常用模式与工作流

提交代码前的快速审查：

git diff --staged | claude -p "review these changes for bugs and suggest improvements"

生成提交信息（commit messages）：

git diff --staged | claude -p "write a concise commit message for these changes"

解释陌生的代码库：

claude "give me a high-level overview of this project's architecture"

运行测试并修复失败项：

claude "run the test suite and fix any failing tests"

配合脚本进行批处理：

for file in src/components/*.tsx; do
  claude -p "add JSDoc comments to all exported functions" < "$file"
done

快捷键（交互模式）

快捷键	动作
`Ctrl+C`	取消当前的生成任务
`Ctrl+D`	退出 Claude Code
`向上箭头`	滚动查看历史提示词
`Tab`	接受自动补全建议
`Esc`	在单行和多行输入模式间切换
`Shift+Tab`	拒绝当前建议

费用监控

追踪会话期间的支出：

/cost

该命令将显示：

消耗的总输入 Token 数
生成的总输出 Token 数
预估的美元成本
缓存命中率（针对重复上下文）

常见问题排除

Claude Code 没有读取我的 CLAUDE.md： 确保该文件位于工作目录的根目录下。Claude Code 会在当前目录及父目录中查找 CLAUDE.md。

MCP 服务器连接失败： 检查 MCP 配置中指定的命令是否在您的环境变量 PATH 中可用。尝试手动运行该命令以验证其是否正常工作。

Token 使用量过高： 定期使用 /compact 来压缩对话历史。这可以减少上下文窗口的使用量并降低成本。

权限拒绝错误（Permission denied）： 检查您的 .claude/settings.json 权限配置。您可能需要将特定工具添加到允许列表（allow list）中。

结语

Claude Code 是 2026 年最强大的 AI 编程助手之一，掌握其 CLI 命令能让您全面掌控 AI 驱动的开发工作流。请收藏并随时参考本速查表。

如果您正在开发需要 AI 媒体生成（图像、视频、音频或数字人分身）的应用，请关注 Hypereal AI。Hypereal 提供统一的 API，采用按需计费模式，生成速度极快，并支持 Flux、Kling 和 Wan 2.2 等最新模型。

Claude Code CLI 命令：2026 年完整速查表

本速查表涵盖了截至 2026 年初 Claude Code 中可用的所有主要命令、斜杠命令、标志位（flags）和配置选项。

安装

通过 npm 全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

更新至最新版本：

npm update -g @anthropic-ai/claude-code

基础用法

在任何目录下以交互模式启动 Claude Code：

claude

无需进入交互模式，发送单次提示词（one-shot prompt）：

claude "explain what this project does"

通过管道将输入传给 Claude Code：

cat error.log | claude "explain this error and suggest a fix"

恢复最近的一次对话：

claude --resume

CLI 标志位（Flags）参考

标志位	简写	描述
`--version`	`-v`	输出已安装的版本
`--help`	`-h`	显示帮助信息
`--resume`	`-r`	恢复最近的一次对话
`--continue`	`-c`	继续上一次对话
`--print`	`-p`	打印模式：直接响应，不进入交互式会话
`--model`	`-m`	指定要使用的模型
`--output-format`		设置输出格式：`text`, `json`, `stream-json`
`--max-turns`		限制 Agent 运行的轮次上限
`--system-prompt`		提供自定义系统提示词
`--allowedTools`		限制可用的工具
`--disallowedTools`		排除特定工具
`--mcp-config`		MCP 服务器配置文件的路径
`--permission-mode`		设置权限模式：`default`, `plan`, `auto-edit`
`--verbose`		启用详细日志输出
`--dangerously-skip-permissions`		跳过所有权限确认（请谨慎使用）

标志位使用示例

使用特定模型并在打印模式下运行 Claude：

claude -p -m claude-sonnet-4 "write a Python function to parse CSV files"

限制 Agent 轮次以防止失控操作：

claude --max-turns 5 "refactor the auth module"

在脚本中使用 JSON 格式输出：

claude -p --output-format json "list all TODO comments in this project"

使用自定义系统提示词运行：

claude --system-prompt "You are a security auditor. Review code for vulnerabilities." "audit src/"

斜杠命令（交互模式）

在交互式 Claude Code 会话中，可以使用以下斜杠命令：

命令	描述
`/help`	显示可用命令和用法信息
`/clear`	清除对话历史并重新开始
`/compact`	压缩对话以节省上下文窗口容量
`/config`	查看或修改配置设置
`/cost`	显示当前会话的 Token 使用情况和预估费用
`/doctor`	运行诊断以检查配置问题
`/init`	在当前项目中初始化 `CLAUDE.md` 文件
`/login`	登录您的 Anthropic 账号进行身份验证
`/logout`	退出当前会话
`/mcp`	查看或管理 MCP 服务器连接
`/model`	在对话过程中切换当前的活动模型
`/permissions`	查看或修改工具权限
`/review`	对暂存区（staged）的更改请求代码审查
`/status`	显示当前会话状态和配置
`/terminal-setup`	配置终端集成（快捷键、Shell 等）
`/vim`	切换 Vim 快捷键模式

CLAUDE.md 文件

Claude Code 会读取项目根目录下的 CLAUDE.md 文件，以了解项目的特定背景。可以使用以下命令初始化：

claude /init

或者手动创建。一个典型的 CLAUDE.md 文档包含：

# Project Overview
这是一个使用 TypeScript 和 Tailwind CSS 的 Next.js 14 应用。

# Tech Stack
- Framework: Next.js 14 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS + shadcn/ui
- Database: PostgreSQL via Prisma
- Auth: NextAuth.js v5

# Coding Conventions
- 使用带 Hooks 的函数式组件
- 优先使用具名导出（named exports）
- 使用带有 @/ 前缀的绝对导入
- 使用 Vitest 编写测试

# File Structure
- src/app/ - Next.js app router 页面
- src/components/ - 可复用的 UI 组件
- src/lib/ - 工具函数和共享逻辑
- prisma/ - 数据库 Schema 和迁移文件

配置

查看当前配置：

claude /config

配置存储在 ~/.claude/ 目录下，包括：

文件	用途
`~/.claude/settings.json`	全局用户设置
`~/.claude/mcp_servers.json`	MCP 服务器配置
`.claude/settings.json`	项目级设置（可提交至仓库）
`CLAUDE.md`	项目上下文文件
`~/.claude/CLAUDE.md`	全局上下文文件（适用于所有项目）

权限模式

Claude Code 提供三种权限模式来控制 AI 的自主程度：

模式	行为
`default`	在写入文件和执行命令前请求许可
`plan`	只读模式；Claude 可以分析但不能修改文件
`auto-edit`	自动批准文件编辑，但执行命令仍需询问

启动时设置模式：

claude --permission-mode plan "analyze the architecture of this project"

或者在 .claude/settings.json 中配置特定工具的权限：

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npm run lint)"
    ],
    "deny": [
      "Bash(rm *)",
      "Bash(git push)"
    ]
  }
}

MCP 服务器管理

列出已连接的 MCP 服务器：

claude /mcp

通过位于 ~/.claude/mcp_servers.json 的配置文件添加 MCP 服务器：

{
  "github": {
    "command": "npx",
    "args": ["@anthropic/mcp-server-github"],
    "env": {
      "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
    }
  }
}

常用模式与工作流

提交代码前的快速审查：

git diff --staged | claude -p "review these changes for bugs and suggest improvements"

生成提交信息（commit messages）：

git diff --staged | claude -p "write a concise commit message for these changes"

解释陌生的代码库：

claude "give me a high-level overview of this project's architecture"

运行测试并修复失败项：

claude "run the test suite and fix any failing tests"

配合脚本进行批处理：

for file in src/components/*.tsx; do
  claude -p "add JSDoc comments to all exported functions" < "$file"
done

快捷键（交互模式）

快捷键	动作
`Ctrl+C`	取消当前的生成任务
`Ctrl+D`	退出 Claude Code
`向上箭头`	滚动查看历史提示词
`Tab`	接受自动补全建议
`Esc`	在单行和多行输入模式间切换
`Shift+Tab`	拒绝当前建议

费用监控

追踪会话期间的支出：

/cost

该命令将显示：

消耗的总输入 Token 数
生成的总输出 Token 数
预估的美元成本
缓存命中率（针对重复上下文）

常见问题排除

Claude Code 没有读取我的 CLAUDE.md： 确保该文件位于工作目录的根目录下。Claude Code 会在当前目录及父目录中查找 CLAUDE.md。

MCP 服务器连接失败： 检查 MCP 配置中指定的命令是否在您的环境变量 PATH 中可用。尝试手动运行该命令以验证其是否正常工作。

Token 使用量过高： 定期使用 /compact 来压缩对话历史。这可以减少上下文窗口的使用量并降低成本。

权限拒绝错误（Permission denied）： 检查您的 .claude/settings.json 权限配置。您可能需要将特定工具添加到允许列表（allow list）中。

结语

Claude Code 是 2026 年最强大的 AI 编程助手之一，掌握其 CLI 命令能让您全面掌控 AI 驱动的开发工作流。请收藏并随时参考本速查表。

开始使用 Hypereal 构建

Claude Code CLI 命令：2026 年完整速查表

安装

基础用法

CLI 标志位（Flags）参考

标志位使用示例

斜杠命令（交互模式）

CLAUDE.md 文件

配置

权限模式

MCP 服务器管理

常用模式与工作流

快捷键（交互模式）

费用监控

常见问题排除

结语

相关文章

最佳 Cursor Rules：优质 .cursorrules 资源汇总 (2026)

Claude API Rate Limits 完整指南 (2026)

如何使用 Claude Chrome DevTools MCP Server (2026)

立即开始构建

开始使用 Hypereal 构建

Claude Code CLI 命令：2026 年完整速查表

安装

基础用法

CLI 标志位（Flags）参考

标志位使用示例

斜杠命令（交互模式）

CLAUDE.md 文件

配置

权限模式

MCP 服务器管理

常用模式与工作流

快捷键（交互模式）

费用监控

常见问题排除

结语

相关文章

最佳 Cursor Rules：优质 .cursorrules 资源汇总 (2026)

Claude API Rate Limits 完整指南 (2026)

如何使用 Claude Chrome DevTools MCP Server (2026)

立即开始构建