如何用 Claude Code Router 以不同模型多开相互独立的 Agent 实例
如何用 Claude Code Router 以不同模型多开相互独立的 Agent 实例【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router如果你的同一个 Agent例如 Claude Code需要同时跑几路互不干扰的任务而每路任务希望走不同的上游模型——比如一路用供应商 A 的强模型做代码评审另一路用供应商 B 的便宜模型做日常修改——Claude Code Router下称 CCR的做法是为每个实例单独创建一个 Agent 配置各配置绑定各自的模型然后分别从 CCR 启动。每个 Agent 配置都是一个独立启动配置实例之间不共享模型设置。本文以 CCR 已在本机安装并运行、且至少添加了一个可用供应商和模型为前提演示如何配置并验证两个相互独立、模型不同的 Agent 实例。准备条件确认 CCR 与模型已就绪多开实例的前提是 CCR 网关已经在运行并且模型可供选择。按 安装并启动 CCR 完成任一发行方式的安装后在供应商配置中至少添加一个供应商并勾选模型。模型在 CCR 中的值通常是供应商名称/模型名称形式例如Moonshot/kimi-k3。在API 密钥页面创建用于访问网关的 CCR 客户端 Key。在服务页面确认网关状态为运行中。如果本机已有 Claude Code、Codex 等 Agent 的登录态也可以在添加供应商时直接导入不必手动粘贴 API Key。供应商与模型的完整字段说明见 供应商配置。为每个实例创建一个 Agent 配置CCR 的多开机制不是复制同一个实例而是创建多个配置需要为同一个 Agent 使用不同模型、作用范围或桌面窗口时就再建一个配置。操作路径以桌面端为例CLI 发行版逻辑相同打开Agent 配置页面点击添加配置。选择 Agent 类型Claude Code、Codex、OpenCode、Grok CLI、Kimi CLI、ZCode 或 WorkBuddy。注意入口能力差异Grok CLI 和 Kimi CLI 只支持 CLIZCode 和 WorkBuddy 只支持 App。填写配置名称。名称用于在 CCR 中识别配置也可以包含空格复制命令时 CCR 会自动加引号例如Claude - Review和Claude - Daily。选择模型这就是该实例的默认模型选择普通供应商模型或 Fusion 模型。Claude Code 留空表示保留 Claude Code 自身默认模型。选择作用范围仅从 CCR 打开时生效只影响从 CCR 启动的实例不会改动你系统里直接打开的 Agent。试用阶段建议选这个。系统默认也会影响你直接打开的 Agent。同一个 Agent 同时只能有一个启用的系统默认配置。选择入口模式CLI APP同时提供终端命令和 App 按钮CLI only只生成 CLI 命令App only只提供 App 入口。保持启用开关为开。关闭后该配置不会出现在打开入口中也无法被ccr命令启动。保存第二个配置Claude - Daily换另一个模型后你就有了两个相互独立的启动配置。各字段的完整说明见 Agent 配置逐 Agent 的接入字段见 接入 Agent 配置。分别启动两个实例启动命令按发行版区分两个发行版读取同一套本机配置目录但命令名不要混用场景命令桌面端配置卡片上的终端按钮复制的命令ccr-app Claude - Reviewnpm CLI在终端直接执行ccr Claude - Review启动 App 入口桌面端点击配置卡片上的播放按钮或ccr Claude - Review appccr 配置名称或 ID的完整语法支持cli/app后缀和透传 Agent 参数ccr 配置名称或 ID [cli|app] [-- Agent 参数]示例ccr Claude - Review ccr Claude - Daily cli -- --model sonnet规则要点Agent 自己的参数放到--之后避免与 CCR 选项冲突。省略入口时Claude Code、Codex、Grok CLI 默认使用 CLIZCode 默认使用 App。只有已启用的配置可以启动名称产生歧义时使用配置 ID。启动 App 需要本机已安装对应桌面应用且当前环境有图形会话。npm CLI 要求 Node.js 22 或更高版本。在两个不同终端分别执行ccr Claude - Review和ccr Claude - Daily即得到两个各自绑定不同模型的 CLI 实例可以分别cd到不同项目目录运行。验证实例独立且模型正确验证分三步全部基于 CCR 自带面板无需额外工具开启请求日志到设置 → 日志与观测打开请求日志需要看执行链路时同时打开Agent 观测。各发一条消息在两个实例中分别发送一条消息确认都能正常回复。核对请求日志日志页每条记录包含request model、resolved provider、resolved model、状态码、耗时和 token 字段。确认两个实例的请求分别命中了你为它们配置的供应商和模型且互不串线。对于 CLI 实例进入 Claude Code 后还可以输入/model查看 CCR 网关暴露的模型列表包括普通供应商模型和可见的 Fusion 模型并随时切换——选择后请求仍走 CCR 的供应商、路由和 Fusion。模型列表来源因入口而异Claude Code CLI 的列表来自 CCR 网关模型发现Claude App 使用当前配置的模型列表。限制与排查多开时最容易踩的几个点文档中都有明确说明App 多开的窗口限制某些 Agent 只支持单个 App 窗口重复打开同一配置时会激活已有窗口而不是新开一个。需要第二个 App 实例时创建另一个 Agent 配置再从 CCR 打开。OpenCode Desktop 是单实例应用切换配置时 CCR 会先停止其管理的旧实例应从 CCR 切换配置而不是另起一个 App。CLI 不转发 Bot 消息AgentClaw 的 IM 转发只在从 CCR 打开的 App 模式生效CLI 实例不转发 Bot 消息。请求没有走到 CCR按四项依次检查——CCR 服务是否在运行Agent 是否从 CCR 启动而非直接打开Agent 配置是否已启用并应用作用范围是否覆盖当前项目。作用范围为仅从 CCR 打开时生效时直接打开的 Agent 本来就不受影响。/model看不到 CCR 模型确认已配置供应商与模型。找不到 Agent 配置 / 提示启动器不存在前者确认配置已启用、名称是否重复多个结果时必须用 ID后者先打开一次 CCR 或重新保存该 Agent 配置让 CCR 重新生成bin/下的启动包装器。端口偏移管理端口 3458 被占用时 CCR 会使用后续可用端口以命令打印的 URL 为准。完整的症状-排查对照见 常见问题命令细节见 CLI 安装与命令参考。小结CCR 中多开的完整闭环是每个独立实例对应一个 Agent 配置配置名称 作用范围 模型用ccr-app 配置名称桌面端或ccr 配置名称CLI分别启动再到请求日志里用resolved provider/resolved model逐条核对各实例实际走的模型。配置、启动、验证三个环节都收敛在 CCR 内部实例之间靠配置隔离互不污染。【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考