技能介绍

要解决什么问题

Claude Code CLI 默认走 Anthropic 官方模型，并在本地对模型名做校验。若你想把 Anthropic 兼容 的网关接到 OpenRouter、自建代理或其它非 Anthropic 模型上，常见坑是：用环境变量 ANTHROPIC_MODEL 或 --model 传模型名时，CLI 仍会触发校验，直接报 There's an issue with the selected model。

本技能针对的是 Claude Code v2.1.146+，目标是在不改 CLI 源码的前提下，让非官方模型名能被接受并正常发请求。

技能如何工作

核心是提供一份可落地的 settings.json 模板，并说明与官方文档容易混淆的三处配置：

Endpoint（baseUrl）：填写兼容 Anthropic 的基址，不要带 /v1 后缀；Claude Code 会自动拼 /v1/messages 与 /v1/models。
模型名（关键）：把 "model" 直接写在 ~/.claude/settings.json 里，这是绕过本地模型名校验的路径；通过环境变量或 CLI 传模型名反而会走校验并被拒绝。
API Key：放在环境变量 ANTHROPIC_API_KEY，不要写进 settings.json。

快速路径即：复制模板到 ~/.claude/settings.json，改 baseUrl 与 model，设置密钥后执行 claude。

适用边界与注意点

端点必须实现 Anthropic Messages API 的兼容语义；本技能只解决 Claude Code 侧的连接与模型名校验，不保证任意后端都能 100% 行为一致。
排错时可对照：模型相关错误 → 确认只用 settings.json 的 model；未登录 → 补 ANTHROPIC_API_KEY；连接被拒 → 检查 base URL 是否误加了 /v1。