附录 A
附录 A:命令参考
本参考涵盖与 PM 工作流相关的 Claude Code 命令和选项。在任何会话中运行 /help 查看完整的最新列表——Claude Code 会定期添加功能。
每次会话都会用到的命令
你在会话中键入的命令。所有命令以 / 开头。
会话管理
| 命令 | 用途 |
|---|---|
| /help | 显示所有可用命令,包括项目中的自定义命令 |
| /status | 显示当前会话状态:权限模式、上下文使用、模型、认证方法 |
| /cost | 显示 token 消耗和估计会话成本 |
| /clear | 重置对话并在同一目录中重新开始 |
| /compact [focus] | 汇总上下文以减少 token。可选:指定要保留的内容 |
| /exit | 结束会话 |
上下文与内存
| 命令 | 用途 |
|---|---|
| /init | 使用文档模板创建新的 CLAUDE.md 文件 |
| /memory | 查看或编辑项目的 CLAUDE.md 文件 |
| /context | 显示当前上下文窗口使用情况和剩余容量 |
| /resume [id] | 继续之前的会话。省略 ID 查看最近的会话 |
配置
| 命令 | 用途 |
|---|---|
| /config | 打开 Claude Code 偏好设置界面 |
| /permissions | 管理工具权限和确认提示 |
| /model | 为当前会话切换 Claude 模型(Sonnet、Opus、Haiku) |
| /login | 使用你的 Claude 账户认证 |
| /logout | 从当前会话登出 |
集成
| 命令 | 用途 |
|---|---|
| /mcp | 配置 Model Context Protocol 服务器 |
| /agents | 创建和管理带有专门提示词的 subagent |
| /b ashes | 列出和管理后台 shell 进程 |
工具
| 命令 | 用途 |
|---|---|
| /doctor | 对你的安装运行诊断健康检查 |
| /terminal-setup | 安装 Shift+Enter 快捷键用于多行输入(macOS) |
| /vim | 切换 Vim 编辑模式 |
| /release-notes | 查看最近的 Claude Code 更新 |
| /bug | 报告 bug(将对话发送给 Anthropic) |
带选项启动 Claude Code
从终端启动 Claude Code 时的选项:claude [flags] [query]
权限控制
| 标志 | 示例 | 用途 |
|---|---|---|
| --permission-mode | claude --permission-mode plan | 设置初始模式。选项:default、plan、acceptEdits、bypassPermissions |
| --dangerously-skip-permissions | (谨慎使用) | 绕过所有权限提示。仅限受信任环境 |
| --allowedTools | claude --allowedTools "Bash(git:*)" | 指定不需要提示的工具 |
| --disallowedTools | claude --disallowedTools "Bash(rm:*)" | 明确拒绝特定工具 |
会话选项
| 标志 | 示例 | 用途 |
|---|---|---|
| --continue 或 -c | claude -c | 继续最近的会话 |
| --resume | claude --resume abc123 | 按 ID 恢复特定会话 |
| --add-dir | claude --add-dir /path/to/repo | 将目录添加到允许路径 |
| --model | claude --model opus | 选择 Claude 模型(别名:sonnet、opus) |
| --print 或 -p | claude -p "query" | 运行一次查询并退出(用于脚本) |
系统提示
| 标志 | 示例 | 用途 |
|---|---|---|
| --append-system-prompt | claude --append-system-prompt "Focus on..." | 将指令添加到默认提示(推荐) |
| --system-prompt | claude --system-prompt "You are..." | 替换整个系统提示 |
| --system-prompt-file | claude --system-prompt-file ./prompt.txt | 从文件加载系统提示 |
帮助
| 标志 | 用途 |
|---|---|
| --help | 显示 CLI 使用信息 |
| --version | 显示已安装的版本号 |
控制 Claude Code 的自主性
通过 --permission-mode 标志设置,或在会话中使用 Shift+Tab 循环切换。
| 模式 | 行为 | PM 用例 |
|---|---|---|
| plan | 只读。不修改文件,不执行命令。启用扩展思考。 | 代码库调查、bug 分类、架构审查 |
| default | 所有修改和命令前都提示。最大控制。 | 学习 Claude Code、敏感工作 |
| acceptEdits | 自动批准文件编辑。仍然对 shell 命令提示。 | 生成文档、创建 skill、更新 CLAUDE.md |
| bypassPermissions | 跳过所有提示。需要 --dangerously-skip-permissions 标志。 | PM 工作很少需要 |
建议:在 ~/.claude/settings.json 中将 plan 设置为你的默认模式。当需要文件输出时切换到 acceptEdits。
更快的导航和控制
模式控制
| 快捷键 | 功能 |
|---|---|
| Shift+Tab | 循环切换权限模式:default → acceptEdits → plan |
| Tab | 切换扩展思考(逐步推理) |
| Esc Esc | 回退:撤销最近的更改或对话轮次 |
输入与导航
| 快捷键 | 功能 |
|---|---|
| Shift+Enter | 换行而不发送(macOS 需要 /terminal-setup) |
| Ctrl+C | 中断当前操作 |
| Ctrl+D | 退出 CLI |
| Ctrl+L | 清屏 |
| Ctrl+O | 切换详细模式(显示扩展思考输出) |
特殊输入前缀
| 前缀 | 功能 | 示例 |
|---|---|---|
| # | 添加注释到 CLAUDE.md | # Auth uses JWT tokens |
| @ | 文件路径自动补全 | @src/components/ |
| / | 斜杠命令 | /cost |
设置文件位置
| 位置 | 范围 | 用途 |
|---|---|---|
| ~/.claude/settings.json | 所有项目 | 全局偏好、默认模式 |
| .claude/settings.json | 项目(共享) | 团队设置,提交到 git |
| .claude/settings.local.json | 项目(个人) | 本地覆盖,gitignored |
设置默认模式
创建或编辑 ~/.claude/settings.json:
{
"defaultMode": "plan"
}
自定义斜杠命令
在 .claude/commands/(项目)或 ~/.claude/commands/(个人)中创建 Markdown 文件来添加自定义斜杠命令。
功能:
- $1、$2、$@ 用于位置参数
- !command 前缀用于嵌入 bash 输出
- 子目录创建命名空间命令(例如 pm/feedback.md 变为 /pm:feedback)
示例:.claude/commands/investigate.md
Investigate how $1 works in this codebase. Focus on:
- User-facing behavior
- Data flow
- Key decision points
Summarize in terms a product manager would use.
用法:/investigate authentication
快速参考卡片
安全启动:claude --permission-mode plan
检查成本:/cost
减少上下文:/compact
查看可用内容:/help
循环切换模式:Shift+Tab
退出:/exit
命令和选项截至出版时是最新的。运行 /help 和 claude --help 查看你已安装版本的权威列表。