claude-code/docs/outline-output/user/04-slash-commands.md

第四章：slash 命令速查 —— 不用记全部，按场景找

你想做什么？翻到这里，按场景找到对应命令。

在 Claude Code 的交互式 REPL 中，输入 / 开头的文本即可触发 slash 命令。命令很多，但不需要死记硬背——按你想做的事情找就行。如果实在不确定要哪个，直接输入 /help 会打开一个分类浏览面板，里面有所有可用命令。

会话与上下文管理

当你的对话变长、上下文快满了，或者想换个话题重新开始，这些命令帮你管好会话状态。

/clear（别名 /reset、/new）清空当前对话历史，从头开始。就像关闭再重新打开一个聊天窗口，之前的消息不会丢失到磁盘上的会话记录里，但不再参与本次对话的上下文。

你: /clear

/compact 比 /clear 更温和——它会用 AI 总结当前对话，然后清除原始消息，只保留总结。这样你可以在不丢失要点的前提下释放上下文空间。你还可以给它自定义总结指令：

你: /compact 用中文总结，保留所有文件路径和关键决策

如果 DISABLE_COMPACT 环境变量被设置，/compact 会被禁用。

/force-snip 在当前位置插入一个"剪裁边界"。下次查询时，边界之前的消息会被从模型视角移除（REPL 的滚动历史里仍然可见）。这是在 /compact 不够用时的手动干预手段。

/resume（别名 /continue）恢复之前的对话。可以传会话 ID 或搜索关键词：

你: /resume abc123
你: /continue 修复认证bug

/history（别名 /hist）查看会话历史列表。

/context 可视化当前上下文使用情况——显示一个彩色网格，直观展示上下文窗口里各部分占用了多少空间。非交互模式下会以文本形式展示。

/rewind（别名 /checkpoint）将代码和/或对话恢复到之前的某个节点。

模型与 Provider 切换

想换一家 API、换一个模型、或者调整思考强度，用这几个命令。

/provider（别名 /api）切换 API 提供商。支持 7 个 provider：anthropic、openai、gemini、grok、bedrock、vertex、foundry。不带参数时显示当前 provider，unset 清除设置回退到环境变量：

你: /provider gemini
你: /provider unset
你: /provider
> Current API provider: anthropic

注意：bedrock、vertex、foundry 通过环境变量控制（CLAUDE_CODE_USE_BEDROCK=1 等），不会写入 settings.json。切换到 openai、gemini、grok 时会检查对应的 API key 是否已配置，如果缺失会给出警告。

/model 切换模型。不带参数时显示当前模型及描述，带参数时设置新模型。模型名通常形如 claude-sonnet-4、claude-opus-4 等：

你: /model claude-opus-4
你: /model

/effort 设置思考强度，影响模型在推理上的投入程度。支持 low、medium、high、xhigh、max、auto 几档：

你: /effort high

/login 通过引导式流程登录 Anthropic 账号。如果已登录则显示为"切换账号"。设置 DISABLE_LOGIN_COMMAND=1 可禁用此命令。

/logout 退出当前账号登录状态。设置 DISABLE_LOGOUT_COMMAND=1 可禁用此命令。

费用、用量与限流

想知道花了多少钱、用了多少 token、遇到限流怎么办，看这里。

/usage（别名 /cost、/stats）显示会话费用、套餐用量和活动统计。三个名字指向同一个命令，用哪个都行：

你: /usage
你: /cost
你: /stats

/rate-limit-options 当你撞到 API 限流时，这个命令会弹出一个菜单，提供几个选项：申请额外用量（extra usage）、升级套餐（upgrade plan）、或等待限流重置。具体可用的选项取决于你的订阅类型——Team/Enterprise 用户看到的是"申请更多"，Max 20x 用户看不到升级选项。

/reset-limits 重置限流状态。注意：当前版本此命令是一个 stub（占位），功能尚未实现。

如果你使用的是 OpenAI 兼容层，限流追踪是通过响应头 x-ratelimit-*-requests/x-ratelimit-*-tokens 和 Reset-After 自动完成的，不需要手动干预。

/perf-issue 生成一份性能快照报告，包含内存占用、CPU 使用、token 消耗、工具调用次数、缓存命中率、费用估算等信息。默认以 Markdown 格式写入 ~/.claude/perf-reports/ 目录：

你: /perf-issue
> Perf snapshot written to:
>   `~/.claude/perf-reports/perf-2026-06-14T10-30-00-abc12345.md`

你: /perf-issue --format=json --limit=5000

配置与个性化

让 Claude Code 按你的习惯工作——主题、语言、快捷键、配置面板。

/config（别名 /settings）打开配置面板，可以集中管理各种设置项。

/theme 切换终端界面主题。会弹出可选主题列表供你选择。

/lang 设置显示语言，支持 en、zh、auto（自动检测）：

你: /lang zh
你: /lang auto

/keybindings 打开或创建你的快捷键配置文件 ~/.claude/keybindings.json。需要 isKeybindingCustomizationEnabled() 返回 true 才可用。

/env 显示当前环境信息快照，包括运行时信息（平台、CWD、PID、Bun/Node 版本、session ID）和关键环境变量。敏感值（匹配 token/password/auth/api_key 等关键词的）会被自动遮掩。只显示 CLAUDE_*、FEATURE_*、ANTHROPIC_*、BUN_*、NODE_*、GEMINI_*、OPENAI_*、GROK_* 等前缀的环境变量：

你: /env
> ## Runtime
>   platform:        darwin arm64
>   cwd:             /Users/you/project
>   pid:             12345
>   bun:             1.2.0
> ## Environment Variables (allowlisted prefixes)
>   ANTHROPIC_API_KEY=sk-a…d2 (38 chars)
>   ...

/output-style 修改输出风格。已标记为 deprecated（不推荐使用），建议改用 /config 来调整。

/mode 切换交互模式，支持多种预设：default、gentle、sharp、workhorse、token-saver、super-ai：

你: /mode token-saver

项目与文件操作

让 Claude 关注特定的目录、查看文件列表和变更差异。

/add-dir 将一个新目录添加到 Claude Code 的工作范围内：

你: /add-dir /path/to/another/project

/diff 查看未提交的代码变更和每轮对话中的 diff。会以交互式界面展示。

/files 列出当前上下文中包含的所有文件。注意：此命令仅对 Anthropic 内部用户可用（USER_TYPE=ant）。

/context 和 /ctx_viz 都用于可视化上下文使用。/context 是主要命令，在交互模式下显示彩色网格，非交互模式下显示文本摘要。/ctx_viz 当前是 stub（禁用状态）。

插件、Skill 与扩展

当内置功能不够用，想装插件、浏览技能市场或管理 Skill。

/plugin（别名 /plugins、/marketplace）管理 Claude Code 插件——浏览、安装、启用、禁用、卸载。可以进入插件市场（Marketplace）浏览社区贡献的插件。

你: /plugin
你: /plugins
你: /marketplace

/skills 列出当前可用的所有 Skill。Skill 是一种可复用的工作流单元。

/skill-store（别名 /ss、/cloud-skills）浏览和安装远程技能市场中的 Skill。需要 Claude Pro/Max/Team 订阅。支持 list、get、versions、install 等子命令：

你: /skill-store list
你: /skill-store get my-skill-id
你: /skill-store install my-skill-id@1.0

/reload-plugins 激活待定的插件变更到当前会话。当你安装或更新了插件后，需要执行此命令让改动生效（SDK 调用方通常通过 query.reloadPlugins() 来触发）。

/hooks 查看和管理工具事件的钩子配置。在 settings.json 中配置的 hooks 会在特定工具事件发生时自动执行脚本。

工作流自动化

把日常重复操作固化为可重放的工作流。

/commit 让 Claude 帮你生成 git commit。它只被允许执行 git add、git status、git commit 三个命令，会分析你的变更后生成合适的 commit message 并提交。

你: /commit

/commit-push-pr 一条龙完成 commit、push 和创建 PR。Claude 会自动创建分支、提交代码、推送并在 GitHub 上创建 Pull Request。

/review 让 Claude 审查一个 Pull Request。不带参数时会列出所有开放的 PR，带 PR 编号时直接审查指定 PR：

你: /review
你: /review 42

还有 /ultrareview 命令，它会在 Claude Code on the web 上运行一个更深入的 bug 搜索和验证流程，大约需要 10-20 分钟。

/plan 进入 Plan 模式或查看当前计划。先想清楚再动手：

你: /plan 重构认证模块，将 JWT 逻辑抽到独立 service
你: /plan open

/triggers（别名 /cron）管理云端定时触发的远程代理任务（cloud cron）。需要 Claude Pro/Max/Team 订阅。支持创建、查看、更新、删除、运行、启用、禁用等操作：

你: /triggers list
你: /triggers create "*/30 * * * *" "检查 deploy 状态"
你: /triggers run trigger-123

注意：命令名叫 /triggers（对应底层 API endpoint /v1/code/triggers），别名 /cron。

/goal 设置一个持续性目标，Claude 会跨轮次自动推进。支持 status、clear、pause、resume、complete 等子命令：

你: /goal 完成 login 模块的单元测试覆盖
你: /goal status
你: /goal complete

/workflows 打开工作流监控面板，实时显示运行中的 workflow 的 run/phase/agent 进度。

权限与安全

管理工具权限、沙箱模式，控制 Claude 能做什么。

/permissions（别名 /allowed-tools）管理工具的 allow/deny 权限规则。可以精细控制哪些工具被允许自动执行，哪些需要每次确认。

/sandbox 切换沙箱模式。沙箱模式下，shell 命令会被限制在一个隔离环境中执行，防止意外修改系统文件。支持配置排除模式——某些命令可以不经沙箱直接执行：

你: /sandbox
> (sandbox enabled, 可配置 exclude 规则)

注意：此命令仅在支持的平台上显示，且需要平台在启用列表中。

/poor 切换穷鬼模式——关闭 extract_memories 和 prompt_suggestion 两个功能来节省 token 消耗。设置会持久化到 settings.json：

你: /poor
> Poor mode enabled — extract_memories and prompt_suggestion disabled.

记忆与会话输出

管理 Claude 的记忆文件、导出和分享会话。

/memory 编辑 Claude 的记忆文件（CLAUDE.md 等）。会打开一个编辑界面让你查看和修改 Claude 对你项目的长期记忆。

/summary 手动触发一次会话摘要生成。通常会自动在满足条件时提取，但你可以随时用这个命令主动生成：

你: /summary
> Session summary updated.
> [摘要内容]

/export 将当前对话导出到文件或剪贴板：

你: /export conversation-backup.md

/share 将当前会话日志上传到 GitHub Gist，方便分享给同事或提交 issue。支持多个标志来控制分享方式：

你: /share --private --mask-secrets
你: /share --public --summary-only
你: /share --mask-secrets --allow-public-fallback

可选标志：

• --public：创建公开 Gist（默认 --private）
• --mask-secrets：上传前遮掩 API key、token 等敏感信息
• --summary-only：只上传摘要（每轮截取前 200 字符）
• --allow-public-fallback：如果 gh gist 失败，回退到 0x0.st

注意：需要安装 gh CLI 工具并已登录。

诊断与帮助

遇到问题或需要了解系统状态时。

/help 打开帮助面板。面板有三个标签页：general（通用快捷键和用法）、commands（所有内置命令）、custom-commands（自定义命令）。设置 DISABLE_DOCTOR_COMMAND=1 可禁用。

你: /help

/doctor 诊断和验证你的 Claude Code 安装及配置是否正确。遇到莫名其妙的问题时，先跑这个：

你: /doctor

/status 显示 Claude Code 的综合状态信息：版本号、当前模型、账号信息、API 连通性、工具状态等。

/version 只显示当前运行的版本号和构建时间：

你: /version
> 2.7.0 (built 2026-06-14T08:00:00Z)

/feedback（别名 /bug）提交关于 Claude Code 的反馈。注意：在 Bedrock、Vertex、Foundry 或隐私模式下此命令不可用。

下一步

• 想了解 MCP Server、插件和 Skill 的详细用法，看 第五章：扩展 Claude 的能力
• 想在 CI 或脚本中无交互调用 Claude，看 第十一章：自动化与 CI 集成
• 遇到报错或卡住，看 第十章：可观测性与排错