Claude Code怎么用Sonnet 5.5？选模型、调effort和权限排查

在支持该模型ID的供应商上，新建 Claude Code 会话可用 claude --model claude-sonnet-5-5，已有会话可用 /model claude-sonnet-5-5 明确选择 Sonnet 5.5。先核对客户端版本和账户的模型权限。Anthropic 当前文档要求 Claude Code v2.1.284 或更高版本。

这里要分清三件事：客户端能否识别模型、供应商是否提供模型，以及账户是否有使用权限。本文于 2026 年 9 月 29 日对照 Claude Code模型配置文档核对，不代表所有订阅或第三方端点都有访问权。

检查版本并选定模型

在终端运行：

claude --version
claude update
claude --model claude-sonnet-5-5 --effort medium

claude update 会更新已安装客户端。如果安装由组织统一管理，应遵循组织的软件管理流程。已有交互会话中可使用：

/model claude-sonnet-5-5
/status

查看显示的模型和供应商，不要只假设命令已经生效。模型在回答里自称是谁，并不能证明实际服务模型；客户端状态和响应元数据更适合作为证据。

短别名 sonnet 很方便，但具体映射取决于供应商和客户端版本。当前文档在 Anthropic API 下把它映射为 Sonnet 5.5，部分云供应商的别名仍指向较旧的 Sonnet。完整模型名表达了你的选择意图，但还必须采用该供应商支持的标识符和接入路径。

只改默认值为什么还不够

Claude Code 默认模型不一定是最新 Sonnet。当前文档将若干账户/供应商类别的默认模型列为 Opus 5.5，因此使用 Sonnet 需要明确选择。如果组织限制了模型列表，可见选项也会与公开教程不同。

ANTHROPIC_DEFAULT_SONNET_MODEL 等环境变量也可能改变别名映射。修改前应检查适用的用户、项目及托管配置，记下旧值，方便撤销本地试验。不要为解决一个会话的问题覆盖整个团队的供应商设置。

做可复现测试时先明确选模，再决定是否设为长期默认。一次试验不需要修改所有仓库和 Agent 定义。

按任务选择effort

Sonnet 5.5 原生 API 默认 high，而 Claude Code 模型配置文档将该客户端里的 Sonnet 5.5 默认值列为 medium。这是不同入口的设置，不能混为一谈。

需求明确的代码修改，可按文档先从 medium 开始；任务和结果确实需要时再提高。在交互客户端可用 /effort，启动时可用 --effort，但都受账户限制影响。托管配置可能限制实际档位，即使请求了更高值；能够查看时，应记录最终生效设置。

effort指南解释了为什么档位高不等于结果更好。建议在隔离分支上开始，先定义验收条件，最后检查可审核的 diff。模型运行工具仍需要权限，合并前也仍需检查改动。

订阅访问与API计费要分开

Claude 订阅登录和 API Key 是不同接入方式。如果提示组织已禁用 Claude Code 的订阅访问，这是账户策略阻碍，不证明 Sonnet 服务宕机。应由管理员确认获准使用的路径，不要绕过托管限制。

准备本文时，本地 Claude Code v2.1.281 返回了这条组织访问提示，没有执行 Sonnet 任务；该版本也低于文档要求。因此我们不声称该次尝试完成了模型实测、计时或成本测量。上面的命令是依据文档核对的操作说明。

如果存在已批准的 API 路径，请求就按 API 计费，不会因为同时购买了订阅而免费。试验前先核对精确端点、模型、账户与现行价格。Sonnet API费用指南介绍厂商价表的计算方法。

按实际错误排查

404 不能证明全球宕机，429 也不能证明订阅被取消。保存脱敏错误正文、时间戳和客户端版本。寻求支持时不要附上 token、完整环境变量或私有仓库上下文。

原生请求变化见 Sonnet 5.5 API迁移清单；是否需要从旧模型切换，可先看 Sonnet 5与5.5升级决策。