直接答案
按使用场景组织常用命令,并解释交互命令与 shell 参数之间的边界。
这篇内容解决什么问题
让开发者快速找到可复制的 Claude Code 命令,同时避免把交互命令误当作 shell 命令。
区分交互启动与一次性调用
直接运行 claude 会打开持续会话,适合探索、修改和多轮反馈。给启动命令附带提示词可以直接进入具体任务;-p 则以非交互模式打印结果,适合脚本和 CI。
自动化前先在交互模式验证提示词和权限。非交互运行没有人及时纠偏,任务边界与允许工具必须更严格。
claudeclaude "解释这个仓库的测试结构,不要修改文件"claude -p "列出 src 下的公开 API 入口"会话内先掌握这些斜杠命令
斜杠命令需要在 Claude Code 交互界面输入,而不是直接交给 shell。/help 查看当前版本命令,/status 检查模型与认证,/context 查看上下文来源,/permissions 管理权限。
命令集合会随版本变化。教程应把 /help 作为当前安装的权威入口,不应把静态命令清单写成永久不变的协议。
/help
/status
/context
/permissions
/model继续、选择或命名会话
claude --continue 继续当前目录中最近一次会话,claude --resume 默认从当前 worktree 范围打开会话选择器,并可在选择器中扩展到其他项目。复杂任务应在会话内用 /rename 赋予可搜索名称。
恢复会话会恢复对话和相关状态,但当前工作树可能已经变化。继续之前先让 Claude 重新检查 Git 状态和关键文件。
claude --continue
claude --resume在脚本中使用 JSON 或流式 JSON
非交互模式支持纯文本、JSON 与流式 JSON。单个 JSON 对象适合等待最终结果后解析;stream-json 适合实时消费事件,并需要 verbose 输出。
机器解析时不要从自然语言中用正则猜字段。应选择结构化输出,并在下游校验必需字段和退出状态。
claude -p "列出所有 API 路由" --output-format jsonclaude -p "分析构建日志" --output-format stream-json --verbose为批处理限定工具与权限模式
批量调用应尽量只开放完成任务所需的工具。--tools 决定可用的内置工具;--allowedTools 只表示匹配工具可以免询问调用,并不会隐藏其他工具。完全不需要工具的管道任务可传空的 --tools。
--safe-mode 适合使用现有订阅/OAuth 登录的隔离审查。更严格的 --bare 不读取 OAuth 或 keychain,只适用于显式提供 ANTHROPIC_API_KEY 或 apiKeyHelper 的环境。
先用两三个样本校准提示词、权限和输出,再扩大批量规模。并行处理会增加成本,也可能在同一工作树产生冲突,编辑任务更适合配合独立 worktree。
git diff | claude --safe-mode -p "审查以下 diff 的逻辑回归,只返回发现" --tools ""用内置诊断替代盲目重装
claude doctor 从 shell 检查安装和设置;claude --debug-file <path> 把更详细的启动、MCP 或 gateway 诊断写入指定文件。单独使用 --debug 时,默认日志位于 ~/.claude/debug/<session-id>.txt。
排查时一次只改变一个变量,并保留完整错误文本。模型错误、认证错误和网络错误的修复路径不同。
claude --version
claude doctor
claude --debug-file /tmp/claude-debug.log官方来源与核验范围
本文以公开官方文档为事实依据;命令和配置可能随客户端版本变化,执行前请同时核对对应来源。
查看技术核验方法