[ PROMPT_NODE_23898 ]
effort
[ SKILL_DOCUMENTATION ]
# Effort 参数 (Beta)
**在迁移过程中添加 `effort` 并设置为 `"high"`。** 这是获得 Opus 4.5 最佳性能的默认配置。
## 概述
Effort 控制 Claude 消耗 token 的积极程度。它影响所有 token:思考、文本响应和函数调用。
| Effort | 使用场景 |
|--------|----------|
| `high` | 最佳性能,深度推理(默认) |
| `medium` | 成本/延迟与性能的平衡 |
| `low` | 简单、高频查询;显著节省 token |
## 实现
需要在 API 调用中包含 beta 标志 `effort-2025-11-24`。
**Python SDK:**
python
response = client.messages.create(
model="claude-opus-4-5-20251101",
max_tokens=1024,
betas=["effort-2025-11-24"],
output_config={
"effort": "high" # 或 "medium" 或 "low"
},
messages=[...]
)
**TypeScript SDK:**
typescript
const response = await client.messages.create({
model: "claude-opus-4-5-20251101",
max_tokens: 1024,
betas: ["effort-2025-11-24"],
output_config: {
effort: "high" // 或 "medium" 或 "low"
},
messages: [...]
});
**Raw API:**
{
"model": "claude-opus-4-5-20251101",
"max_tokens": 1024,
"anthropic-beta": "effort-2025-11-24",
"output_config": {
"effort": "high"
},
"messages": [...]
}
## Effort 与思考预算 (Thinking Budget)
Effort 与思考预算是独立的:
- 高 Effort + 无思考 = 更多 token,但没有思考 token
- 高 Effort + 32k 思考 = 更多 token,但思考上限为 32k
## 建议
1. 先确定 Effort 等级,再设置思考预算
2. 最佳性能:高 Effort + 高思考预算
3. 成本/延迟优化:中等 Effort
4. 简单高频查询:低 Effort