配置层级与模型选择

01先找到有效配置

用户、项目、本地和组织管理设置可以共同影响会话。分享问题时，说明配置放在哪个位置、通过什么入口启动，并先检查 claude doctor 的诊断。

团队共用设置应进入项目版本管理；本地凭证与个人覆盖保持在本机或密钥管理工具。不要把整个用户配置复制到项目。

02模型选择先看任务

模型名称、可用性、别名与访问权限随提供方和版本变化。用 /model 查看当前环境可用选项；需要稳定复现时记录实际模型标识、Claude Code 版本和提供方。

• 复杂仓库分析先关注推理与上下文需求。
• 高频的小任务同时衡量延迟和实际费用。
• 网关的模型别名需要服务端映射并经过工具调用测试。

/model
/status

03配置不生效时按层定位

先检查 shell 环境变量，再核对用户设置和项目覆盖，最后查组织策略。每次只调整一个变量，重启相关会话并记录结果。

同一个设置在终端、IDE 扩展和桌面应用中的读取位置可能不同，尤其是网关与网络配置；请跟随相应平台的官方说明。

04配置问题的最小复现记录

复制整个 settings.json 往往夹带过多无关信息。先列出变量名、配置作用域和预期行为，再附上已经遮盖敏感值的最小配置片段。

让另一位成员用相同版本与入口复现，能够区分个人环境问题和项目共用设置问题。

Claude Code 版本：
操作系统与入口（CLI / IDE / Desktop）：
设置位置（用户 / 项目 / 组织）：
使用的变量名称（不要填值）：
预期行为：
实际行为与完整错误：
已经验证的步骤：