effortLevel: max is not supported - Claude Code

Quick fix

将环境变量 CLAUDE_CODE_EFFORT_LEVEL 设为 high 或 max（v3.14.1+），避免使用无效的 max 值映射。

Symptom

报错原文复制

Generating "effortLevel": "max" instead

Cause

在 cc-switch v3.14.0 中，当用户在 Claude 配置界面勾选“Maximum Thinking Strength”时，生成的配置文件中的 effortLevel 字段被错误地设置为 "max"。然而，Claude Code 在该版本中仅接受 "low"、"medium" 或 "high" 作为有效值，导致报错。

后续讨论指出，虽然旧版 Claude Code 可能不支持 "max"，但较新版本已支持该值。cc-switch v3.14.1 (commit 064b339b) 通过允许写入 `CLAUDE_CODE_EFFORT_LEVEL=max` 修复了此问题。此外，对于使用 ultracode 模式并输出 "xhigh" 的情况，可能需要额外的转换逻辑支持，但核心冲突在于 "max" 值的合法性与映射。

Fix

1. 1

   升级 cc-switch 至 v3.14.1 或更高版本，以支持正确的 effortLevel 映射。

   # src-tauri/src/proxy/providers/transform.rs (内部逻辑变更)

2. 2

   如果无法升级，手动编辑配置文件，将 effortLevel 从 "max" 改为 "high"。

Affected Versions

ToolClaude Code

Version3.14.0

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #3389cc使用ultracode 同时本地路由到openai协议 effort失效
• #2379Bug: Checking "Maximum Thinking Strength" in Claude config generates wrong effortLevel: "max" value in v3.14.0

FAQ

为什么勾选 Maximum Thinking Strength 会报错？

因为在 v3.14.0 中，该选项错误地将 effortLevel 映射为 "max"，而当时 Claude Code 仅支持 low/medium/high。

如何修复这个错误？

建议升级到 v3.14.1+，或者手动将配置文件中的 effortLevel 改为 "high"。

ultracode 模式的 xhigh 怎么处理？

ultracode 会发出 xhigh，这需要 cc-switch 的转换层额外支持。目前推荐升级或使用本地代理中转。

相关问题

DeepSeek Claude Code 配置与切换异常先确认问题属于同一类：新终端或新会话会重新读取配置；DeepSeek 缓存命中率异常可先升级到 v3.16.3，但其他变体仍未修复。15 issues mergedcontent_block_start events 数百次碎片化升级到包含 b78192e8f 修复的下一版 cc-switch；该修复会忽略空 reasoning_content 并合并连续文本增量。1 issues merged<thinking> 标签作为正文输出 Claude Code将 provider 的 apiFormat 从 openai_chat 改为 anthropic（若上游支持），可绕过内联 <thinking> 泄露。1 issues merged