按当前 Claude Code CLI(约 2.1.233)整理。不同版本、插件和 skills 提供的指令可能不同,在会话中输入 /help 可以查看当前环境实际支持的列表。
官方文档
- Claude Code 概览 · EN
- 安装与设置 · EN
- CLI 参考 · EN
- 交互指令 / Commands · EN
- 权限模式 · EN
- 沙盒 · EN
- 设置 · EN
- 记忆 / CLAUDE.md · EN
- MCP · EN
- Hooks · EN
- GitHub 仓库
安装优先官方 native / Homebrew / WinGet;npm install -g @anthropic-ai/claude-code 仍可用,但已标记为 deprecated。
Slash Commands
会话管理
/help查看当前版本可用的指令。
/clear清空当前上下文并开始新会话;旧会话仍可 /resume。/reset、/new 是别名。
/compact [说明]压缩上下文,可附加需要保留内容的说明。
/rewind回滚到之前的 checkpoint;快捷键常见为 Esc Esc。
/resume [会话 ID 或关键词]恢复历史会话;/continue 是别名。
/branch [名称]从当前会话点创建分支,继续在分支里工作。
/fork [提示]把当前对话拷到后台新会话,自己继续在当前会话工作。旧版“会话内 fork”行为见 /subtask。
/subtask [提示]在当前会话内拉起带完整上下文的子任务 agent。
/rename [名称]重命名当前会话。
/export [文件名]导出当前对话。
/copy [N]复制最近第 N 条回答;省略 N 则复制最近一条。
/background [提示]把当前会话转到后台,腾出终端;也可用 claude --bg 启动。
/exit退出 Claude Code;/quit 是别名。
上下文与记忆
/context [all]查看上下文占用。
/usage查看账号用量和限额。
/usage-credits配置或申请额外用量额度(Team / Enterprise 等);旧名 /extra-usage。
/memory查看或编辑 CLAUDE.md 与记忆设置。
/recap生成当前会话摘要。
/btw <问题>发起不进入主线的侧边提问。
/goal [条件 | clear]设置结束前必须满足的目标,或清除目标。
/brief切换 brief-only 简洁输出模式。
模型、模式与配置
/model查看或切换模型(如 opus、sonnet、fable 或完整模型 ID)。
/effort调整推理强度:low / medium / high / xhigh / max。
/fast切换 Fast 模式(适用于支持的 Opus 型号)。
/plan [任务]进入 Plan Mode,或查看当前计划。
/permissions查看和管理工具权限规则。
/config打开配置;/settings 是别名。
/status查看模型、账号和运行状态。
/advisor [模型 | off]设置或关闭 advisor(在关键步骤咨询更强模型)。
/keybindings打开键盘快捷键配置。
/theme切换主题。
/color设置本会话提示条颜色。
/vim切换 Vim 输入模式。
/tui切换或重启终端 UI 渲染。
项目与扩展
/init为当前项目生成初版 CLAUDE.md。
/add-dir <路径>添加额外的工作目录访问权限。
/cd <路径>切换当前会话工作目录。
/sandbox打开 Bash 沙盒设置并切换运行模式。
/mcp查看和管理 MCP 服务器。
/hooks查看 hooks。
/skills查看可用 skills;skills 也可直接用 /skill-name 调用。
/plugin管理插件与 marketplace。
/reload-plugins在当前会话激活待处理的插件变更。
/reload-skills重新加载磁盘上新增或修改的 skills。
/agents打开后台 agent / 会话管理界面。自定义 subagent 定义在 .claude/agents/。
/tasks查看后台任务。
/import从其他 AI coding agent(如 Codex、Gemini)导入配置。
/chrome打开 Claude in Chrome 相关设置。
/ide管理 IDE 集成并查看状态。
Diff 与审查
/diff查看当前工作区代码差异。
/code-review [级别] [PR]本地多 agent 审查当前改动或指定 PR。级别可记在会话里复用。
/review [PR]/code-review 的别名;裸 /review <pr> 也可能走快速单次审查。
/ultrareview [目标]云端多 agent 审查当前分支,或指定 PR / base branch。
/security-review对当前分支未提交改动做安全审查(bundled skill)。
部分审查/质量类能力来自 skills 或插件,例如 code-simplifier、commit-commands 等,以 /skills、/plugin 和 /help 为准。
云端、远程与诊断
/teleport [会话]将会话送到云端,或从 claude.ai 恢复云端会话到本地。
/remote-control开启 Remote Control,便于网页 / 手机 / 桌面接入。
/remote-env选择云端 agent 的默认运行环境。
/batch <任务>拆分大规模改动,并在多个隔离 worktree agent 中并行执行。
/loop循环执行提示或 slash command。
/login登录账号。
/logout退出登录。
/doctor检查安装和运行环境;/checkup 是别名。
/debug诊断运行问题。
/feedback提交反馈;/bug 是别名。
/stats查看使用统计。
/version显示当前会话正在运行的版本。
/upgrade查看升级方案(更高额度等)。
CLI 启动与恢复
claude在当前目录启动交互会话。
claude "<任务>"带初始任务启动交互会话。
claude -p "<任务>"非交互执行任务,输出结果后退出。
cat <文件> | claude -p "<任务>"将文件内容通过标准输入交给 Claude。
claude -c继续当前目录最近一次会话。
claude -c -p "<任务>"接着最近一次会话非交互执行。
claude -r "<会话 ID>" "<任务>"按会话 ID 恢复并继续任务;省略 ID 可打开选择器。
claude --bg "<任务>"以后台 agent 启动,立即返回;用 claude agents 管理。
claude -w [名称]为本次会话创建 git worktree。
claude --model opus --effort high指定模型和推理强度启动。
claude --bare -p "<任务>"最小模式:跳过 hooks、插件同步、自动记忆、CLAUDE.md 发现等。
claude --safe-mode禁用自定义配置(CLAUDE.md、skills、plugins、hooks、MCP 等),便于排查坏配置。
权限与沙盒
Claude Code 的“权限模式”和“Bash 沙盒”是两层独立机制:权限模式决定工具调用是否需要确认,沙盒决定 Bash 命令能访问哪些文件和网络资源。
当前 --permission-mode 可选:
| 模式 | 含义 |
|---|---|
manual | 默认取向:按规则询问(历史里也常写作 default) |
plan | 只读规划,不直接改代码 |
acceptEdits | 自动接受文件编辑,其他仍按规则 |
auto | 由自动分类器决定是否放行 |
dontAsk | 尽量不再询问 |
bypassPermissions | 跳过权限提示 |
claude --permission-mode plan以只读的 Plan Mode 启动。
claude --permission-mode acceptEdits自动接受文件编辑,其他操作仍按权限规则处理。
claude --permission-mode auto启用自动权限分类。
claude --dangerously-skip-permissions以 bypassPermissions 模式启动,跳过权限提示和大部分安全检查。
claude --permission-mode plan --allow-dangerously-skip-permissions先以 Plan Mode 启动,并允许稍后通过 Shift+Tab 切到权限绕过模式。
Claude Code 的 Bash 沙盒默认关闭。如果此前通过 /sandbox 或配置开启过,可以在项目的 .claude/settings.local.json 或用户级 ~/.claude/settings.json 中明确关闭:
{ "sandbox": { "enabled": false }}仅关闭沙盒并不会自动跳过工具权限提示。若要让 Claude Code 既在沙盒外运行又不再询问,可以在关闭沙盒后使用:
claude --dangerously-skip-permissionsCAUTION权限绕过模式会让工具直接操作宿主机文件、凭据和网络。官方建议只在无敏感数据、最好无外网的一次性容器或虚拟机中使用;不要以
root或sudo身份启动。
安装、登录与诊断
# macOS / Linux 推荐curl -fsSL https://claude.ai/install.sh | bash官方 native 安装。
# Windows 推荐irm https://claude.ai/install.ps1 | iex官方 native 安装。
brew install --cask claude-codeHomebrew 安装。
winget install Anthropic.ClaudeCodeWinGet 安装。
claude update更新 Claude Code。
claude install [版本]安装或重装 native 构建;版本可以是 stable、latest 或具体号。
claude auth login登录账号。
claude auth status查看登录状态。
claude auth logout退出登录。
claude doctor检查安装健康状态。
claude --help查看 CLI 参数。
后台任务、插件与 MCP
claude agents查看和管理后台 agent。
claude attach <ID>在当前终端接入后台会话。
claude logs <ID>查看后台会话日志。
claude daemon status查看 supervisor 状态。
claude daemon stop --any停止 supervisor。
claude mcp配置 MCP 服务器。
claude plugin管理插件与 marketplace。
claude import codex从 Codex 等其他 agent 导入配置。
claude ultrareview对当前分支跑云端多 agent code review。
常用配置位置:
| 路径 | 用途 |
|---|---|
~/.claude/settings.json | 用户设置 |
.claude/settings.json | 项目设置 |
.claude/settings.local.json | 本机项目设置 |
CLAUDE.md / .claude/CLAUDE.md | 项目说明 |
.claude/commands/ | 自定义 slash commands |
.claude/skills/ | Skills |
.claude/agents/ | 自定义 agents |
.mcp.json | 项目 MCP(需批准) |