UniRouteClaude Code（终端）
安装官方 Claude Code，选择模型并用 UniRoute 配置工具接入。
Claude Code
1. 安装官方客户端
请先安装Node.js 22 或更新版本。当前 npm 分发的 Claude Code 和 UniRoute 配置工具均要求 Node.js 22+。Windows 使用 PowerShell，macOS / Linux 使用终端。
已安装可跳过。其他官方安装方式请参阅Claude Code 官方文档。
2. 选择当前可用模型
先在控制台创建 UniRoute API Key，再查询当前 Key 可访问的模型目录：
命令在终端提示输入 Key，输入内容不会显示。不要把 Key 发到 AI 对话、放进命令参数或贴到截图中。
Claude Code 使用 Anthropic Messages 协议。请选择目录中适用于该协议的 Claude 模型，复制完整 Model ID；以下 MODEL_ID 需要替换为该值。目录查询成功不代表真实模型调用已验证。
3. 配置 UniRoute
先预览修改：
检查预览后写入配置：
工具更新当前用户的 .claude/settings.json，设置所选模型、ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL=https://api.uniroute.app。其他设置会保留，有变化的文件先生成备份；已存在的配置无需手动清空。
工具不会覆盖 .claude.json 或伪造首次启动完成状态。需要隔离试用时，可使用 --home /path/to/test-home。自动化也可以使用已设置的 UNIROUTE_API_KEY，或本人可读的 --key-file /path/to/private-key-file。
4. 启动 Claude Code
进入您自己的项目目录，再执行：
首次启动时，按客户端提示选择终端主题、阅读使用说明，并确认是否信任当前项目。只有您创建或确认可信的目录才应选择信任。这些是客户端的初始化步骤，无需手写 .claude.json 来跳过。
配置好的 UniRoute API Key 用于 API 认证，不要求登录 Anthropic 官方账户。进入输入界面后检查当前模型；如果仍显示官方登录选择，请确认正在使用同一个系统用户，且配置已写入该客户端使用的设置目录。
如设置了 CLAUDE_CONFIG_DIR，客户端会从指定目录读取设置，其偏好文件也可能位于该目录中。配置工具按当前用户的 .claude 目录写入；自定义目录用户应先确认两者路径一致。
可以使用以下命令查看认证状态，避免打印含 Key 的配置文件：
5. 按需验证真实调用
需要测试时，可以在终端使用无交互方式请求简短回复。以下命令会发起真实模型请求并产生费用：
收到回复后，到 UniRoute 控制台核对调用记录。-p 使用同一 API 配置，无需先完成交互界面的主题或项目引导；如果首次启动停在登录选择，可以先退出并用这个命令验证 API 接入，无需手写偏好文件。
配置、预览和模型目录查询不会自动发起测试对话。
也可以安装UniRoute 配置 Skill，让 AI 按同样流程协助操作，并由您在自己的终端输入 Key。