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 等最新模型。