6.14 --model - 设置会话模型

概述#

--model 标志允许您指定 Claude Code 使用的模型。不同的模型有不同的性能、速度和成本特点，您可以根据任务需求选择合适的模型。

基本语法#

bash
复制
claude --model 模型名称>

可用模型#

Claude 是由 Anthropic 开发的最先进的大型语言模型系列。所有当前的 Claude 模型都支持文本和图像输入、文本输出、多语言功能和视觉能力。

别名支持：您也可以使用更简洁的别名 claude-opus-4-5、claude-sonnet-4-5 和 claude-haiku-4-5，这些别名会自动指向最新的模型快照。

使用场景#

1. 复杂任务使用 Opus#

bash
复制
# 复杂的代码生成claude --model claude-opus-4-5 -p "生成一个完整的微服务架构"# 或使用完整模型 IDclaude --model claude-opus-4-5-20251101 -p "生成一个完整的微服务架构"
# 深度代码分析claude --model claude-opus-4-5 -p "分析这个大型项目的架构问题"

2. 一般任务使用 Sonnet#

bash
复制
# 一般的代码编写claude --model claude-sonnet-4-5 -p "编写一个用户认证模块"
# 文档生成claude --model claude-sonnet-4-5 -p "为这个 API 生成文档"

3. 快速任务使用 Haiku#

bash
复制
# 快速查询claude --model claude-haiku-4-5 -p "这个函数是做什么的？"
# 简单的代码修复claude --model claude-haiku-4-5 -p "修复这个语法错误"

高级用法#

1. 与其他标志组合#

bash
复制
# 指定模型 + JSON 输出claude --model claude-opus-4-5 --output-format json -p "分析代码"
# 指定模型 + 限制工具claude --model claude-sonnet-4-5 --allowedTools "Read""Grep" -p "搜索代码"
# 指定模型 + 自定义系统提示claude --model  --system-prompt "你是一位 Python 专家" -p "编写代码"

2. 根据任务类型选择模型#

bash
复制
#!/bin/bash# select-model.shTASK_TYPE=$1case"$TASK_TYPE"in"complex")MODEL="claude-opus-4-5";;"general")MODEL="claude-sonnet-4-5";;"fast")MODEL="claude-haiku-4-5";;"latest")MODEL="";;*)MODEL="claude-sonnet-4-5";;esacecho"使用模型: $MODEL"claude --model "$MODEL" -p "完成任务"

3. 模型性能比较#

bash
复制
#!/bin/bash# compare-models.sh
TASK="分析这个 Python 文件的性能"
echo"比较不同模型的性能..."
formodelin claude-haiku-4-5 claude-sonnet-4-5 claude-opus-4-5;doecho"测试模型: $model"time claude --model "$model" -p "$TASK">"result-$model.txt"echo"---"done
echo"性能比较完成"

4. 成本优化#

bash
复制
#!/bin/bash# cost-optimization.sh# 根据任务复杂度选择模型TASK=$1# 简单任务使用 Haikuifecho"$TASK"|grep -qi "简单\|快速\|查询";thenMODEL="claude-haiku-4-5"# 复杂任务使用 Opuselifecho"$TASK"|grep -qi "复杂\|深度\|分析";thenMODEL="claude-opus-4-5"# 一般任务使用 SonnetelseMODEL="claude-sonnet-4-5"fiecho"使用模型: $MODEL (成本优化)"claude --model "$MODEL" -p "$TASK"

实际应用示例#

示例 1: 分层开发#

bash
复制
#!/bin/bash# layered-development.sh
# 第一层：快速原型（Haiku）echo"快速原型..."claude --model claude-haiku-4-5 -p "创建快速原型"> prototype.txt

# 第二层：功能完善（Sonnet）echo"功能完善..."claude --model claude-sonnet-4-5 -p "完善原型功能"> refined.txt

# 第三层：深度优化（Opus）echo"深度优化..."claude --model claude-opus-4-5 -p "优化性能和安全性"> optimized.txt

echo"分层开发完成"

示例 2: 代码审查流程#

bash
复制
#!/bin/bash# code-review-flow.shFILE=$1# 第一轮：快速检查（Haiku）echo"快速检查..."claude --model claude-haiku-4-5 -p "快速检查 $FILE 的语法错误"> quick-check.txt
# 第二轮：标准审查（Sonnet）echo"标准审查..."claude --model claude-sonnet-4-5 -p "审查 $FILE 的代码质量"> standard-review.txt
# 第三轮：深度分析（Opus）echo"深度分析..."claude --model claude-opus-4-5 -p "深度分析 $FILE 的架构和设计"> deep-analysis.txt
echo"代码审查完成"

示例 3: 文档生成#

bash
复制
#!/bin/bash# generate-docs.sh
# 生成大纲（Haiku）echo"生成大纲..."claude --model claude-haiku-4-5 -p "生成文档大纲"> outline.txt

# 生成内容（Sonnet）echo"生成内容..."claude --model claude-sonnet-4-5 -p "生成文档内容"> content.txt

# 完善文档（Opus）echo"完善文档..."claude --model claude-opus-4-5 -p "完善文档，添加示例和最佳实践"> final-docs.txt

echo"文档生成完成"

示例 4: 测试生成#

bash
复制
#!/bin/bash# generate-tests.sh# 分析代码（Sonnet）echo"分析代码..."claude --model claude-sonnet-4-5 -p "分析代码结构"> analysis.txt
# 生成测试用例（Sonnet）echo"生成测试用例..."claude --model claude-sonnet-4-5 -p "生成测试用例"> test-cases.txt
# 生成测试代码（Opus）echo"生成测试代码..."claude --model claude-opus-4-5 -p "生成完整的测试代码"> tests.py
echo"测试生成完成"

模型选择指南#

1. 按任务复杂度选择#

2. 按性能要求选择#

3. 按成本考虑选择#

最佳实践#

1. 从平衡模型开始#

bash
复制
# 默认使用 Sonnetclaude --model claude-sonnet-4-5 -p "完成任务"
# 如果需要更强的能力，升级到 Opusclaude --model claude-opus-4-5 -p "完成任务"

2. 根据结果调整#

bash
复制
#!/bin/bash# adaptive-model.shTASK=$1# 先用 Sonnet 尝试echo"尝试使用 Sonnet..."claude --model claude-sonnet-4-5 -p "$TASK"> result.txt
# 检查结果质量ifgrep -qi "无法完成\|需要更多信息" result.txt;thenecho"升级到 Opus..."claude --model claude-opus-4-5 -p "$TASK"> result.txt
fi

3. 批量处理使用 Haiku#

bash
复制
# 批量简单任务使用 Haikuforfilein *.py;doecho"处理 $file..."    claude --model claude-haiku-4-5 -p "检查 $file 的语法">"check-$file.txt"done

4. 关键任务使用 Opus#

bash
复制
# 关键任务使用 Opusclaude --model claude-opus-4-5 -p "生成生产环境代码"
# 安全审查使用 Opusclaude --model claude-opus-4-5 -p "进行安全审查"

常见问题#

Q1: 如何选择合适的模型？#

A: 根据任务复杂度、性能要求和成本考虑选择。简单任务用 Haiku，一般任务用 Sonnet，复杂任务用 Opus。

Q2: 可以在会话中切换模型吗？#

A: 不可以。模型在会话开始时确定，整个会话使用同一个模型。

Q3: 不同模型的价格差异大吗？#

A: 是的。Opus 最贵，Haiku 最便宜。建议根据任务需求选择合适的模型。

Q4: 3.5 Sonnet 与 3 Sonnet 有什么区别？#

A: 3.5 Sonnet 是更新的模型，具有更强的能力和更好的性能，但可能定价不同。

Q5: 如何知道哪个模型最适合我的任务？#

A: 可以尝试不同的模型，比较结果质量和响应时间，选择最适合的模型。

与其他标志的组合示例#

1. 完整的开发流程#

bash
复制
#!/bin/bash# full-development.sh
# 快速原型（Haiku）claude --model claude-haiku-4-5 -p "创建快速原型"> prototype.txt

# 功能开发（Sonnet）claude --model claude-sonnet-4-5 -p "开发完整功能"> implementation.txt

# 深度优化（Opus）claude --model claude-opus-4-5 -p "优化性能和安全性"> optimization.txt

echo"开发流程完成"

2. 迭代改进#

bash
复制
#!/bin/bash# iterative-improvement.shformodelin claude-haiku-4-5 claude-sonnet-4-5 claude-opus-4-5;doecho"使用 $model 改进..."claude --model "$model" -p "改进代码">"improvement-$model.txt"doneecho"迭代改进完成"

3. 成本优化流程#

bash
复制
#!/bin/bash# cost-optimized-flow.sh
# 简单任务（Haiku）claude --model claude-haiku-4-5 -p "快速检查"> check.txt

# 一般任务（Sonnet）claude --model claude-sonnet-4-5 -p "标准开发"> dev.txt

# 关键任务（Opus）claude --model claude-opus-4-5 -p "关键审查"> review.txt

echo"成本优化流程完成"

总结#

--model 标志提供了一种选择合适模型的方式。通过选择不同的模型，您可以：

• 平衡性能、速度和成本
• 根据任务复杂度选择合适的模型
• 优化资源使用和成本
• 获得最佳的结果质量

合理使用 --model 可以帮助您在不同场景下获得最佳的性能和成本效益。