CLI 与会话操作速查

01日常会话

claude 在当前目录启动交互；claude --continue 继续最近的会话，claude --resume 选择或恢复已有会话。切换项目之前确认当前工作目录，避免把两个仓库的上下文混在一起。

claude
claude --continue
claude --resume

02一次性读取结果

-p 用于非交互请求。脚本需要解析结果时使用 JSON 输出，并处理命令失败、空输出和超时；不要靠屏幕上的自然语言猜测执行是否成功。

claude -p "概述这个仓库的结构"
claude -p "列出项目入口文件" --output-format json

03从理解到实施

在陌生仓库使用计划模式先完成阅读与分析，再确认实施范围。模式只是权限策略的一部分；组织设置、允许规则和工具权限仍会影响行为。

• /help：查看当前版本支持的交互命令。
• /status：核对会话、认证与配置状态。
• /context：查看上下文使用情况。
• claude doctor：检查安装与配置。

claude --permission-mode plan

04版本变化怎么处理

复制网上的命令前，用 claude --help 和官方 CLI 参考确认当前版本支持的参数。生产自动化应记录测试过的版本、安装方式和失败回退路径。

05给长任务留下可恢复的上下文

结束一个阶段时，要求输出当前状态、已修改文件、已完成验证和下一步。如果换到新会话，这份短说明比粘贴全部对话更容易恢复重点。

恢复已有会话后，先检查 Git 工作区是否变化。其他开发者或工具可能已经修改相同文件，旧会话里的假设不一定仍然成立。

暂停实施，整理交接说明：
1. 当前目标和已确认约束。
2. 已完成的修改及对应文件。
3. 已执行的验证与真实结果。
4. 尚未解决的问题和下一步。