Claude Code CLI 命令行选项

本文整理 Anthropic Claude Code 的命令行接口、参数、Slash 命令、交互快捷键、权限模式与设置文件。内容对应官方 CLI reference、Commands、Interactive mode、Permission modes 与 Settings 等页面。

⚠️ Claude Code 版本迭代很快，命令与参数请以本机 claude --help、claude <子命令> --help 及官方最新文档为准。

---

快速开始

安装后在任意项目目录运行 claude 进入交互式会话；首次运行按提示登录 Anthropic 账号。

# 进入交互式会话
claude

# 带初始提示进入
claude "explain this project"

# 一次性提问后退出（非交互）
claude -p "explain this function"

# 继续当前目录最近一次会话
claude -c

# 更新到最新版本
claude update

[!TIP] 想让 Claude 改代码前先出方案，用 claude --permission-mode plan；想减少审批打断，用 claude --permission-mode auto。

---

CLI 命令总览

会话与查询

命令	说明	示例
claude	启动交互式会话	claude
claude "query"	带初始提示启动交互式会话	claude "explain this project"
claude -p "query"	通过 SDK 查询后退出	claude -p "explain this function"
cat file | claude -p "query"	处理管道输入	cat logs.txt | claude -p "explain"
claude -c	继续当前目录最近一次对话	claude -c
claude -c -p "query"	通过 SDK 继续对话	claude -c -p "Check for type errors"
claude -r "<session>" "query"	按 ID 或名称恢复会话	claude -r "auth-refactor" "Finish this PR"
claude update	更新到最新版本	claude update

账号与安装

命令	说明	示例
claude install [version]	安装或重装原生二进制；可接受 2.1.118、stable 或 latest	claude install stable
claude auth login	登录 Anthropic 账号；--email 预填邮箱，--sso 强制 SSO，--console 用 Console API 计费登录	claude auth login --console
claude auth logout	退出登录	claude auth logout
claude auth status	以 JSON 显示登录状态；--text 输出可读文本。已登录退出码 0，未登录 1	claude auth status
claude setup-token	为 CI / 脚本生成长期 OAuth token（仅打印不保存，需 Claude 订阅）	claude setup-token
claude doctor	打印只读的安装与设置诊断（安装健康、设置校验错误、Remote Control 资格）	claude doctor
claude gateway	启动自托管 Claude apps gateway（管理员部署 SSO 与策略用，需 --config gateway.yaml）	claude gateway --config gateway.yaml

后台会话与 Agent View

命令	说明	示例
claude agents	打开 agent view 监控 / 派发并行后台会话；--cwd <path>、--json、--json --all	claude agents --json
claude attach <id>	在当前终端挂接某个后台会话	claude attach 7c5dcf5d
claude logs <id>	打印后台会话的最近输出	claude logs 7c5dcf5d
claude stop <id>	停止后台会话（也接受 claude kill）	claude stop 7c5dcf5d
claude respawn <id>	重启后台会话并保留对话；--all 重启所有运行中的会话	claude respawn 7c5dcf5d
claude rm <id>	从列表移除后台会话；冲突时可按提示传 --discard-unpushed 或 --force-remove-worktree	claude rm 7c5dcf5d
claude daemon status	打印后台会话 supervisor 的状态、版本、socket 目录与 worker 数；未运行时退出码 1	claude daemon status
claude daemon stop --any	停止 supervisor 及其托管的会话；--keep-workers 保留后台会话	claude daemon stop --any --keep-workers

配置、扩展与云

命令	说明	示例
claude mcp	配置 MCP 服务器	见官方 MCP 文档
claude mcp login <name>	运行已配置 MCP 服务器的 OAuth 流程；SSH 下加 --no-browser 打印授权 URL	claude mcp login sentry
claude mcp logout <name>	清除 MCP 服务器的 OAuth 凭据	claude mcp logout sentry
claude plugin	管理插件（别名 claude plugins）	claude plugin install code-review@claude-plugins-official
claude import [source]	启动交互会话运行 /import，从其他 coding agent 导入配置	claude import codex --dry-run
claude project purge [path]	删除某项目的所有本地状态（transcript、任务列表、日志、历史等）	claude project purge ~/work/repo --dry-run
claude remote-control	启动 Remote Control 服务器，从 claude.ai 或 Claude App 控制	claude remote-control --name "My Project"
claude self-hosted-runner	启动注册到自托管环境的 runner，托管云端会话	claude self-hosted-runner setup
claude auto-mode defaults	以 JSON 打印内置 auto mode 分类器规则；claude auto-mode config 看生效配置	claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset	从用户设置移除 autoMode 段以恢复默认；-y/--yes 跳过确认	claude auto-mode reset --yes
claude ultrareview [target]	非交互式运行 ultrareview；--json、--timeout <minutes>、--post 发到 PR	claude ultrareview 1234 --json

[!TIP] 若子命令拼写错误，Claude Code 会提示最接近的匹配并退出，例如 claude udpate 会提示 Did you mean claude update?。

---

CLI 参数（Flags）

[!NOTE] claude --help 不会列出全部参数；某参数不在 --help 中并不代表它不可用。

会话与输入

参数	说明
--add-dir	增加 Claude 可读写的额外工作目录；校验路径必须存在且为目录，多数网络路径不可用。跨会话持久化请用设置项 permissions.additionalDirectories
--continue, -c	载入当前目录最近一次对话（含已结束的后台会话）；跳过 claude -p、SDK 以及首条提示为 /loop 的会话
--resume, -r	按 ID 或名称恢复指定会话，或打开交互选择器；也可传 .jsonl transcript 的绝对路径
--fork-session	恢复时创建新 session ID 而非复用原 ID（配合 --resume / --continue）
--from-pr	打开按 Pull Request 过滤的会话选择器，接受 PR 号、GitHub/GitLab/Bitbucket URL
--session-id	为对话指定 session ID（必须是合法 UUID）
--name, -n	为会话设置显示名称，显示在 /resume 与终端标题；可用 claude --resume <name> 恢复
--ide	启动时若恰好只有一个可用 IDE，则自动连接
--chrome	启用 Chrome 浏览器集成（网页自动化与测试）
--no-chrome	本次会话禁用 Chrome 浏览器集成
--worktree, -w	在 <repo>/.claude/worktrees/<name> 的隔离 git worktree 中启动；可传 #<number> 或 PR/MR URL 从其拉取分支
--tmux	为 worktree 创建 tmux 会话（需 --worktree）；--tmux=classic 用传统 tmux
--bg, --background	作为后台 agent 启动并立即返回，打印 session ID 与管理命令；不能与 -p/--print 组合
--exec	把 shell 命令作为 PTY 后台任务运行（配合 --bg）
--cloud	带任务描述创建云端会话；带 session ID / claude.ai/code URL 且配合 -p 时向该会话排队一条消息
--remote	--cloud 的已弃用别名
--teleport	在本地终端恢复一个云端会话
--environment <environment-id>	在指定自托管环境（ID 以 ccpool_ 开头）创建云端会话
--ref <branch>	配合 --environment，新会话检出基于指定 ref 而非本地 HEAD
--remote-control, --rc	启动启用 Remote Control 的交互会话，可从 claude.ai 或 Claude App 控制
--remote-control-session-name-prefix <prefix>	Remote Control 自动生成会话名的前缀，默认用主机名
--restricted	受限模式：移除会执行命令 / 代码的内置工具与 WebFetch，文件工具限定在工作目录，仅加载托管设置与 --settings，拒绝 bypassPermissions 与云会话
--safe-mode	禁用所有自定义项以排查配置问题（CLAUDE.md、skills、plugins、hooks、MCP、自定义命令 / agent 等都不加载）
--bare	极简模式：跳过 hooks、skills、自定义命令、subagents、plugins、MCP、auto memory 与 CLAUDE.md 的自动发现，加快脚本调用启动

模型与推理

参数	说明
--model	为本次会话设置模型，接受别名（sonnet、opus、haiku、fable）或完整名称
--fallback-model	主模型过载或不可用时自动回退到的模型，逗号分隔按顺序尝试
--advisor <model>	为本次会话启用服务端 advisor 工具，接受 fable、opus、sonnet 或完整模型 ID
--effort	设置推理强度：low、medium、high、xhigh、max、ultracode；可用级别取决于模型。ultracode 需 v2.1.203+
--autocompact <auto|tokens>	为本次会话设置自动压缩窗口，例如 --autocompact 500k，取值同 /autocompact

权限与安全

参数	说明
--permission-mode	指定初始权限模式：default（Manual）、acceptEdits、plan、auto、dontAsk、bypassPermissions，或 manual（default 别名）
--dangerously-skip-permissions	跳过权限提示，等价 --permission-mode bypassPermissions
--allow-dangerously-skip-permissions	把 bypassPermissions 加入 Shift+Tab 模式循环，但不从该模式启动
--allowedTools, --allowed-tools	无需提示即可执行的工具，支持权限规则语法如 "Bash(git log *)" "Read"
--disallowedTools, --disallowed-tools	拒绝规则。裸工具名会从上下文移除该工具（"Edit"、"*"、"mcp__*"）；带作用域的规则仅拒绝匹配调用
--tools	限制可用内置工具："" 禁用全部，"default" 默认集，或 "Bash,Edit,Read"；不影响 MCP 工具
--permission-prompt-tool	指定处理非交互模式权限提示的 MCP 工具
--permission-prompts	设置 print 模式下谁来回答权限提示：host（默认）或 none（无人应答则拒绝）
--channels	（研究预览）本次会话要监听的 MCP channel 通知，空格分隔 plugin:<name>@<marketplace>
--dangerously-load-development-channels	启用不在白名单上的 channels，用于本地开发，会要求确认

系统提示词

参数	说明
--system-prompt	用自定义文本完全替换默认系统提示
--system-prompt-file	从文件载入系统提示，替换默认提示
--append-system-prompt	在默认系统提示末尾追加文本
--append-system-prompt-file	从文件载入文本追加到默认系统提示
--system-prompt-snapshot	传 off 则每次请求重建系统提示，而非复用会话首次请求记录的版本
--exclude-dynamic-system-prompt-sections	把随机器变化的段（工作目录、环境、记忆路径等）移入首条用户消息，提升跨用户 / 机器的提示缓存复用；仅默认系统提示时生效
--append-subagent-system-prompt	在每个 subagent 系统提示末尾追加文本；仅非交互 -p 模式生效
--append-subagent-system-prompt-file	从文件载入文本追加到 subagent 系统提示；与上一参数互斥，仅 -p 生效

输出与流式

参数	说明
--print, -p	非交互打印响应后退出（Agent SDK 用法）
--output-format	print 模式输出格式：text、json、stream-json
--input-format	print 模式输入格式：text、stream-json
--include-partial-messages	输出包含部分流式事件（需 -p 与 --output-format stream-json）
--include-hook-events	输出流中包含 hook 生命周期事件（需 --output-format stream-json）
--forward-subagent-text	把 subagent 的文本与思考块作为带 parent_tool_use_id 的消息输出，便于重建其 transcript
--replay-user-messages	把 stdin 的用户消息回显到 stdout 作为确认（需 stream-json 输入与输出）
--prompt-suggestions	每轮后发出 prompt_suggestion 预测下一条用户提示（需 -p、stream-json、--verbose）
--json-schema	在 agent 完成工作流后返回符合 JSON Schema 的校验输出（仅 print 模式）
--max-turns	限制 agent 轮数（仅 print 模式），达到上限报错退出；默认无限制
--max-budget-usd	停止前允许的 API 花费上限（仅 print 模式），subagent 花费计入
--no-session-persistence	不持久化会话，无法恢复（仅 print 模式）

工具与扩展

参数	说明
--agent	为当前会话指定 agent（覆盖 agent 设置）
--agents	通过 JSON 动态定义自定义 subagents；启动时校验，非法即退出
--mcp-config	从 JSON 文件或字符串载入 MCP 服务器（空格分隔）
--strict-mcp-config	只使用 --mcp-config 的 MCP 服务器，忽略其它 MCP 配置
--plugin-dir	仅本次会话从目录、.zip 或插件文件夹载入插件；可重复
--plugin-url	仅本次会话从 URL 获取插件 .zip；可重复
--disable-slash-commands	本次会话禁用所有 skills 与命令
--betas	加入 API 请求的 beta header（仅 API key 用户）

调试、日志与其它

参数	说明
--verbose	启用详细日志，显示完整逐步输出；覆盖本次会话的 viewMode 设置
--debug	启用调试模式，可带分类过滤 --debug='mcp,startup'；= 形式才绑定过滤
--debug-file <path>	把调试日志写入指定文件，隐式启用调试模式
--version, -v	输出版本号
--settings	指向设置 JSON 文件或内联 JSON 字符串，本次会话覆盖同名键（文件不超过 2 MiB）
--setting-sources	逗号分隔的要加载的设置来源（user、project、local）
--teammate-mode	agent 团队队友的展示方式：in-process（默认）、auto、tmux、iterm2
--ax-screen-reader	渲染适合屏幕阅读器的输出（无边框与动画）；强制经典渲染器
--init	会话前以 init matcher 运行 Setup hooks（仅 print 模式）
--init-only	运行 Setup 与 SessionStart hooks 后退出，不启动对话
--maintenance	会话前以 maintenance matcher 运行 Setup hooks（仅 print 模式）
--enable-auto-mode	已在 v2.1.111 移除；改用 --permission-mode auto

---

系统提示词参数

Claude Code 提供五个系统提示相关参数，四个设置文本，一个控制是否沿用会话启动时的文本。二者在交互与非交互模式下都可用。

参数	行为	示例
--system-prompt	完全替换默认提示	claude --system-prompt "You are a Python expert"
--system-prompt-file	用文件内容替换	claude --system-prompt-file ./prompts/review.txt
--append-system-prompt	追加到默认提示	claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file	追加文件内容到默认提示	claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot	off 每次请求重建；on（默认）复用记录版本	claude --system-prompt-snapshot off

[!IMPORTANT] --system-prompt 与 --system-prompt-file 互斥；追加类参数可与任一替换参数组合使用。

[!TIP] 若希望在自定义提示中缓存静态部分，可在「每次运行都相同的指令」与「每次运行都变化的上下文」之间加入一行仅含 __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ 的分隔符（需 v2.1.275+）。

---

非交互模式（claude -p）

给任意 claude 命令加上 -p（或 --print）即可非交互运行。成功退出码 0，失败为非零。

claude -p "What does the auth module do?"

[!NOTE] 并非所有参数都能与 -p 组合：--bg 会被拒绝，带任务描述的 --cloud 也会被拒绝；带 session ID 的 --cloud 与 -p 组合则向该云端会话排队一条消息后退出。

更快的 bare 模式

claude --bare -p "Summarize README.md" --allowedTools "Read"

--bare 跳过 hooks、skills、自定义命令、subagents、plugins、MCP、auto memory 与 CLAUDE.md 的自动发现；Claude 仍可使用 Bash、文件读取与文件编辑工具。它推荐用于脚本与 SDK 调用，未来将成为 -p 的默认。bare 模式不读取 OAuth 凭据或系统钥匙串，需通过环境变量提供密钥。

要加载	使用参数
系统提示追加	--append-system-prompt、--append-system-prompt-file
设置	--settings <file-or-json>
MCP 服务器	--mcp-config <file-or-json>
自定义 agents	--agents <json>
插件	--plugin-dir <path>、--plugin-url <url>

结构化输出

# JSON 输出（含 result、session ID、元数据）
claude -p "Summarize this project" --output-format json

# 按 JSON Schema 输出
claude -p "Extract the main function names from auth.py" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

--output-format 取值：

• text（默认）：纯文本
• json：结构化 JSON，含 result、session ID 与元数据
• stream-json：换行分隔 JSON，用于实时流式

[!TIP] 用 jq 提取字段：claude -p "..." --output-format json | jq -r '.result'，结构化输出在 .structured_output。

流式响应

claude -p "Explain recursion" --output-format stream-json --verbose --include-partial-messages

自动批准工具

claude -p "Run the test suite and fix any failures" --allowedTools "Bash,Read,Edit"

[!TIP] 权限规则语法中结尾的 * 启用前缀匹配：Bash(git diff *) 允许任意以 git diff 开头的命令。* 前的空格很重要，Bash(git diff*) 会误匹配 git diff-index。

无人值守运行

claude -p "Update the dependency pins and run the tests" --permission-mode auto --permission-prompts none

继续对话

claude -p "Review this codebase for performance issues"
claude -p "Now focus on the database queries" --continue
claude -p "Generate a summary of all issues found" --continue

# 用 session ID 精确恢复
session_id=$(claude -p "Start a review" --output-format json | jq -r '.session_id')
claude -p "Continue that review" --resume "$session_id"

[!WARNING] 管道 stdin 上限为 10MB；超出会报错并非零退出。更大输入请写入文件后在提示中引用路径。

-p 模式下的命令支持

• 用户调用的 skills 与自定义命令可用：在提示字符串中包含 /skill-name，Claude Code 会在运行前展开。
• 仅在终端界面运行的内置命令（如 /login）不可用。
• /model、/effort、/fast、/color、/rename 接受参数（如 /model sonnet）；/mcp 无参数时打印服务器状态摘要。
• 改设置用 /config key=value，如 /config thinking=false。

---

权限模式

权限模式决定 Claude 在会话中无需询问即可执行哪些操作。用 Shift+Tab 循环切换，或启动时用 --permission-mode 指定。

模式	无需询问即可运行	适合场景
default（界面显示 Manual）	仅读取	想自己审查每一步、敏感工作
acceptEdits	读取、文件编辑与常见文件系统命令（mkdir、touch、mv、cp 等）	边审边改代码
plan	读取，以及 auto mode 可用时经分类器批准的命令	改代码前先探索代码库
auto	全部，但有后台安全检查	长任务、减少提示疲劳
dontAsk	读取与预批准工具；本会提示的一律拒绝	锁定的 CI 与脚本
bypassPermissions	全部	仅限隔离容器与 VM

[!WARNING] bypassPermissions 会跳过所有检查，只应在隔离容器 / VM 中使用。auto 模式能减少提示但不保证安全。

[!NOTE] 任何模式下都不会自动批准：显式 ask 规则匹配的工具、需要用户交互的工具（AskUserQuestion 与标记 requiresUserInteraction 的 MCP 工具）、针对关键路径的 rm / rmdir。拒绝（deny）规则在所有模式下都生效，包括 bypassPermissions。

启动模式的选择顺序

终端启动新会话时，按以下顺序取第一个适用的：

1. --permission-mode 或 --dangerously-skip-permissions
2. 设置文件中的 permissions.defaultMode（注意：auto / bypassPermissions 写在 .claude/settings.json 或 .claude/settings.local.json 中不生效）
3. 内置默认值（Pro / Max / Team 计划下通常为 auto；Enterprise、API key、-p、Bedrock/Vertex/Foundry 等为 default）

{
  "permissions": {
    "defaultMode": "default"
  }
}

常用组合

目标	起步方式	需要的隔离
自己审查每一步	claude --permission-mode default	无
本地迭代、少提示、不用分类器	Manual + Bash sandbox auto-allow（运行 /sandbox 选 auto-allow）	内置 Bash sandbox（macOS / Linux / WSL2）
改前先探索	claude --permission-mode plan	无
auto 模式放手工作	claude --permission-mode auto	无（sandbox 增加纵深防护）
CI 精确白名单	claude -p "..." --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"	CI runner 自带
容器内完全无人值守	claude -p "<prompt>" --dangerously-skip-permissions	必需容器 / VM / sandbox runtime

---

Slash 命令

在会话内输入 / 查看可用命令，继续输入可过滤。命令只在消息开头被识别，其后的文本作为参数。会话正在响应时发送的命令会被排队，但 /status、/tasks、/usage 等会立即运行。

[!NOTE] 并非所有命令对每个用户都可见，取决于平台、计划与环境。例如 /desktop 只在 macOS 与 x64 Windows 且订阅 Claude 时显示，/upgrade 在企业计划不显示。标记 [Skill] 的是捆绑 skill，[Workflow] 是捆绑动态工作流。

命令	用途
/add-dir <path>	为当前会话增加可访问的工作目录；Tab 可接受路径建议。多数 .claude/ 配置不会从该目录被发现
/advisor [model|off]	启用 / 关闭 advisor 工具（第二模型在关键时刻提供建议）；接受 fable、opus、sonnet 或完整模型 ID
/agents	提示向 Claude 请求创建 / 管理 subagents，或直接编辑 .claude/agents/
/artifacts	列出你拥有或共享给你的 artifacts，可附加到会话、浏览器打开或复制链接
/auto-mode-setup	从项目与近期会话草拟 autoMode.environment 条目并保存到用户设置
/autocompact [auto|<tokens>]	设置自动压缩窗口（如 500k），保存到用户设置并应用于当前会话
/autofix-pr [prompt]	启动云端会话，监视当前分支 PR 并在 CI 失败 / 评论时推送修复；需 gh CLI
/background [prompt]	把当前会话脱离为后台 agent，释放终端（别名 /bg）
/batch <instruction>	[Skill] 把大型跨库改动拆成 5–30 个独立单元，各自在隔离 worktree 中执行并开 PR；需 git 仓库
/branch [name]	在当前对话点创建分支以尝试另一方向，原对话可经 /resume 返回
/btw [question]	提一个不计入对话历史的侧问题；无参数时显示上一条侧问题
/bug [report]	报告 bug 或分享对话，可选择包含多少会话历史（别名 /share）
/cd <path>	把当前会话移动到新工作目录，保留对话
/chrome	配置 Claude in Chrome 设置
/claude-api [migrate|upgrade|managed-agents-onboard|prompt-audit|cost-optimize|build-eval|hillclimb]	[Skill] 载入 Claude API / Managed Agents 参考资料；子命令含迁移、升级、审计、成本优化、建 eval 等
/clear [name]	开始空上下文的对话；名称用于在 /resume 中标注上一对话（别名 /reset、/new）
/code-review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path]	[Skill] 审查当前 diff 或指定 PR / 分支 / 路径的正确性 bug；--fix 应用修复，--comment 发到 PR/MR，ultra 走深度云审查。别名 /review
/color [color|default]	设置当前会话的提示栏颜色：red、blue、green、yellow、purple、orange、pink、cyan；default 重置，无参数随机
/compact [instructions]	摘要当前对话以释放上下文；可传聚焦指令
/config [key=value ...]	打开设置界面，或直接以 key=value 设置（如 /config theme=dark）。别名 /settings
/context [all]	以彩色网格可视化上下文占用，附优化建议与容量警告；all 展开逐项明细
/copy [N]	复制最近一条助手回复；N 复制倒数第 N 条；有代码块时提供交互选择，按 w 写入文件
/cost	/usage 的别名
/dataviz [request]	[Skill] 图表 / 仪表盘设计指导：选图表类型、按角色配色、校验色盲安全与对比度
/debug [description]	[Skill] 为当前会话启用调试日志，并通过读取会话调试日志排查问题
/deep-research <question>	[Workflow] 对一个问题的网页搜索展开、抓取与交叉核对，产出带引用的报告
/design [brief]	[Skill] 把 UI 稿、流程、落地页或海报画成一张画布上的 artboard，作为 Design artifact 发布
/design-login	用 claude.ai 账号授权 /design-sync 的设计系统访问
/design-sync [hint]	[Skill] 把仓库的 React 设计系统转换并上传到 Claude Design，让设计使用真实组件
/desktop	在 Claude Code Desktop App 中继续当前会话；需 macOS / x64 Windows + Claude 订阅。别名 /app
/diff	查看工作区改动，包括 Claude 已做的编辑
/doctor	[Skill] 运行安装 / 配置体检并可修复问题；先报告发现再询问。别名 /checkup
/effort [level|auto|status]	设置推理强度：low–xhigh、max、ultracode 或 auto；status 打印当前值
/exit	退出 CLI；在已挂接的后台会话中则脱离而不停止。别名 /quit
/export [filename]	把当前对话导出为纯文本；带文件名直接写入，否则弹窗复制 / 保存
/fast [on|off]	开关 fast 模式
/feedback [report]	发送关于 Claude Code 的产品反馈，与 /bug 同一对话框与同意步骤
/fewer-permission-prompts	[Skill] 扫描 transcript 中常见只读 Bash / MCP 调用，向项目 .claude/settings.json 添加优先白名单以减少提示
/focus	切换聚焦视图：只显示最后一次提示、一行工具调用摘要与最终回复。仅 fullscreen 渲染可用
/fork [prompt]	把当前对话复制到新的后台会话并在此继续；prompt 会立即启动副本
/goal [condition|clear]	设定目标；Claude 跨轮持续推进直到满足或清除
/heapdump	把 JS heap 快照与内存分解写到桌面，用于诊断高内存；不在菜单中显示，需完整输入，且勿分享该文件
/help	显示帮助与可用命令
/hooks	查看工具事件的 hook 配置
/ide	管理 IDE 集成并显示状态
/import [codex|gemini|cursor] [--dry-run] [--yes]	从 Codex、Gemini CLI 或 Cursor 导入配置（指令文件、MCP、命令、subagents、skills）
/init	初始化项目，生成 CLAUDE.md 指南；可选交互流程覆盖 skills、hooks 与个人记忆
/insights	生成分析本机近期会话的 HTML 报告：项目、使用模式、失败点与可尝试功能
/install-github-app	为仓库安装 Claude GitHub App，可选配置 GitHub Actions 工作流与 secrets；仅支持 github.com
/install-slack-app	安装 Claude Slack App，打开浏览器完成 OAuth
/keybindings	打开键盘快捷键文件
/list-agents	列出 Claude 可以发消息的 subagents、团队成员与其它会话及其名称。别名 /peers
/login	登录 Anthropic 账号
/logout	退出 Anthropic 账号
/loop [interval] [prompt]	[Skill] 在会话保持打开时重复运行某提示；省略 interval 由 Claude 自定节奏。别名 /proactive
/mcp [reconnect <server>|enable|disable [<server>|all]]	管理 MCP 服务器连接与 OAuth；无参数打开交互列表，-p 模式下打印文本摘要
/memory	编辑 CLAUDE.md、开关 auto memory 并查看其条目
/mobile	显示下载 Claude 移动 App 的二维码。别名 /ios、/android
/model [model]	切换模型并保存为新会话默认；无参数打开选择器，按 s 仅切换当前会话
/output-style [style]	列出或切换输出风格，如 /output-style concise
/passes	分享一周免费 Claude Code 给朋友（仅符合资格的账号可见）
/permissions	通过交互对话框管理 allow / ask / deny 权限规则、工作目录与 auto mode 拒绝记录。别名 /allowed-tools
/plan [description]	直接从提示进入 plan 模式；可附带描述立即开始该任务
/plugin [subcommand]	管理插件；无参数打开插件菜单，可传 list、install、enable、disable
/powerup	通过带动画演示的交互课程了解 Claude Code 功能
/pr-comments [PR]	已在 v2.1.91 移除；改为直接让 Claude 查看 PR 评论
/privacy-settings	查看与更新隐私设置（仅 Pro / Max 订阅者）
/radio	在浏览器打开 Claude FM lo-fi 电台；无浏览器时打印流地址
/rate-limit-options	当 claude.ai 用量上限阻止请求时，显示继续工作的方式（等待重置、购买额度、升级）
/recap	按需生成当前会话的一行摘要
/release-notes	在交互版本选择器中查看 changelog
/reload-plugins [--force]	重新加载所有活跃插件以应用待生效改动，无需重启；会报告各组件计数与加载错误
/reload-skills	重新扫描 skill 与命令目录，使会话中新增 / 修改的 skill 立即可用
/remote-control	让当前会话可从 claude.ai 远程控制。别名 /rc
/remote-env	选择从 CLI 启动云端会话时的默认云环境
/rename [name]	重命名当前会话并显示在提示栏；无名称时依据对话历史自动生成
/resume [session]	按 ID 或名称恢复对话，或打开会话选择器；后台会话标记 bg。别名 /continue
/review [...]	/code-review 的别名，审查当前 diff 或指定 PR / 分支 / 路径
/rewind	回滚对话和 / 或代码到之前的点，或从选定消息开始摘要。别名 /checkpoint、/undo
/run	[Skill] 启动并驱动你的项目应用，直观看到改动生效，而不只是测试通过
/run-skill-generator	[Skill] 教会 /run 与 /verify 如何从干净环境构建、启动并驱动你的项目
/sandbox	开关 sandbox 模式（仅支持的平台）
/schedule [description]	创建、更新、列出或运行 routines（在云端执行）。别名 /routines
/scroll-speed	交互调整鼠标滚轮滚动速度，带标尺预览；仅 fullscreen 渲染可用
/security-review	分析当前分支相对 origin 默认分支的改动，查找安全漏洞（注入、认证、数据暴露）
/setup-bedrock	通过交互向导配置 Amazon Bedrock 认证、区域与模型固定；需 CLAUDE_CODE_USE_BEDROCK=1 才在菜单显示
/setup-vertex	通过交互向导配置 Google Cloud Agent Platform 认证、项目、区域与模型固定；需 CLAUDE_CODE_USE_VERTEX=1
/simplify [target]	[Skill] 审查改动代码的清理机会并应用修复：并行运行四个审查 agent，覆盖复用、简化、效率与抽象层级
/skill-doctor	显示每个 skill 的上下文开销与使用频率，帮助找出可关闭的 skill
/skills	列出可用 skills 并可过滤；按 t 按 token 数排序，Space/Enter 切换可见性，Esc 保存退出
/stats	/usage 的别名，打开 Stats 标签
/status	打开设置的 Status 标签，显示版本、模型、账号与连通性；Claude 响应时也可运行
/statusline	配置状态栏；描述你想要的内容，或无参数时依据 shell 提示自动配置
/stickers	订购 Claude Code 贴纸
/stop	停止当前后台会话（仅在已挂接后台会话时可用），保留 transcript 与 worktree
/subtask <task>	派生一个继承完整对话的 forked subagent 处理任务，你继续工作，结果回到本对话
/tasks	查看与管理当前会话的后台工作，含已完成的 subagents。别名 /bashes
/team-onboarding	依据最近 30 天的 Claude Code 使用历史生成团队上手指南；订阅者可获分享链接
/teleport	把云端会话拉到本地终端：打开选择器后拉取分支与对话。别名 /tp
/terminal-setup	为 VS Code、Cursor、Alacritty、Zed 等安装 Shift+Enter 换行键绑定；iTerm2 下开启剪贴板访问
/theme	切换配色主题：auto、明 / 暗变体、色盲友好、ANSI 主题与自定义主题
/tui [default|fullscreen]	设置终端 UI 渲染器并带着对话重启进入；无参数打印当前渲染器
/ultraplan <prompt>	已移除；改用 plan 模式
/ultrareview [PR or branch]	在云端沙箱运行深度多 agent 代码审查；推荐用 /code-review ultra
/update-config [request]	[Skill] 描述一个设置改动（允许命令、设环境变量、加 hook），Claude 编辑匹配的 settings.json
/upgrade	在浏览器打开升级页面以切换到更高计划层级
/usage	显示会话花费、计划用量上限与活动统计。别名 /cost、/stats
/usage-credits	达到上限时配置用量额度或向管理员申请；原名 /extra-usage
/verify	[Skill] 通过构建并运行项目来确认代码改动确实生效，而非依赖测试或类型检查
/vim	已在 v2.1.92 移除；改用 /config → Editor mode 切换 Vim 与普通编辑模式
/voice [hold|tap|off]	开关语音听写或指定模式；需 Claude.ai 账号
/web-setup	使用本地 gh CLI 凭据为云端会话连接 GitHub 账号
/workflow-authoring	[Skill] 载入编写动态工作流脚本的参考：脚本 API、恢复行为、质量模式与示例
/workflows	打开工作流进度视图，查看、暂停、恢复或保存运行中与已完成的工作流

[!TIP] 输入命令后按 Tab 可补全；命令菜单匹配会忽略 :、_、-，部分命令（如 /heapdump）不在菜单显示，需完整输入。

---

交互模式快捷键

[!NOTE] 快捷键可能因平台与终端而异。macOS 上使用 Option/Alt 的组合键需在终端中将 Option 配置为 Meta。

通用控制

快捷键	说明
Ctrl+C	中断当前操作；无操作时第一次清空输入，第二次退出
Ctrl+D	退出会话；第一次显示确认提示，800ms 内第二次退出。输入框有文本时删除光标后字符
Ctrl+G / Ctrl+X Ctrl+E	在默认文本编辑器中编辑提示或自定义回复
Ctrl+L	全屏重绘，保留输入与对话历史
Ctrl+O	切换 transcript 视图，显示详细工具调用与执行过程
Ctrl+R	反向搜索命令历史
Ctrl+V / Cmd+V（iTerm2）/ Alt+V（Windows、WSL）	从剪贴板粘贴图片，光标处插入 [Image #N]
Ctrl+B	把运行的 Bash 命令与 agent 转入后台（tmux 用户按两次）
Ctrl+T	开关 Claude 的任务清单
Ctrl+S	暂存 / 恢复提示
Ctrl+Z	挂起 Claude Code（仅 Unix，用 fg 恢复）
Left/Right arrows	在对话框标签间切换
Tab	接受自动补全建议；多数权限提示下为选项添加注释
Up/Down 或 Ctrl+P/Ctrl+N	移动光标或浏览命令历史
Esc	中断 Claude 或关闭对话框；权限提示下拒绝操作
Esc+Esc	输入框有文本时清空并存入历史；为空时打开 rewind 菜单
Ctrl+Enter 或 Ctrl+X Ctrl+S	立即发送已排队消息（需 v2.1.275+）
Shift+Tab（Windows 上可能是 Alt+M）	循环切换权限模式
Option+P / Alt+P	切换模型而不清空提示
Option+T / Alt+T	开关扩展思考（Opus 5.5 与 Fable 模型始终开启，无效果）
Option+O / Alt+O	开关 fast 模式

多行输入

方法	快捷键
快速转义	\ + Enter
Option 键	Option+Enter（需启用 Option as Meta）
Shift+Enter	iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal、Windows Terminal 原生支持
控制序列	Ctrl+J（任何终端可用）
粘贴模式	直接粘贴代码块或日志

快速命令

快捷键	说明
行首 /	命令或 skill
行首 !	shell 模式：直接运行命令并把输出加入会话
@	文件路径提及，触发路径自动补全
:	Emoji 短代码，输入完整的 :name: 插入 emoji
空输入时 ?	切换快捷键帮助面板

Vim 编辑器模式

通过 /config → Editor mode 启用 Vim 风格编辑。模式切换要点：

• Esc 或 Ctrl+[ 进入 NORMAL 模式
• i/I/a/A/o/O 进入 INSERT 模式
• v 字符选择、V 行选择
• 可用 vimInsertModeRemaps 把两键序列（如 jj）映射为 Escape

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

---

设置文件与优先级

Claude Code 从多个 JSON 设置文件读取配置，文件所在决定其作用范围。

范围	文件	作用对象	用途
用户	~/.claude/settings.json	你在此机器的每个项目	个人偏好：主题、编辑模式、默认模型、个人权限规则
共享项目	.claude/settings.json	包含它的目录中所有人；建议提交到 Git	团队权限、hooks、plugins、项目所需环境变量
项目本地	.claude/settings.local.json	仅你在该项目	单项目个人覆盖；Claude Code 会自动加入 Git 排除
托管	managed-settings.json、MDM、claude.ai 控制台	组织部署到的所有人	安全策略与合规要求

在 Windows 上 ~/.claude 即 %USERPROFILE%\.claude；可用 CLAUDE_CONFIG_DIR 改到别处。

优先级（从高到低）

1. 托管设置：组织部署，用户设置无法覆盖
2. 命令行：claude --settings（内联 JSON 或文件），仅本次会话
3. 项目本地：.claude/settings.local.json
4. 共享项目：.claude/settings.json
5. 用户：~/.claude/settings.json

[!IMPORTANT] 当同一个列表键（如 permissions.allow）出现在多个文件时，列表会合并而非覆盖，因此各文件都能追加条目。但少数安全敏感键会从更低层级取更严格的值。

示例

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

[!NOTE] 设置文件是严格 JSON：// 注释或尾随逗号都是语法错误。运行时用 /status 确认已加载的设置来源；用 claude doctor 查看被拒绝的条目。

会话级覆盖

# 用内联 JSON 覆盖一个键，仅本次会话
claude --settings '{"model": "claude-opus-5-5"}'

# 用文件
claude --settings ./settings.json

---

Skills 与自定义命令

Skill 用 SKILL.md（含 YAML frontmatter）定义，Claude 会在相关时自动加载，或用 /skill-name 直接调用。自定义命令已并入 skills：.claude/commands/deploy.md 与 .claude/skills/deploy/SKILL.md 都会产生 /deploy。

加载位置：

位置	路径
个人	~/.claude/skills/<name>/SKILL.md
项目	.claude/skills/<name>/SKILL.md
嵌套	<subdir>/.claude/skills/<name>/SKILL.md
插件	<plugin>/skills/<name>/SKILL.md（以 /plugin:skill 调用）

frontmatter 常用字段：

---
name: my-skill
description: What this skill does and when to use it
disable-model-invocation: true   # 禁止 Claude 自动调用，仅手动 /name
allowed-tools: Read Grep          # 本 turn 内免权限使用
context: fork                     # 在子 agent 上下文中运行
---

[!TIP] skill 正文只在其被使用时加载，所以冗长参考资料几乎不占常驻上下文；但一旦加载会跨轮留在上下文中，正文应尽量精炼。

---

常见工作流示例

用 Claude 当项目 linter

{
  "scripts": {
    "lint:claude": "git diff main | claude -p \"you are a typo linter. for each typo in this diff, report filename:line on one line and the issue on the next. return nothing else.\""
  }
}

审查暂存改动并生成提交

claude -p "Look at my staged changes and create an appropriate commit" \
  --allowedTools "Bash(git diff *),Bash(git log *),Bash(git status *),Bash(git commit *)"

自定义系统提示

gh pr diff "$1" | claude -p \
  --append-system-prompt "You are a security engineer. Review for vulnerabilities." \
  --output-format json

在 worktree 中隔离开发

claude -w feature-auth          # 在 .claude/worktrees/feature-auth 中启动
claude -w feature-auth --tmux   # 同时创建 tmux 会话

[!CAUTION] --dangerously-skip-permissions 与 bypassPermissions 会跳过所有权限检查。仅在没有人工审查、且处于隔离容器 / VM 时使用；不要把 OPENAI / Anthropic API Key 暴露给不可信代码。

---

Markdown 格式速查

以下是本文档使用的格式写法，便于你在编辑器中直接复用。

引用块

> 这是一段普通的引用块。

这是一段普通的引用块。

高亮块（GitHub Alerts）

在引用块首行加入 [!TYPE] 即可渲染为高亮块：

> [!NOTE]
> 一般性说明。

> [!TIP]
> 有用的提示。

> [!IMPORTANT]
> 关键信息。

> [!WARNING]
> 需要注意的风险。

> [!CAUTION]
> 可能造成损失的高危操作。

[!NOTE] 一般性说明。

[!TIP] 有用的提示。

[!IMPORTANT] 关键信息。

[!WARNING] 需要注意的风险。

[!CAUTION] 可能造成损失的高危操作。

其它常用格式

# 一级标题
## 二级标题

**加粗**、*斜体*、`行内代码`、~~删除线~~

- 无序列表
1. 有序列表
- [ ] 未完成任务
- [x] 已完成任务

| 列 A | 列 B |
| :-- | :-- |
| 单元格 | 单元格 |

[链接文字](https://example.com)

`<kbd>` 表示按键：<kbd>Ctrl</kbd>+<kbd>C</kbd>

```bash
echo "带语言标注的代码块"
```

---

> 行末两个空格
> 可强制换行

[!NOTE] 如果你的 Markdown 渲染器不支持 GitHub Alerts，可改用 HTML 实现高亮块，例如 <div class="callout callout-warning">...</div>，样式交给站点 CSS 控制。

---

参考来源

• CLI reference
• Commands
• Interactive mode
• Permission modes
• Settings files and precedence
• Run Claude Code programmatically
• Skills

再次提醒：Claude Code 版本更新频繁，以上命令与参数请以本机 claude --help、claude <子命令> --help 与官方最新文档为准。