CLI参考
原文：CLI reference
一句话
Claude Code命令行工具完整参考，包含所有命令和标志参数。
什么时候翻这页
- 需要使用Claude Code但忘记具体命令时
- 想了解如何通过命令行与Claude交互时
- 需要自定义Claude Code行为时
- 需要管理会话或更新版本时
核心概念
- 交互式会话：通过
claude命令启动的实时对话模式
- 打印模式：通过
-p标志实现的非交互式查询模式
- 会话管理：可以恢复、停止、删除和重新启动会话
- 权限模式：控制Claude对文件系统访问权限的不同级别
- 代理视图：监控和管理并行后台会话的界面
- 远程控制：从claude.ai或Claude应用控制本地会话的功能
怎么做
基本会话操作
- 启动交互式会话：
claude
- 带初始提示启动：
claude "explain this project"
- 非交互式查询：
claude -p "explain this function"
- 处理管道内容：
cat logs.txt | claude -p "explain"
- 继续最近的会话：
claude -c
- 恢复特定会话：
claude -r "auth-refactor" "Finish this PR"
会话管理
- 查看后台会话：
claude agents
- 附加到后台会话：
claude attach <id>
- 停止会话：
claude stop <id>
- 重启会话：
claude respawn <id>
- 删除会话：
claude rm <id>
系统提示自定义
- 替换整个系统提示：
--system-prompt "You are a Python expert"
- 从文件加载系统提示：
--system-prompt-file ./custom-prompt.txt
- 追加到默认提示：
--append-system-prompt "Always use TypeScript"
- 从文件追加到默认提示：
--append-system-prompt-file ./style-rules.txt
命令 / 配置速查
常用命令
| 命令 | 描述 |
|---|
claude | 启动交互式会话 |
claude "query" | 带初始提示启动交互式会话 |
claude -p "query" | 通过SDK查询后退出 |
claude -c | 继续当前目录最近的会话 |
claude -r "<session>" "query" | 通过ID或名称恢复会话 |
claude update | 更新到最新版本 |
claude auth login | 登录Anthropic账户 |
claude auth logout | 登出Anthropic账户 |
claude agents | 打开代理视图监控后台会话 |
claude project purge [path] | 删除项目的所有本地状态 |
常用标志
| 标志 | 描述 |
|---|
--add-dir | 添加额外的工作目录 |
--agent | 指定当前会话的代理 |
--model | 设置当前会话的模型 |
--name, -n | 为会话设置显示名称 |
--print, -p | 打印响应而不进入交互模式 |
--resume, -r | 恢复特定会话 |
--permission-mode | 开始指定的权限模式 |
--tools | 限制Claude可使用的内置工具 |
--verbose | 启用详细日志 |
--version, -v | 输出版本号 |
--worktree, -w | 在隔离的git worktree中启动Claude |
系统提示标志
| 标志 | 行为 |
|---|
--system-prompt | 替换整个默认提示 |
--system-prompt-file | 用文件内容替换默认提示 |
--append-system-prompt | 追加到默认提示 |
--append-system-prompt-file | 将文件内容追加到默认提示 |
初学者易错点
- 误以为
--system-prompt和--append-system-prompt可以同时使用，实际上前者会完全替换默认提示
- 忘记
-p标志会使Claude进入非交互模式，无法进行多轮对话
- 混淆
claude -c（继续最近会话）和claude -r（恢复特定会话）的用法
- 在使用管道内容时忘记使用
-p标志，导致命令无法正常工作
- 误以为所有标志都会在
--help中列出，实际上某些标志可能不会显示在帮助信息中
相关词条
interactive-mode 交互模式 - 了解交互式会话的快捷键和输入模式permission-modes 权限模式 - 了解不同级别的文件访问权限控制agent-view 代理视图 - 管理并行后台会话的界面settings 设置 - 配置选项和持久化设置agent-sdk 代理SDK - 程序化使用和集成remote-control 远程控制 - 从claude.ai控制本地会话