Skip to content

高级CLI参数

Claude Code提供了丰富的CLI参数,让你能够精确控制其行为。本节介绍这些高级参数。

模型选择

指定模型

bash
# 使用Claude Sonnet(默认)
claude

# 使用Claude Opus(最强)
claude --model claude-opus-4

# 使用Claude Haiku(最快)
claude --model claude-haiku-3-5

# 短参数形式
claude -m opus
claude -m haiku

模型特点

模型特点适用场景
claude-opus-4最强推理能力复杂任务、架构设计
claude-sonnet-4平衡性能和成本日常开发
claude-haiku-3-5快速响应简单任务、快速查询

输出格式

JSON输出

bash
claude -p "问题" --output-format json

流式JSON

bash
claude -p "问题" --output-format stream-json

纯文本

bash
claude -p "问题" --output-format text

权限控制

跳过权限确认

bash
# 跳过所有权限确认(谨慎使用)
claude --dangerously-skip-permissions

配置权限模式

bash
# 计划模式(只规划不执行)
claude --plan

# 自动接受所有操作
claude --auto-accept

调试选项

MCP调试

bash
# 启用MCP调试输出
claude --mcp-debug

详细日志

bash
# 启用详细日志
CLAUDE_DEBUG=1 claude

# 保存日志到文件
claude 2>&1 | tee claude.log

诊断命令

bash
# 运行诊断
claude /doctor

配置管理

指定配置目录

bash
# 使用自定义配置目录
claude --config-dir ~/.config/claude-custom

查看配置

bash
# 列出所有配置
claude config list

# 获取特定配置
claude config get defaultModel

# 设置配置
claude config set defaultModel claude-opus-4

环境变量

完整的环境变量列表

变量说明默认值
ANTHROPIC_API_KEYAPI密钥-
ANTHROPIC_BASE_URLAPI基础URLhttps://api.anthropic.com
CLAUDE_CODE_USE_BEDROCK使用AWS Bedrockfalse
MAX_MCP_OUTPUT_TOKENSMCP输出Token限制25000
MCP_TIMEOUTMCP超时时间(秒)60
CLAUDE_CODE_SHELL_PREFIXShell命令前缀-
CLAUDE_DEBUG启用调试false

使用示例

bash
# 使用自定义API端点
export ANTHROPIC_BASE_URL=https://custom-api.example.com
claude

# 增加MCP输出限制
export MAX_MCP_OUTPUT_TOKENS=50000
claude

# 设置超时
export MCP_TIMEOUT=120
claude

# 使用AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
claude

会话管理

新会话

bash
# 开始新会话(忽略之前的上下文)
claude --new-session

# 继续上次的会话
claude --continue

会话ID

bash
# 指定会话ID
claude --session-id my-feature-session

# 恢复特定会话
claude --resume-session session-12345

其他参数

版本信息

bash
claude --version
claude -v

帮助信息

bash
claude --help
claude -h

静默模式

bash
# 减少输出
claude --quiet
claude -q

输入文件

bash
# 从文件读取输入
claude --input prompt.txt

# 从标准输入读取
cat question.txt | claude -p "$(cat)"

完整参数列表

bash
claude --help
用法: claude [选项] [提示词]

选项:
  -p, --print              非交互模式,打印结果后退出
  -m, --model <model>      指定使用的模型
  -c, --config <dir>       指定配置目录
  --output-format <fmt>    输出格式: text, json, stream-json
  --dangerously-skip-permissions  跳过所有权限确认
  --mcp-debug              启用MCP调试
  --new-session            开始新会话
  --continue               继续上次会话
  --plan                   计划模式
  --auto-accept            自动接受所有操作
  -q, --quiet              静默模式
  -v, --version            显示版本
  -h, --help               显示帮助

内置命令:
  /help        显示帮助
  /clear       清除会话
  /compact     压缩会话
  /cost        显示成本
  /config      配置管理
  /permissions 权限管理
  /mcp         MCP管理
  /hooks       Hooks管理
  /doctor      运行诊断

组合使用

复杂命令组合

bash
# 使用Opus模型,JSON输出,跳过权限
claude -m opus -p "复杂分析任务" \
    --output-format json \
    --dangerously-skip-permissions

# 调试模式运行
CLAUDE_DEBUG=1 claude --mcp-debug -p "测试MCP连接"

# CI/CD场景
claude -p "代码审查" \
    --output-format json \
    --dangerously-skip-permissions \
    --quiet > result.json

下一步

学会了高级CLI参数后,继续学习 自定义Agent开发