高级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_KEY | API密钥 | - |
ANTHROPIC_BASE_URL | API基础URL | https://api.anthropic.com |
CLAUDE_CODE_USE_BEDROCK | 使用AWS Bedrock | false |
MAX_MCP_OUTPUT_TOKENS | MCP输出Token限制 | 25000 |
MCP_TIMEOUT | MCP超时时间(秒) | 60 |
CLAUDE_CODE_SHELL_PREFIX | Shell命令前缀 | - |
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开发。