Skip to content

Claude Code CLI 参考手册

Claude Code 命令行界面完整参考手册,包含所有命令和标志。

CLI 命令

命令描述示例
claude启动交互式 REPLclaude
claude "查询"使用初始提示启动 REPLclaude "explain this project"
claude -p "查询"通过 SDK 查询,然后退出claude -p "explain this function"
cat file | claude -p "查询"处理管道内容cat logs.txt | claude -p "explain"
claude -c继续最近的对话claude -c
claude -c -p "查询"通过 SDK 继续对话claude -c -p "Check for type errors"
claude -r "<session-id>" "查询"通过 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允许工具列表,无需提示用户授权,这是对设置.json文件的补充"Bash(git log:*)" "Bash(git diff:*)" "Read"
--disallowedTools禁止工具列表,无需提示用户授权,这是对设置.json文件的补充"Bash(git log:*)" "Bash(git diff:*)" "Edit"
--print, -p打印响应而不进入交互模式(参见 SDK 文档 了解程序化使用详情)claude -p "query"
--output-format指定打印模式的输出格式(选项:textjsonstream-jsonclaude -p "query" --output-format json
--input-format指定打印模式的输入格式(选项:textstream-jsonclaude -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

常用命令示例

基本使用

bash
# 启动交互式会话
claude

# 快速查询并退出
claude -p "解释这个函数的作用"

# 带初始提示启动会话
claude "帮我分析这个项目的结构"

会话管理

bash
# 继续最近的对话
claude -c

# 恢复特定会话
claude --resume abc123

# 在继续对话的同时执行查询
claude -c -p "检查代码中的类型错误"

输出格式化

bash
# JSON 格式输出(适合脚本使用)
claude -p "分析代码" --output-format json

# 流式 JSON 输出
claude -p "重构这个函数" --output-format stream-json

# 详细日志模式
claude --verbose -p "优化性能"

权限和安全

bash
# 计划模式启动(仅生成计划,不执行)
claude --permission-mode plan

# 跳过权限提示(谨慎使用)
claude --dangerously-skip-permissions

# 指定允许的工具
claude --allowedTools "Read" "Grep" -p "分析项目"

项目和目录

bash
# 添加额外工作目录
claude --add-dir ../utils ../components

# 在特定项目中使用
cd /path/to/project && claude

管道和流处理

Claude Code 支持标准的 Unix 管道操作:

bash
# 分析日志文件
cat error.log | claude -p "分析这些错误"

# 处理 git 输出
git diff | claude -p "总结这些变更"

# 分析测试结果
npm test | claude -p "解释测试失败的原因"

提示

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

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

config 命令详解

基本命令

bash
# 列出所有配置项
claude config list

# 获取特定配置值
claude config get <key>

# 设置全局配置
claude config set -g <key> <value>

# 添加到配置数组
claude config add -g <key> <value>

# 从配置中移除
claude config remove -g <key> <value>

核心配置项

配置项可选值描述
themedark, lightCLI 主题风格
verbosetrue, false详细输出模式
autoUpdatestrue, false自动更新检查
allowedToolsEdit, View, Bash(...)允许的工具列表
parallelTasksCount1, 2, 4并发任务数量
messageIdleNotifThresholdMs60000空闲通知阈值(毫秒)

配置示例

bash
# 设置主题为暗色
claude config set -g theme dark

# 启用详细日志
claude config set -g verbose true

# 设置并发任务数
claude config set -g parallelTasksCount 2

# 添加允许的工具
claude config add -g allowedTools "Bash(git:*)"

环境变量参考

核心环境变量

变量名默认值描述
ANTHROPIC_BASE_URL-API 服务地址
ANTHROPIC_API_KEY-API 密钥
ANTHROPIC_AUTH_TOKEN-认证令牌

高级环境变量

变量名默认值描述
DISABLE_NON_ESSENTIAL_MODEL_CALLS0跳过非必要的模型调用
MAX_THINKING_TOKENS30-40k限制思考 Token 数量
DISABLE_TELEMETRY0禁用遥测数据收集
HTTP_PROXY / HTTPS_PROXY未设置网络代理设置
NO_PROXYlocalhost,127.0.0.1代理绕过列表

环境变量设置示例

Linux/macOS

bash
# 临时设置
export ANTHROPIC_API_KEY="your-key-here"

# 永久设置(添加到 ~/.bashrc 或 ~/.zshrc)
echo 'export ANTHROPIC_API_KEY="your-key-here"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

powershell
# 临时设置
$env:ANTHROPIC_API_KEY="your-key-here"

# 永久设置
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-key-here", "User")

另请参阅

注意:本文档翻译自 Anthropic 官方 Claude Code CLI 参考文档。如需最新信息,请访问官方英文文档