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 : 反向搜索历史(如果终端支持)
  • 注意:历史扩展(! )默认禁用
相关推荐
leikooo3 小时前
Spring AI 工具调用回调与流式前端展示的完整落地方案
java·spring·ai·ai编程
Aliex_git6 小时前
大模型相关概念 - LLM对话
人工智能·笔记·prompt·ai编程
心易行者7 小时前
Claude Code + Chrome:浏览器层面的AI编程新范式已至
前端·chrome·ai编程
MoonBit月兔9 小时前
MoonBit 获日本最大技术社区Zenn原生支持,热度持续上升中!
人工智能·ai编程·moonbit
想搞艺术的程序员9 小时前
AI 编程 - 提示词技巧
人工智能·ai编程
HyperAI超神经20 小时前
IQuest-Coder-V1:基于代码流训练的编程逻辑增强模型;Human Face Emotions:基于多标注维度的人脸情绪识别数据集
人工智能·深度学习·学习·机器学习·ai编程
砚边数影1 天前
AI数学基础(一):线性代数核心,向量/矩阵运算的Java实现
java·数据库·人工智能·线性代数·矩阵·ai编程·金仓数据库
Darkbluelr1 天前
[开源发布] Dev-PlayBooks:让 AI 编程不再“抽卡”,面向 Claude/Codex等 的确定性Spec+TDD开发工作流框架
人工智能·软件工程·ai编程
github.com/starRTC1 天前
Claude Code中英文系列教程:在云上虚拟机并行运行多个会话
ai编程