Skip to content

CLI 参考

Claude Code 命令行界面的完整参考,包括命令和标志。

CLI 命令

命令

描述

示例

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 文档

CLI 标志

使用这些命令行标志自定义 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

为打印模式指定输出格式(选项:textjsonstream-json

claude -p "query" --output-format json

--input-format

为打印模式指定输入格式(选项:textstream-json

claude -p --output-format json --input-format stream-json

--verbose

启用详细日志记录,显示完整的轮次输出(在打印和交互模式中都有助于调试)

claude --verbose

--max-turns

在非交互模式下限制代理轮次数量

claude -p --max-turns 3 "query"

--model

使用最新模型的别名(sonnetopus)或模型的全名为当前会话设置模型

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

💡 提示:>

--output-format json 标志对于脚本编写和自动化特别有用,允许您以编程方式解析 Claude 的响应。

有关打印模式(-p)的详细信息,包括输出格式、流式传输、详细日志记录和编程使用,请参阅 SDK 文档

另请参阅

Claude Code 中文文档