7D-AI系列:AI编程工具之Claude Code 命令集

文章目录

概述

本文档提供了 Claude Code 的完整命令集,包括交互式命令、命令行标志、快捷方式等。

交互式命令

在 Claude Code 交互模式中可用的命令:

命令 目的
/add-dir 添加额外的工作目录
/agents 管理用于专门任务的自定义 AI 子代理
/bug 报告错误(将对话发送到 Anthropic)
/clear 清除对话历史
/compact [instructions] 使用可选的焦点指令压缩对话
/config 查看/修改配置
/cost 显示令牌使用统计和计费信息
/doctor 检查 Claude Code 安装的健康状况
/help 获取使用帮助
/init CLAUDE.md 指南初始化项目
/login 切换 Anthropic 账户
/logout 从 Anthropic 账户登出
/mcp 管理 MCP 服务器连接和 OAuth 认证
/memory 编辑 CLAUDE.md 内存文件
/model 选择或更改 AI 模型
/permissions 查看或更新工具权限
/pr_comments 查看拉取请求评论
/review 请求代码审查
/status 查看账户和系统状态
/terminal-setup 安装 Shift+Enter 键绑定以换行(仅适用于 iTerm2 和 VSCode)
/vim 进入 vim 模式以交替插入和命令模式

命令行标志

标志 / 命令 描述 示例
-d, --debug 启用调试模式(显示详细调试输出) claude -d -p "query"
--include-partial-messages 通过 CLI 标志支持部分消息流
--mcp-debug [已弃用] MCP 调试模式(显示 MCP 服务器错误)。请改用 --debug claude --mcp-debug
--verbose 覆盖配置中的详细模式设置(显示扩展日志/逐轮输出) claude --verbose
-p, --print 打印响应并退出(用于管道输出) claude -p "query"
--output-format 输出格式(仅与 --print 一起工作):text(默认)、json(单个结果)或 stream-json(实时流) claude -p "query" --output-format json
--input-format 输入格式(仅与 --print 一起工作):text(默认)或 stream-json(实时流输入) claude -p --output-format stream-json --input-format stream-json
--replay-user-messages 将用户消息从标准输入重新发送回标准输出以确认 --- 仅与 --input-format=stream-json 和 --output-format=stream-json 一起工作 claude --input-format stream-json --output-format stream-json --replay-user-messages
--allowedTools, --allowed-tools <tools...> 允许的工具名称的逗号/空格分隔列表(例如 "Bash(git:*) Edit") --allowed-tools "Bash(git:*)" Edit"
--disallowedTools, --disallowed-tools <tools...> 拒绝的工具名称的逗号/空格分隔列表(例如 "Bash(git:*) Edit") --disallowed-tools "Edit"
--mcp-config <configs...> 从 JSON 文件或字符串加载 MCP 服务器(空格分隔) claude --mcp-config ./mcp-servers.json
--strict-mcp-config 仅使用来自 --mcp-config 的 MCP 服务器,忽略其他 MCP 配置 claude --mcp-config ./a.json --strict-mcp-config
--append-system-prompt 将系统提示附加到默认系统提示(在打印模式下有用) claude -p --append-system-prompt "Do X then Y"
--permission-mode 会话的权限模式(选项包括 acceptEdits, bypassPermissions, default, plan) claude --permission-mode plan
--permission-prompt-tool 在非交互模式下指定 MCP 工具以处理权限提示 claude -p --permission-prompt-tool mcp_auth_tool "query"
--fallback-model 在默认模型过载时启用自动回退到指定模型(注意:仅与 --print 一起工作,根据帮助) claude -p --fallback-model claude-haiku-20240307 "query"
--model 当前会话的模型。接受别名如 sonnet/opus 或完整模型名称(例如 claude-sonnet-4-20250514) claude --model sonnet
--settings 从 JSON 文件或 JSON 字符串加载额外设置 claude --settings ./settings.json
--add-dir <directories...> 允许工具访问的额外目录 claude --add-dir ../apps ../lib
--ide 如果恰好有一个有效的 IDE 可用,则在启动时自动连接到 IDE claude --ide
-c, --continue 继续当前目录中最最近的对话 claude --continue
-r, --resume [sessionId] 恢复对话;提供会话 ID 或交互式选择一个 claude -r "abc123"
--session-id 使用特定会话 ID 进行对话(必须是有效 UUID) claude --session-id 123e4567-e89b-12d3-a456-426614174000
--dangerously-skip-permissions 绕过所有权限检查(仅用于受信任的沙箱) claude --dangerously-skip-permissions
-v, --version 显示安装的 claude CLI 版本 claude --version
-h, --help 显示帮助/使用说明 claude --help

注意:--output-format json 标志对于脚本和自动化特别有用,允许您以编程方式解析 Claude 的响应。

常用命令参考

基础/交互式命令

bash 复制代码
claude                                 # 启动交互式 REPL
claude "explain this project"          # 启动 REPL 并使用提示词
claude -p "summarize README.md"        # 非交互式打印模式(SDK 支持)
cat logs.txt | claude -p "explain"     # 将输入管道传输到 Claude 并退出
claude -c                              # 继续最近的对话(--continue 的别名)
claude -r "<session-id>" "finish this" # 按 ID 恢复特定会话(--resume 的别名)
claude --model claude-sonnet-4-20250514 # 为此运行选择模型
claude --max-turns 3 -p "lint this"    # 在打印模式下限制代理回合数
claude --replay-user-messages          # 将用户消息重播到 stdout 以进行调试/SDK 工作流

更新和安装

bash 复制代码
claude update                          # 手动更新 Claude Code
claude doctor                          # 诊断安装/版本和设置
claude install                         # 启动本机二进制安装程序(测试版)
claude migrate-installer               # 从全局 npm 迁移到本地安装程序

配置:交互式向导 + 直接操作

bash 复制代码
claude config                          # 交互式配置向导
claude config get <key>                # 获取值(例如,claude config get theme)
claude config set <key> <val>          # 设置值(例如,claude config set theme dark)
claude config add <key> <vals...>        # 附加到数组类型键(例如,claude config add env DEV=1)
claude config remove <key> <vals...>     # 从列表类型键中删除项目
claude config list                     # 显示项目的当前所有设置(项目范围是默认值)

示例项目范围设置

bash 复制代码
claude config set model "claude-3-5-sonnet-20241022"  # 为此项目覆盖默认模型
claude config set includeCoAuthoredBy false           # 在 git/PR 中禁用 "co-authored-by Claude" 署名
claude config set forceLoginMethod claudeai           # 限制登录流程: claudeai | console
claude config set enableAllProjectMcpServers true     # 自动批准来自 .mcp.json 的所有 MCP 服务器
claude config set defaultMode "acceptEdits"           # 设置默认权限模式
claude config set disableBypassPermissionsMode disable # 防止 bypassPermissions 模式(示例键)

管理列表设置(项目范围)

bash 复制代码
claude config add enabledMcpjsonServers github        # 批准来自 .mcp.json 的特定 MCP 服务器
claude config add enabledMcpjsonServers memory        # 添加另一个
claude config remove enabledMcpjsonServers memory     # 删除一个条目
claude config add disabledMcpjsonServers filesystem   # 明确拒绝特定 MCP 服务器

全局范围(使用 -g 或 --global)

bash 复制代码
claude config set -g autoUpdates false                # 全局关闭自动更新
claude config set --global preferredNotifChannel iterm2_with_bell
claude config set -g theme dark                       # 主题:dark | light | light-daltonized | dark-daltonized
claude config set -g verbose true                     # 在任何地方显示完整 bash/命令输出
claude config get -g theme                            # 确认全局值

MCP(模型上下文协议)管理

bash 复制代码
claude mcp                              # 启动 MCP 向导/配置 MCP 服务器
claude mcp list                         # 列出配置的 MCP 服务器
claude mcp get <name>                   # 显示服务器详细信息
claude mcp remove <name>                # 移除服务器
claude mcp add <name> <command> [args...]              # 添加本地 stdio 服务器
claude mcp add --transport sse <name> <url>            # 添加远程 SSE 服务器
claude mcp add --transport http <name> <url>           # 添加远程 HTTP 服务器
claude mcp add <name> --env KEY=VALUE -- <cmd> [args...] # 为服务器命令传递环境变量
claude mcp add --transport sse private-api https://api.example/mcp \
  --header "Authorization: Bearer TOKEN"               # 添加带认证头的服务器
claude mcp add-json <name> '<json>'                    # 通过 JSON 块添加服务器
claude mcp add-from-claude-desktop                     # 从 Claude 桌面导入服务器
claude mcp reset-project-choices                       # 重置项目 .mcp.json 服务器的批准
claude mcp serve                                      # 将 Claude Code 本身作为 MCP stdio 服务器运行

其他有用的标志(打印/SDK 模式)

bash 复制代码
claude --add-dir ../apps ../lib                      # 添加额外的工作目录
claude --allowedTools "Bash(git log:*)" "Read"       # 允许列出的工具,无需权限提示
claude --disallowedTools "Edit"                      # 拒绝列出的工具,无需权限提示
claude --append-system-prompt "Custom instruction"   # 附加到系统提示(仅与 -p 一起使用)
claude -p "query" --output-format json --input-format stream-json  # 控制脚本的 IO 格式
claude --verbose                                     # 详细日志记录(逐轮)
claude --dangerously-skip-permissions                # 跳过权限提示(谨慎使用)

界面和输入

键盘快捷键

快捷键 描述 上下文
Ctrl+C 取消当前输入或生成 标准中断
Ctrl+D 退出 Claude Code 会话 EOF 信号
Ctrl+L 清除终端屏幕 保持对话历史
上/下箭头 导航命令历史 回忆以前的输入
Esc + Esc 编辑上一条消息 双重转义以修改

多行输入

方法 快捷键 上下文
快速转义 \ + Enter 在所有终端中工作
macOS 默认 Option+Enter macOS 上的默认设置
终端设置 Shift+Enter /terminal-setup 后
控制序列 Ctrl+J 用于多行的换行符
粘贴模式 直接粘贴 用于代码块、日志

快速命令

快捷键 描述 注释
# 开头 内存快捷方式添加到 CLAUDE.md 提示选择文件
/ 开头 斜杠命令

Vim 模式

注意:使用 /vim 命令启用 vim 风格编辑,或通过 /config 永久配置。

Vim 模式切换
命令 操作 从模式
Esc 进入 NORMAL 模式 INSERT
i 在光标前插入 NORMAL
I 在行首插入 NORMAL
a 在光标后插入 NORMAL
A 在行尾插入 NORMAL
o 在下方打开行 NORMAL
O 在上方打开行 NORMAL
Vim 导航
命令 操作
h/j/k/l 左/下/上/右移动
w 下一个单词
e 单词结尾
b 上一个单词
0 行首
$ 行尾
^ 第一个非空格字符
gg 输入开头
G 输入结尾
Vim 编辑
命令 操作
x 删除字符
dd 删除行
D 删除到行尾
dw/de/db 删除单词/到结尾/到开头
cc 更改行
C 更改到行尾
cw/ce/cb 更改单词/到结尾/到开头
. 重复上次更改

提示:在终端设置中配置首选换行行为。运行 /terminal-setup 为 iTerm2 和 VS Code 终端安装 Shift+Enter 绑定。

命令历史

Claude Code 为当前会话维护命令历史:

  • 历史按工作目录存储
  • /clear 命令清除
  • 使用上下箭头键导航(参见上面的键盘快捷键)
  • Ctrl+R : 反向搜索历史(如果终端支持)
  • 注意:历史扩展(! )默认禁用
相关推荐
牛奶1 小时前
2026年大模型怎么选?前端人实用对比
前端·人工智能·ai编程
牛奶1 小时前
前端人为什么要学AI?
前端·人工智能·ai编程
KEEN的创享空间7 小时前
AI编程从0到1之10X提效(Vibe Coding 氛围式编码 )09篇
openai·ai编程
AlienZHOU8 小时前
为 AI Agent 编写高质量 Skill:Claude 官方指南
agent·ai编程·claude
恋猫de小郭9 小时前
移动端开发稳了?AI 目前还无法取代客户端开发,小红书的论文告诉你数据
前端·flutter·ai编程
KaneLogger10 小时前
【翻译】打造 Agent Skills 的最佳实践
agent·ai编程·claude
王小酱10 小时前
Everything Claude Code 文档
openai·ai编程·aiops
雮尘11 小时前
如何在非 Claude IDE (TARE、 Cursor、Antigravity 等)下使用 Agent Skills
前端·agent·ai编程
刘贺同学11 小时前
Day12-龙虾哥打工日记:OpenClaw 子 Agent 到底看到了什么?
aigc·ai编程
程序员鱼皮13 小时前
离大谱,我竟然在 VS Code 里做了个视频!
github·aigc·ai编程