Claude Code Router 如何用 ccr 命令按 Agent 配置启动实例并向 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如果你使用 npm 安装 Claude Code RouterCCR而不是桌面应用就需要用ccr命令完成两件事按Agent 配置中已保存的配置启动一个独立的 Agent 实例并把 Agent 自己的命令行参数原样透传给它。ccr 配置名称或 ID [cli|app] [-- Agent 参数]是这条路径的完整形态本文基于 CLI 安装与命令参考 和 Agent 配置 说明从准备到验证的全过程。区分ccr与ccr-appCCR 有两个相关命令名字不能混用命令来源主要用途ccrnpm 包musistudio/claude-code-router不依赖 Electron提供浏览器管理界面和模型网关并按配置启动 Agentccr-appCCR 桌面应用桌面版生成的配置启动器Agent 配置卡片复制的命令使用这个名称两个发行版读取同一套本机配置目录macOS / Linux 在~/.claude-code-routerWindows 在%APPDATA%\claude-code-router。本文的命令都以 npm CLI 为准即ccr ...如果配置卡片复制出的是ccr-app 配置名称在 CLI 发行版里对应写成ccr 配置名称配置名称和可选的cli/app后缀保持一致。准备安装 CLI 并确保网关可用CLI 要求 Node.js 22 或更高版本node --version npm install -g musistudio/claude-code-router ccr --help安装成功但找不到命令时执行npm prefix -g确认 npm 全局可执行目录已加入PATH然后打开新终端。接着在后台启动 CCR 并打开管理界面SSH 或无桌面环境用ccr ui --no-openccr ui管理界面默认使用http://127.0.0.1:3458模型网关默认使用http://127.0.0.1:3456。在界面里按顺序完成添加供应商和至少一个模型在API 密钥页面创建 CCR 客户端 Key然后在服务页面确认网关已运行。大多数 Agent 配置要求 CCR 网关已经运行例外见下文管理 Token 与 CCR 客户端 Key 是两种独立凭据前者保护 UI / RPC后者验证模型请求。创建并启用 Agent 配置按 接入 Agent 配置 的流程操作在Agent 配置页面点击添加配置选择 Agent 类型填写配置名称名称可以有空格复制命令时 CCR 会自动加引号。选择作用范围与入口模式。试用阶段建议选仅从 CCR 打开时生效默认配置只影响从 CCR 启动的实例不会改动你系统里直接打开的 Agent。选择模型模型值通常是供应商名称/模型名称也可以选 Fusion 模型。保存。只有已启用的配置可以被ccr命令启动启用开关关闭后配置不会出现在启动入口中。用 ccr 命令启动实例启动命令的完整形态ccr 配置名称或 ID [cli|app] [-- Agent 参数]文档给出的示例ccr Codex - Work ccr Codex - Work app ccr Claude - Review cli -- --model sonnet ccr profile-id -- --help逐条规则如下cli/app是入口位置参数--cli和--app可以替代它。Agent 自己的参数放到--之后避免与 CCR 选项或入口名冲突。例如ccr Claude - Review cli -- --model sonnet中的--model sonnet会被透传给 Claude Code CLI而不是被 CCR 解析。省略入口时Claude Code、Codex、Grok CLI 默认使用 CLIZCode 默认使用 App。Grok CLI、Kimi CLI、Pi 和 Kilo 只支持 CLIZCode 和 Claude Design 只支持 App。Claude App 和 ZCode App 不支持额外 Agent 参数所以透传参数只对 CLI 入口的 Agent 有意义。启动 App 需要本机安装对应桌面应用并且当前环境有图形会话。名称产生歧义时使用配置 ID。CCR 会按 ID、名称、忽略大小写的名称和清理后的名称匹配多个结果匹配时必须使用 ID。关于网关依赖大多数配置要求 CCR 网关已经运行。Grok CLI、Kimi CLI 和 Pi 是例外——如果服务不存在它们可以自动启动一个受管的临时共享服务并在最后一个会话退出后关闭。验证启动结果按 Claude Code 接入与配置 的验证方法链路是否打通可以这样核对运行ccr 配置名称后在 Agent 中发送一条消息确认能正常回复。打开 CCR 的请求日志确认请求经过了 CCR 网关并核对最终命中的供应商 / 模型。查看前先到设置 → 日志与观测打开请求日志开关详见 开启日志与观测。注意普通请求日志只保留本地当天的数据进入第二天后下一次读取或写入时会清理前一天的记录。对 Claude Code CLI进入后输入/model确认 CCR 暴露的模型列表出现并确认透传的 Agent 参数如--model已生效。常见问题排查以下均出自 CLI 文档的常见问题一节找不到 Agent 配置确认配置已启用并检查名称是否重复多个结果匹配时必须使用配置 ID。提示启动器不存在先打开一次 CCR 或重新保存该 Agent 配置让 CCR 重新生成bin/下的启动包装器。UI 能打开但模型请求失败管理服务可以在没有可用模型网关时运行。添加供应商和模型、创建 CCR 客户端 Key然后从服务页面启动或重启网关用ccr serve查看启动错误因为前台运行的错误会直接输出到当前终端。Agent 没有走 CCR按 常见问题 的顺序检查——确认 CCR 服务正在运行、Agent 是从 CCR 启动的而不是直接打开的、Agent 配置已应用且作用范围覆盖当前场景。相关路径安装并启动 CCR三种发行方式与安装验证Agent 配置作用范围、入口模式、多开等配置项详解Claude Code 接入与配置Claude Code 专属字段与验证步骤【免费下载链接】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），仅供参考 Claude Code Router 如何用 ccr 命令按 Agent 配置启动实例并向 Agent 透传参数
Claude Code Router 如何用 ccr 命令按 Agent 配置启动实例并向 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如果你使用 npm 安装 Claude Code RouterCCR而不是桌面应用就需要用ccr命令完成两件事按Agent 配置中已保存的配置启动一个独立的 Agent 实例并把 Agent 自己的命令行参数原样透传给它。ccr 配置名称或 ID [cli|app] [-- Agent 参数]是这条路径的完整形态本文基于 CLI 安装与命令参考 和 Agent 配置 说明从准备到验证的全过程。区分ccr与ccr-appCCR 有两个相关命令名字不能混用命令来源主要用途ccrnpm 包musistudio/claude-code-router不依赖 Electron提供浏览器管理界面和模型网关并按配置启动 Agentccr-appCCR 桌面应用桌面版生成的配置启动器Agent 配置卡片复制的命令使用这个名称两个发行版读取同一套本机配置目录macOS / Linux 在~/.claude-code-routerWindows 在%APPDATA%\claude-code-router。本文的命令都以 npm CLI 为准即ccr ...如果配置卡片复制出的是ccr-app 配置名称在 CLI 发行版里对应写成ccr 配置名称配置名称和可选的cli/app后缀保持一致。准备安装 CLI 并确保网关可用CLI 要求 Node.js 22 或更高版本node --version npm install -g musistudio/claude-code-router ccr --help安装成功但找不到命令时执行npm prefix -g确认 npm 全局可执行目录已加入PATH然后打开新终端。接着在后台启动 CCR 并打开管理界面SSH 或无桌面环境用ccr ui --no-openccr ui管理界面默认使用http://127.0.0.1:3458模型网关默认使用http://127.0.0.1:3456。在界面里按顺序完成添加供应商和至少一个模型在API 密钥页面创建 CCR 客户端 Key然后在服务页面确认网关已运行。大多数 Agent 配置要求 CCR 网关已经运行例外见下文管理 Token 与 CCR 客户端 Key 是两种独立凭据前者保护 UI / RPC后者验证模型请求。创建并启用 Agent 配置按 接入 Agent 配置 的流程操作在Agent 配置页面点击添加配置选择 Agent 类型填写配置名称名称可以有空格复制命令时 CCR 会自动加引号。选择作用范围与入口模式。试用阶段建议选仅从 CCR 打开时生效默认配置只影响从 CCR 启动的实例不会改动你系统里直接打开的 Agent。选择模型模型值通常是供应商名称/模型名称也可以选 Fusion 模型。保存。只有已启用的配置可以被ccr命令启动启用开关关闭后配置不会出现在启动入口中。用 ccr 命令启动实例启动命令的完整形态ccr 配置名称或 ID [cli|app] [-- Agent 参数]文档给出的示例ccr Codex - Work ccr Codex - Work app ccr Claude - Review cli -- --model sonnet ccr profile-id -- --help逐条规则如下cli/app是入口位置参数--cli和--app可以替代它。Agent 自己的参数放到--之后避免与 CCR 选项或入口名冲突。例如ccr Claude - Review cli -- --model sonnet中的--model sonnet会被透传给 Claude Code CLI而不是被 CCR 解析。省略入口时Claude Code、Codex、Grok CLI 默认使用 CLIZCode 默认使用 App。Grok CLI、Kimi CLI、Pi 和 Kilo 只支持 CLIZCode 和 Claude Design 只支持 App。Claude App 和 ZCode App 不支持额外 Agent 参数所以透传参数只对 CLI 入口的 Agent 有意义。启动 App 需要本机安装对应桌面应用并且当前环境有图形会话。名称产生歧义时使用配置 ID。CCR 会按 ID、名称、忽略大小写的名称和清理后的名称匹配多个结果匹配时必须使用 ID。关于网关依赖大多数配置要求 CCR 网关已经运行。Grok CLI、Kimi CLI 和 Pi 是例外——如果服务不存在它们可以自动启动一个受管的临时共享服务并在最后一个会话退出后关闭。验证启动结果按 Claude Code 接入与配置 的验证方法链路是否打通可以这样核对运行ccr 配置名称后在 Agent 中发送一条消息确认能正常回复。打开 CCR 的请求日志确认请求经过了 CCR 网关并核对最终命中的供应商 / 模型。查看前先到设置 → 日志与观测打开请求日志开关详见 开启日志与观测。注意普通请求日志只保留本地当天的数据进入第二天后下一次读取或写入时会清理前一天的记录。对 Claude Code CLI进入后输入/model确认 CCR 暴露的模型列表出现并确认透传的 Agent 参数如--model已生效。常见问题排查以下均出自 CLI 文档的常见问题一节找不到 Agent 配置确认配置已启用并检查名称是否重复多个结果匹配时必须使用配置 ID。提示启动器不存在先打开一次 CCR 或重新保存该 Agent 配置让 CCR 重新生成bin/下的启动包装器。UI 能打开但模型请求失败管理服务可以在没有可用模型网关时运行。添加供应商和模型、创建 CCR 客户端 Key然后从服务页面启动或重启网关用ccr serve查看启动错误因为前台运行的错误会直接输出到当前终端。Agent 没有走 CCR按 常见问题 的顺序检查——确认 CCR 服务正在运行、Agent 是从 CCR 启动的而不是直接打开的、Agent 配置已应用且作用范围覆盖当前场景。相关路径安装并启动 CCR三种发行方式与安装验证Agent 配置作用范围、入口模式、多开等配置项详解Claude Code 接入与配置Claude Code 专属字段与验证步骤【免费下载链接】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），仅供参考