ClaudeCode 命令行开发工具快速参考备忘单。
| 命令 | 描述 | 示例 |
|---|---|---|
claude | 启动交互式 REPL | claude |
claude "query" | 使用初始提示启动 REPL | claude "explain this project" |
claude -p "query" | 通过 SDK 查询,然后退出 | claude -p "explain this function" |
cat file | claude -p "query" | 处理管道内容 | cat logs.txt | claude -p "explain" |
claude -c | 继续最近的对话 | claude -c |
claude -c -p "query" | 通过 SDK 继续 | claude -c -p "Check for type errors" |
claude -r "<session-id>" "query" | 通过 ID 恢复会话 | claude -r "abc123" "Finish this PR" |
claude update | 更新到最新版本 | claude update |
claude mcp | 配置模型上下文协议 (MCP) 服务器 | 请参阅 Claude Code MCP 文档。 |
使用这些命令行标志自定义 Claude Code 的行为:
| 标志 | 描述 | 示例 |
|---|---|---|
--add-dir | 添加额外的工作目录供 Claude 访问(验证每个路径是否作为目录存在) | claude --add-dir ../apps ../lib |
--allowedTools | 除了 settings.json 文件 之外,应该在不提示用户许可的情况下允许的工具列表 | "Bash(git log:*)" "Bash(git diff:*)" "Read" |
--disallowedTools | 除了 settings.json 文件 之外,应该在不提示用户许可的情况下禁止的工具列表 | "Bash(git log:*)" "Bash(git diff:*)" "Edit" |
--print, -p | 打印响应而不使用交互模式(有关编程使用详细信息,请参阅 SDK 文档) | claude -p "query" |
--append-system-prompt | 附加到系统提示(仅与 --print 一起使用) | claude --append-system-prompt "Custom instruction" |
--output-format | 为打印模式指定输出格式(选项:text、json、stream-json) | claude -p "query" --output-format json |
--input-format | 为打印模式指定输入格式(选项:text、stream-json) | claude -p --output-format json --input-format stream-json |
--verbose | 启用详细日志记录,显示完整的轮次输出(在打印和交互模式中都有助于调试) | claude --verbose |
--max-turns | 在非交互模式下限制代理轮次数量 | claude -p --max-turns 3 "query" |
--model | 使用最新模型的别名(sonnet 或 opus)或模型的全名为当前会话设置模型 | claude --model claude-sonnet-4-20250514 |
--permission-mode | 在指定的权限模式下开始 | claude --permission-mode plan |
--permission-prompt-tool | 指定一个 MCP 工具来处理非交互模式下的权限提示 | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--resume | 通过 ID 恢复特定会话,或在交互模式下选择 | claude --resume abc123 "query" |
--continue | 在当前目录中加载最近的对话 | claude --continue |
--dangerously-skip-permissions | 跳过权限提示(谨慎使用) | claude --dangerously-skip-permissions |
| 命令 | 用途 |
|---|---|
/add-dir | 添加额外的工作目录 |
/agents | 管理用于专门任务的自定义AI子代理 |
/bug | 报告错误(将对话发送给Anthropic) |
/clear | 清除对话历史 |
/compact [instructions] | 压缩对话,可选择性地提供重点指令 |
/config | 查看/修改配置 |
/cost | 显示令牌使用统计(请参阅成本跟踪指南了解订阅特定详情) |
/doctor | 检查您的Claude Code安装的健康状况 |
/help | 获取使用帮助 |
/init | 使用CLAUDE.md指南初始化项目 |
/login | 切换Anthropic账户 |
/logout | 从您的Anthropic账户登出 |
/mcp | 管理MCP服务器连接和OAuth身份验证 |
/memory | 编辑CLAUDE.md内存文件 |
/model | 选择或更改AI模型 |
/permissions | 查看或更新权限 |
/pr_comments | 查看拉取请求评论 |
/review | 请求代码审查 |
/status | 查看账户和系统状态 |
/terminal-setup | 安装Shift+Enter键绑定用于换行(仅限iTerm2和VSCode) |
/vim | 进入vim模式以在插入和命令模式之间切换 |
{
"hooks": {
"EventName": [
{
"matcher": "ToolPattern",
"hooks": [
{ "type": "command", "command": "your-command-here" }
]
}
]
}
}
PreToolUse 和 PostToolUse)Write 仅匹配 Write 工具Edit|Write 或 Notebook.** 匹配所有工具。您也可以使用空字符串("")或留空 matcher。type:目前仅支持 "command"command:要执行的 bash 命令(可以使用 $CLAUDE_PROJECT_DIR 环境变量)timeout:(可选)命令应该运行多长时间(以秒为单位),在取消该特定命令之前。Task - 子代理任务(参见子代理文档)Bash - Shell 命令Glob - 文件模式匹配Grep - 内容搜索Read - 文件读取Edit、MultiEdit - 文件编辑Write - 文件写入WebFetch、WebSearch - Web 操作在 Claude 创建工具参数之后、处理工具调用之前运行。
tool_input 的确切模式取决于工具。
{
"session_id": "abc123",
"transcript_path": "/Users/.../.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
"cwd": "/Users/...",
"hook_event_name": "PreToolUse",
"tool_name": "Write",
"tool_input": {
"file_path": "/path/to/file.txt",
"content": "file content"
}
}
tool_input 和 tool_response 的确切模式取决于工具。
{
"session_id": "abc123",
"transcript_path": "/Users/.../.claude/projects/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
"cwd": "/Users/...",
"hook_event_name": "PostToolUse",
"tool_name": "Write",
"tool_input": {
"file_path": "/path/to/file.txt",
"content": "file content"
},
"tool_response": {
"filePath": "/path/to/file.txt",
"success": true
}
}