Path 01

Claude Code 直连

这是 convertmodel 的主路径。安装官方 CLI，写入最小配置，把请求直接送到 convertmodel 网关即可。

Node.js 18+
Anthropic compatible
推荐默认路径

安装前准备

  • 准备好 Node.js 18 或更新版本。
  • 确保当前机器可以正常访问 convertmodel 的网关域名。
  • 准备一枚可用的 Anthropic 兼容链路 API key。
官方入口： Claude Code 的安装方式以 Anthropic 官方文档为准；这里仅保留最短可用路径和 convertmodel 的接入配置。

安装 CLI

  1. 安装 Node.js 18+。
  2. 执行 npm install -g @anthropic-ai/claude-code。
  3. 首次运行 claude，确认 CLI 正常启动并创建配置目录。
npm install -g @anthropic-ai/claude-code
claude

接入 convertmodel

如果你使用环境变量注入或 settings.json 管理，请至少保证以下三项生效：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://convertmodel.net",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}
macOS / Linux

~/.claude/settings.json

Windows

%USERPROFILE%/.claude/settings.json

建议的使用顺序

  1. 先用默认赠送额度验证 CLI 是否能正常调用。
  2. 默认从 Sonnet 档位开始，不要一上来就切最贵的档位。
  3. 确认无 503、无 key 错误，再开始跑较长的真实开发任务。

最常见的三个问题

503 No available accounts 优先检查 key 类型、分组与模型名是否匹配。很多问题并不在 CLI，而在调度前过滤阶段。
调用到了错误模型 先看客户端发出的模型名，再确认网关当前对该 alias 的路由策略。
无使用记录 如果请求在调度前就失败，使用记录可能不会落库，需要回看网关日志或错误日志。