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

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

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前缀缓存命中率骤降 - CC Switch修复升级至 cc-switch v3.16.3 以修复格式转换导致的缓存命中率计算错误。2 issues mergedapi failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。7 issues merged使用claude code的代理功能后，无法显示模型的思考过程 cc-switch可先切回 Anthropic 协议恢复思考显示；若用 `openai_chat`，需修改 `streaming.rs` 的块转换，避免 Qwen 交替 `reasoning`/`content` 把 Claude Code 回复拆成多个片段。2 issues merged