主题
Claude Code CLI 参考手册
Claude Code 命令行界面完整参考手册,包含所有命令和标志。
CLI 命令
命令 | 描述 | 示例 |
---|---|---|
claude | 启动交互式 REPL | claude |
claude "查询" | 使用初始提示启动 REPL | claude "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 | 指定打印模式的输出格式(选项: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 |
常用命令示例
基本使用
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>
核心配置项
配置项 | 可选值 | 描述 |
---|---|---|
theme | dark, light | CLI 主题风格 |
verbose | true, false | 详细输出模式 |
autoUpdates | true, false | 自动更新检查 |
allowedTools | Edit, View, Bash(...) | 允许的工具列表 |
parallelTasksCount | 1, 2, 4 | 并发任务数量 |
messageIdleNotifThresholdMs | 60000 | 空闲通知阈值(毫秒) |
配置示例
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_CALLS | 0 | 跳过非必要的模型调用 |
MAX_THINKING_TOKENS | 30-40k | 限制思考 Token 数量 |
DISABLE_TELEMETRY | 0 | 禁用遥测数据收集 |
HTTP_PROXY / HTTPS_PROXY | 未设置 | 网络代理设置 |
NO_PROXY | localhost,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 参考文档。如需最新信息,请访问官方英文文档。