Claude Code Router 连接 Agent 配置完全指南为 Claude Code、Codex、Grok 等 7 款 Agent 创建启动 Profile【免费下载链接】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本篇指南围绕 claude-code-routerCCR的Agent Config连接 Agent 配置功能展开系统讲解如何为 Claude Code、Codex、Grok CLI、Kimi CLI、ZCode、WorkBuddy、OpenCode 等编码 Agent 创建 Profile让每一款 Agent 的请求都经过 CCR 网关统一走你的 Provider、路由规则与 Fusion 模型。读完本文你将掌握 Profile 的创建流程、Scope/Entry mode 等核心字段的语义、各 Agent 的启动命令ccr与ccr-app、模型切换方法/model以及如何通过 Request logs 验证请求确实经过网关。总体原则Profile 是什么怎么开始在Agent Config页面中核心操作是Add Profile添加配置文件选择一款 Agent、填写Profile name配置文件名称即可生成一条 CCR 管理的启动入口。之后通过该入口启动的 Agent 会话其模型请求会全部指向 CCR 网关从而复用你配置好的 Provider、路由策略和 Fusion 模型。有几个贯穿所有 Agent 的通用要点作用域Effect scope试用阶段建议保持默认的Only opened from CCR仅从 CCR 打开这样只有从 CCR 启动的 Agent 会话才会受影响确认稳定后再切换为System default系统默认让该 Profile 接管系统层面的 Agent 默认配置。入口模式Entry modeClaude Code 和 Codex 可以选择CLI APP同时暴露终端命令与应用按钮、CLI only仅生成 CLI 命令或App only仅暴露应用入口Grok CLI 与 Kimi CLI 固定为 CLI-onlyZCode 与 WorkBuddy 固定为 App-only。启动命令因发行形态而异桌面端CCR Desktop复制出来的是ccr-app ...命令CLI 端则使用ccr ...后面跟相同的 Profile 名称App 型 Agent 可追加app后缀如ccr ZCode - Work app。验证方式统一保存 Profile 后用其 Profile 卡片上的按钮启动 Agent终端按钮打开 CLI播放按钮打开应用发一条消息确认能收到回复然后在Request logs中确认该请求确实经过了 CCR 网关。从源码实现看这一套行为的底层支撑位于 packages/core/src/profiles/launch-core.tsprofileOpenSurfaces()按 Agent 类型决定可用的打开形态workbuddy、zcode、claude-design只返回appgrok、kimi、pi、kilo只返回cli其余按surface字段决定buildProfileLaunchPlan()则按 Agent 类型分发到对应的启动计划构造器。CLI 入口 packages/cli/src/cli.ts 中findProfileForOpen()负责按名称或 ID 精确查找启用的 Profile支持按 id、name、路径化名称模糊匹配resolveProfileOpenSurface()校验所选入口形态是否受该 Agent 支持随后才进入ensureProfileGateway()与buildProfileLaunchPlan()的启动流程。Claude CodeCLI 与 App 双形态Claude Code 同时支持CLI终端 Agent与App桌面应用两种形态适合希望把 Claude Code 路由到非 Anthropic Provider、固定某个模型、或运行多个相互隔离的 Claude Code 实例的场景。创建步骤Add Profile→ 选择Claude Code填写Profile name并选择Scope作用域与Entry mode入口模式。选择Model留空则沿用 Claude Code 自身的默认模型。保存然后用终端按钮打开 CLI或用播放按钮打开 Claude App。发一条消息确认能正常回复再到Request logs确认请求经过了网关在 CLI 中可用/model查看并切换 CCR 暴露的模型。关于分档模型tier models与高级设置参见 Claude Code setup and configuration。其中关键的进阶字段包括Model aliases模型别名Claude Code 按档位选择模型Model字段设置默认档位可选的Fable / Opus / Sonnet / Haiku model字段则逐个覆盖各档位例如让 Opus 档走强模型、Haiku 档保留低成本模型某档留空即交给 Claude Code 自行选择。CCR managed compact开启后由 CCR 接管该 Profile 的上下文压缩context compaction。Bot 绑定仅 App 入口支持用于将 AgentClaw 的 IM 机器人绑定到 Claude App 入口CLI 不会转发机器人消息。不同入口的模型列表来源也不同Claude Code CLI 走 CCR 网关的模型发现model discovery可用/model查看并切换 CCR 暴露的模型含 Fusion 模型Claude App 则使用 CCR 的模型列表。这一点在源码中也有印证buildClaudeCodeLaunchPlan()会为 CLI 入口注入CLAUDE_CONFIG_DIR指向该 Profile 专属的 settings.json 目录、CCR_PROFILE_SURFACE以及来自 packages/core/src/agents/claude-code/environment.ts 的模型环境变量Claude App 的打开则走 packages/core/src/agents/claude-app/launch.ts 的launchClaudeAppProfile()。常见问题排查请求没有到达 CCR确认 Profile 是Enabled且你是从 CCR而非系统启动的 Claude Code直接启动的 Claude Code 不受影响除非作用域为System default。/model看不到 CCR 模型确认已配置至少一个 Provider 模型。Claude App 未生效Claude App 可能已在运行请从 CCR 重新打开或按提示重启。CodexCodex CLI 与 ChatGPT 桌面应用Codex 同时支持Codex CLI终端 Agent与ChatGPT 桌面应用原 Codex 桌面应用两种形态适合把 Codex 路由到非 OpenAI Provider 或固定模型。创建步骤Add Profile→ 选择Codex填写Profile name选择Scope与Entry mode。确认Provider ID、Provider Name与Codex model。保存然后用终端按钮打开 CLI或用播放按钮打开 ChatGPT。发一条消息确认回复正常再到Request logs验证请求经过网关。Codex 特有的字段完整参考见 Codex setup and configuration字段说明Provider ID字母数字及.、_、-默认claude-code-router作为该 Codex Profile 的 Provider 引用请保持稳定Provider name自由文本默认Claude Code Router显示在 Codex 中Codex modelProvider 模型或 Fusion 模型留空时 CCR 使用第一个可用的默认模型Show all sessions写入show_all_sessions让 Codex 列出全部会话Codex CLI pathcodex不在PATH时填写二进制文件的绝对路径Codex home设置CODEX_HOME仅在需要指定独立 home 目录时填写Remote frontend modeapp/cli/claude-code无特殊原因保持默认CCR managed compact由 CCR 接管上下文压缩Codex 兼容类 Agentcodex、workbuddy、zcode在源码中共用同一套 Codex 启动计划buildCodexLaunchPlan()会基于providerId默认claude-code-router在bin/目录下生成ccr-codex-cli-stdio-slug中间件启动器并将CCR_PROFILE_SURFACE注入环境变量见 packages/core/src/profiles/launch-core.tsApp 形态则由 packages/core/src/agents/codex/app-launch.ts 负责打开。常见问题请求绕过 CCR确认 Profile 已Enabled且从 CCR 启动直接启动的 Codex 不受影响除非作用域为System default。ChatGPT 一直要求登录先正常登录 ChatGPT再从 CCR 重新打开。Provider ID 被拒绝只能使用字母、数字、点、下划线或连字符且多次保存间要保持一致。应用内模型不对检查Codex model字段留空时会回退到第一个可用默认模型。Grok CLI固定 CLI-only 的轻量接入Grok CLI 是 xAI 的编码 Agent在 CCR 中固定为CLI only且始终使用Only opened from CCR作用域——也就是说你本机的全局 Grok 配置不会被改动。创建步骤Add Profile→ 选择Grok CLI填写Profile name。选择Model。保存然后运行 Profile 卡片上的命令桌面端ccr-app profile-nameCLI 端ccr profile-name。在 Grok 中发一条消息确认回复正常再到Request logs验证请求经过网关在 Grok CLI 内可用/model切换 CCR 暴露的模型。Grok CLI 只有少量可配置字段完整参考见 Grok CLI setup and configurationAgent固定为 Grok CLI、Config name、Enabled 开关、Model以及可选的 Environment variables。由于作用域与入口均固定这两个字段不会出现在编辑界面中。源码层面buildGrokLaunchPlan()会在bin/下生成ccr-grok-cli-wrapper-slug启动包装器并注入CCR_PROFILE_SURFACE: cli同时shouldAutoStartProfileGateway()对 grok/kimi/pi 的 CLI 形态返回true意味着启动时会自动为 Profile 拉起独立网关见 packages/core/src/profiles/launch-core.ts。常见问题Grok 走了 xAI 账号而不是 CCR确认你是从 CCR 的 Profile 卡片启动的 Grok。grok命令找不到确保 Grok CLI 已安装并且与启动 CCR Desktop 的 shell 环境一致。/model看不到 CCR 模型确认 CCR 中已配置 Provider 模型。Kimi CLI默认模型 可切换模型列表Kimi CLI 是 Moonshot 的编码 Agent在 CCR 中固定为CLI only与Only opened from CCR。与 Grok 不同的是Kimi 支持配置一个默认模型与一个或多个 Available models可用模型从而在/model菜单中提供多模型切换。创建步骤Add Profile→ 选择Kimi CLI填写Profile name。选择Kimi model默认模型以及一个或多个Available models。保存然后运行 Profile 卡片命令桌面端ccr-app profile-nameCLI 端ccr profile-name。发一条消息确认回复正常到Request logs验证请求经过网关在 Kimi CLI 中可用/model在默认模型与可用模型之间切换每次切换后的请求仍会经过 CCR 的 Provider、路由与 Fusion。Kimi 的完整字段参考见 Kimi CLI setup and configuration。有两个容易踩的坑无法保存Kimi CLI 要求同时具备默认模型和至少一个可用模型默认模型本身计入可用模型。/model为空请至少添加一个Available model并确认 CCR 中已配置 Provider 模型。实现上buildKimiLaunchPlan()生成ccr-kimi-cli-wrapper-slug包装器与 Grok 一样属于会自动拉起 Profile 网关的 CLI-only 类型见 packages/core/src/profiles/launch-core.ts。ZCode固定 App-only由 CCR 打开桌面应用ZCode 是以桌面应用形态运行的编码 Agent在 CCR 中固定为App only入口模式不可编辑。创建步骤Add Profile→ 选择ZCode填写Profile name。确认ZCode model、Provider ID与Provider Name。保存然后用播放按钮从 CCR 打开 ZCode再次打开会激活已存在的窗口。发一条消息确认回复正常再到Request logs验证请求经过网关。ZCode 的字段参考见 ZCode setup and configuration。除基本字段外它还支持Effect scopeOnly opened from CCR/System default系统默认 Profile 每 Agent 仅允许一个、Config file、Environment variables以及Bot绑定。命令行形态上ZCode 的启动命令带有app后缀ccr-app ZCode - Work appCLI 端为ccr ZCode - Work app这与profileOpenCommand()的实现一致当surface app时会在命令尾部追加app参数见 packages/core/src/profiles/launch-core.ts。需要留意的是在 packages/cli/src/cli.ts 中ZCode 的 App 打开会直接调用launchZcodeAppProfile()且 ZCode Profile 不接受 Agent 参数ZCode profiles can only open the app; agent arguments are not supported.。常见问题请求绕过 CCR确认 Profile 已Enabled且从 CCR 打开 ZCode若已运行请从 CCR 重新打开。应用内模型不对检查ZCode model字段。Bot 中继掉线ZCode App 必须保持打开关闭应用会立即导致中继离线。WorkBuddyApp-only 与模型列表白名单WorkBuddy 在 CCR 中固定为App only入口模式不可编辑。创建步骤Add Profile→ 选择WorkBuddy填写Profile name。确认WorkBuddy model、Provider ID与Provider Name。可选地限制Allowed model list允许的模型列表留空表示 WorkBuddy 中可用全部 CCR 模型。保存然后用播放按钮打开 WorkBuddy。发一条消息确认回复正常再到Request logs验证请求经过网关。字段参考见 WorkBuddy setup and configuration。与 ZCode 相比WorkBuddy 多出两个实用字段Allowed model list可选多选。有选择时只写入这些模型为空时所有 CCR 模型可用选中的WorkBuddy model作为默认模型。APP_PATHCCR 无法自动探测到 WorkBuddy 时手动指定 WorkBuddy 可执行文件的路径。模型列表变更后需要从 CCR 重新打开 WorkBuddy如果 WorkBuddy 的设置窗口已打开请关闭并重新打开该窗口以刷新模型列表。启动命令同样带app后缀ccr-app WorkBuddy - Work appccr WorkBuddy - Work appWorkBuddy 与 ZCode 一样被归入 Codex 兼容 AgentisCodexCompatibleAgent()返回 true因此在源码中共享 Codex 启动计划与 Provider ID 机制见 packages/core/src/profiles/launch-core.ts其网关配置写入逻辑位于 packages/core/src/profiles/service.ts 的 Profile 应用流程中。常见问题只出现一个模型重新应用 WorkBuddy Profile 并从 CCR 重新打开Allowed model list为空时应能使用全部 CCR 模型。请求绕过 CCR确认 Profile 已Enabled且从 CCR 打开已运行则从 CCR 重新打开。WorkBuddy 未找到设置APP_PATH指向 WorkBuddy 可执行文件。OpenCodeCLI 与桌面应用双形态OpenCode 是一个采用 OpenAI 兼容 Provider 模型的编码 AgentCCR 同时支持OpenCode CLI与OpenCode 桌面应用。创建步骤Add Profile→ 选择OpenCode填写Profile name选择Scope与Entry mode。确认Provider ID、Provider Name与OpenCode model。保存然后用终端按钮打开 CLI或用播放按钮通过 CCR Desktop 打开 OpenCode 桌面应用。发一条消息确认回复正常再到Request logs验证请求经过网关。字段参考见 OpenCode setup and configuration。OpenCode 支持CLI APP/CLI only/App only三种入口模式、Effect scope、Provider ID/Provider name、OpenCode model、Config file、Environment variables与Bot仅 App 入口。注意 OpenCode 桌面应用是单实例的从 CCR 切换 Profile 时CCR 会为你切换当前生效的 Profile而不是再启动一个应用实例。启动命令示例ccr-app OpenCode - Workccr OpenCode - Work源码中buildOpenCodeLaunchPlan()仅支持 CLI 形态OpenCode App profiles must be opened through CCR Desktop.会注入OPENCODE_CONFIG环境变量指向由 packages/core/src/agents/opencode/profile-config.ts 解析出的 OpenCode 配置文件CLI 包装器为ccr-opencode-wrapper-slug见 packages/core/src/profiles/launch-core.ts。常见问题请求绕过 CCR确认 Profile 已Enabled且从 CCR 打开直接启动的 OpenCode 不受影响除非作用域为System default。opencode命令找不到确保 OpenCode CLI 已安装并与启动 CCR Desktop 的 shell 环境一致。应用未切换 ProfileOpenCode 桌面应用是单实例的请在 CCR 中切换 Profile。启动命令速查与验证闭环综合各 Agent 的差异可将启动命令归纳为如下速查表Agent形态桌面命令从卡片复制CLI 命令Claude CodeCLI Appccr-app Claude Code - Workccr Claude Code - WorkCodexCLI Appccr-app Codex - Workccr Codex - WorkGrok CLICLI onlyccr-app Grok - Workccr Grok - WorkKimi CLICLI onlyccr-app Kimi - Workccr Kimi - WorkZCodeApp onlyccr-app ZCode - Work appccr ZCode - Work appWorkBuddyApp onlyccr-app WorkBuddy - Work appccr WorkBuddy - Work appOpenCodeCLI Appccr-app OpenCode - Workccr OpenCode - Work这些命令中的app后缀、引号规则以及 Windows 下的.cmd包装器逻辑均来自profileOpenCommand()与profileLaunchSpawnCommand()的实现见 packages/core/src/profiles/launch-core.ts非 Windows 平台使用 POSIX 引号Windows 平台通过cmd.exe /d /v:off /c执行.cmd/.bat脚本。每次接入新的 Agent 后建议按以下闭环验证从 CCR 的 Profile 卡片启动 Agent终端按钮或播放按钮。发送一条消息并确认 Agent 正常回复。打开Request logs确认该请求经过了 CCR 网关并查看实际使用的 Provider 与模型。对支持/model的 CLIClaude Code、Grok、Kimi 等执行/model确认 CCR 暴露的模型列表已出现。常见问题汇总请求绕过 CCR / 未出现在 Request logs绝大多数情况是 Profile 未Enabled或 Agent 不是从 CCR 启动的仅当作用域为System default时直接启动的 Agent 才会受 Profile 影响。/model中看不到 CCR 模型先确认 CCR 中已配置至少一个 Provider 模型且该 Agent 的启动形态确实由 CCR 管理Grok/Kimi 需要从 Profile 卡片命令启动。命令找不到对应的 Agent 可执行文件确保 Agent CLI 已安装并且与启动 CCR Desktop 时相同的 shell 环境中可用WorkBuddy 等应用可显式配置APP_PATH。应用形态未生效或未切换 Profile多数桌面应用是单实例的请从 CCR 重新打开或直接切换 Profile。模型固定不住对 Claude Code 检查分档模型别名对 Codex/WorkBuddy/ZCode 检查对应模型字段与Allowed model list。如果某个 Agent 的字段释义或高级主题多实例、Bot 绑定、AgentClaw IM 接力需要进一步深入可以继续阅读对应配置文档Claude Code配置文档、Codex配置文档、Grok配置文档、Kimi配置文档、ZCode配置文档、WorkBuddy配置文档、OpenCode配置文档。【免费下载链接】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 连接 Agent 配置完全指南：为 Claude Code、Codex、Grok 等 7 款 Agent 创建启动 Profile
Claude Code Router 连接 Agent 配置完全指南为 Claude Code、Codex、Grok 等 7 款 Agent 创建启动 Profile【免费下载链接】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本篇指南围绕 claude-code-routerCCR的Agent Config连接 Agent 配置功能展开系统讲解如何为 Claude Code、Codex、Grok CLI、Kimi CLI、ZCode、WorkBuddy、OpenCode 等编码 Agent 创建 Profile让每一款 Agent 的请求都经过 CCR 网关统一走你的 Provider、路由规则与 Fusion 模型。读完本文你将掌握 Profile 的创建流程、Scope/Entry mode 等核心字段的语义、各 Agent 的启动命令ccr与ccr-app、模型切换方法/model以及如何通过 Request logs 验证请求确实经过网关。总体原则Profile 是什么怎么开始在Agent Config页面中核心操作是Add Profile添加配置文件选择一款 Agent、填写Profile name配置文件名称即可生成一条 CCR 管理的启动入口。之后通过该入口启动的 Agent 会话其模型请求会全部指向 CCR 网关从而复用你配置好的 Provider、路由策略和 Fusion 模型。有几个贯穿所有 Agent 的通用要点作用域Effect scope试用阶段建议保持默认的Only opened from CCR仅从 CCR 打开这样只有从 CCR 启动的 Agent 会话才会受影响确认稳定后再切换为System default系统默认让该 Profile 接管系统层面的 Agent 默认配置。入口模式Entry modeClaude Code 和 Codex 可以选择CLI APP同时暴露终端命令与应用按钮、CLI only仅生成 CLI 命令或App only仅暴露应用入口Grok CLI 与 Kimi CLI 固定为 CLI-onlyZCode 与 WorkBuddy 固定为 App-only。启动命令因发行形态而异桌面端CCR Desktop复制出来的是ccr-app ...命令CLI 端则使用ccr ...后面跟相同的 Profile 名称App 型 Agent 可追加app后缀如ccr ZCode - Work app。验证方式统一保存 Profile 后用其 Profile 卡片上的按钮启动 Agent终端按钮打开 CLI播放按钮打开应用发一条消息确认能收到回复然后在Request logs中确认该请求确实经过了 CCR 网关。从源码实现看这一套行为的底层支撑位于 packages/core/src/profiles/launch-core.tsprofileOpenSurfaces()按 Agent 类型决定可用的打开形态workbuddy、zcode、claude-design只返回appgrok、kimi、pi、kilo只返回cli其余按surface字段决定buildProfileLaunchPlan()则按 Agent 类型分发到对应的启动计划构造器。CLI 入口 packages/cli/src/cli.ts 中findProfileForOpen()负责按名称或 ID 精确查找启用的 Profile支持按 id、name、路径化名称模糊匹配resolveProfileOpenSurface()校验所选入口形态是否受该 Agent 支持随后才进入ensureProfileGateway()与buildProfileLaunchPlan()的启动流程。Claude CodeCLI 与 App 双形态Claude Code 同时支持CLI终端 Agent与App桌面应用两种形态适合希望把 Claude Code 路由到非 Anthropic Provider、固定某个模型、或运行多个相互隔离的 Claude Code 实例的场景。创建步骤Add Profile→ 选择Claude Code填写Profile name并选择Scope作用域与Entry mode入口模式。选择Model留空则沿用 Claude Code 自身的默认模型。保存然后用终端按钮打开 CLI或用播放按钮打开 Claude App。发一条消息确认能正常回复再到Request logs确认请求经过了网关在 CLI 中可用/model查看并切换 CCR 暴露的模型。关于分档模型tier models与高级设置参见 Claude Code setup and configuration。其中关键的进阶字段包括Model aliases模型别名Claude Code 按档位选择模型Model字段设置默认档位可选的Fable / Opus / Sonnet / Haiku model字段则逐个覆盖各档位例如让 Opus 档走强模型、Haiku 档保留低成本模型某档留空即交给 Claude Code 自行选择。CCR managed compact开启后由 CCR 接管该 Profile 的上下文压缩context compaction。Bot 绑定仅 App 入口支持用于将 AgentClaw 的 IM 机器人绑定到 Claude App 入口CLI 不会转发机器人消息。不同入口的模型列表来源也不同Claude Code CLI 走 CCR 网关的模型发现model discovery可用/model查看并切换 CCR 暴露的模型含 Fusion 模型Claude App 则使用 CCR 的模型列表。这一点在源码中也有印证buildClaudeCodeLaunchPlan()会为 CLI 入口注入CLAUDE_CONFIG_DIR指向该 Profile 专属的 settings.json 目录、CCR_PROFILE_SURFACE以及来自 packages/core/src/agents/claude-code/environment.ts 的模型环境变量Claude App 的打开则走 packages/core/src/agents/claude-app/launch.ts 的launchClaudeAppProfile()。常见问题排查请求没有到达 CCR确认 Profile 是Enabled且你是从 CCR而非系统启动的 Claude Code直接启动的 Claude Code 不受影响除非作用域为System default。/model看不到 CCR 模型确认已配置至少一个 Provider 模型。Claude App 未生效Claude App 可能已在运行请从 CCR 重新打开或按提示重启。CodexCodex CLI 与 ChatGPT 桌面应用Codex 同时支持Codex CLI终端 Agent与ChatGPT 桌面应用原 Codex 桌面应用两种形态适合把 Codex 路由到非 OpenAI Provider 或固定模型。创建步骤Add Profile→ 选择Codex填写Profile name选择Scope与Entry mode。确认Provider ID、Provider Name与Codex model。保存然后用终端按钮打开 CLI或用播放按钮打开 ChatGPT。发一条消息确认回复正常再到Request logs验证请求经过网关。Codex 特有的字段完整参考见 Codex setup and configuration字段说明Provider ID字母数字及.、_、-默认claude-code-router作为该 Codex Profile 的 Provider 引用请保持稳定Provider name自由文本默认Claude Code Router显示在 Codex 中Codex modelProvider 模型或 Fusion 模型留空时 CCR 使用第一个可用的默认模型Show all sessions写入show_all_sessions让 Codex 列出全部会话Codex CLI pathcodex不在PATH时填写二进制文件的绝对路径Codex home设置CODEX_HOME仅在需要指定独立 home 目录时填写Remote frontend modeapp/cli/claude-code无特殊原因保持默认CCR managed compact由 CCR 接管上下文压缩Codex 兼容类 Agentcodex、workbuddy、zcode在源码中共用同一套 Codex 启动计划buildCodexLaunchPlan()会基于providerId默认claude-code-router在bin/目录下生成ccr-codex-cli-stdio-slug中间件启动器并将CCR_PROFILE_SURFACE注入环境变量见 packages/core/src/profiles/launch-core.tsApp 形态则由 packages/core/src/agents/codex/app-launch.ts 负责打开。常见问题请求绕过 CCR确认 Profile 已Enabled且从 CCR 启动直接启动的 Codex 不受影响除非作用域为System default。ChatGPT 一直要求登录先正常登录 ChatGPT再从 CCR 重新打开。Provider ID 被拒绝只能使用字母、数字、点、下划线或连字符且多次保存间要保持一致。应用内模型不对检查Codex model字段留空时会回退到第一个可用默认模型。Grok CLI固定 CLI-only 的轻量接入Grok CLI 是 xAI 的编码 Agent在 CCR 中固定为CLI only且始终使用Only opened from CCR作用域——也就是说你本机的全局 Grok 配置不会被改动。创建步骤Add Profile→ 选择Grok CLI填写Profile name。选择Model。保存然后运行 Profile 卡片上的命令桌面端ccr-app profile-nameCLI 端ccr profile-name。在 Grok 中发一条消息确认回复正常再到Request logs验证请求经过网关在 Grok CLI 内可用/model切换 CCR 暴露的模型。Grok CLI 只有少量可配置字段完整参考见 Grok CLI setup and configurationAgent固定为 Grok CLI、Config name、Enabled 开关、Model以及可选的 Environment variables。由于作用域与入口均固定这两个字段不会出现在编辑界面中。源码层面buildGrokLaunchPlan()会在bin/下生成ccr-grok-cli-wrapper-slug启动包装器并注入CCR_PROFILE_SURFACE: cli同时shouldAutoStartProfileGateway()对 grok/kimi/pi 的 CLI 形态返回true意味着启动时会自动为 Profile 拉起独立网关见 packages/core/src/profiles/launch-core.ts。常见问题Grok 走了 xAI 账号而不是 CCR确认你是从 CCR 的 Profile 卡片启动的 Grok。grok命令找不到确保 Grok CLI 已安装并且与启动 CCR Desktop 的 shell 环境一致。/model看不到 CCR 模型确认 CCR 中已配置 Provider 模型。Kimi CLI默认模型 可切换模型列表Kimi CLI 是 Moonshot 的编码 Agent在 CCR 中固定为CLI only与Only opened from CCR。与 Grok 不同的是Kimi 支持配置一个默认模型与一个或多个 Available models可用模型从而在/model菜单中提供多模型切换。创建步骤Add Profile→ 选择Kimi CLI填写Profile name。选择Kimi model默认模型以及一个或多个Available models。保存然后运行 Profile 卡片命令桌面端ccr-app profile-nameCLI 端ccr profile-name。发一条消息确认回复正常到Request logs验证请求经过网关在 Kimi CLI 中可用/model在默认模型与可用模型之间切换每次切换后的请求仍会经过 CCR 的 Provider、路由与 Fusion。Kimi 的完整字段参考见 Kimi CLI setup and configuration。有两个容易踩的坑无法保存Kimi CLI 要求同时具备默认模型和至少一个可用模型默认模型本身计入可用模型。/model为空请至少添加一个Available model并确认 CCR 中已配置 Provider 模型。实现上buildKimiLaunchPlan()生成ccr-kimi-cli-wrapper-slug包装器与 Grok 一样属于会自动拉起 Profile 网关的 CLI-only 类型见 packages/core/src/profiles/launch-core.ts。ZCode固定 App-only由 CCR 打开桌面应用ZCode 是以桌面应用形态运行的编码 Agent在 CCR 中固定为App only入口模式不可编辑。创建步骤Add Profile→ 选择ZCode填写Profile name。确认ZCode model、Provider ID与Provider Name。保存然后用播放按钮从 CCR 打开 ZCode再次打开会激活已存在的窗口。发一条消息确认回复正常再到Request logs验证请求经过网关。ZCode 的字段参考见 ZCode setup and configuration。除基本字段外它还支持Effect scopeOnly opened from CCR/System default系统默认 Profile 每 Agent 仅允许一个、Config file、Environment variables以及Bot绑定。命令行形态上ZCode 的启动命令带有app后缀ccr-app ZCode - Work appCLI 端为ccr ZCode - Work app这与profileOpenCommand()的实现一致当surface app时会在命令尾部追加app参数见 packages/core/src/profiles/launch-core.ts。需要留意的是在 packages/cli/src/cli.ts 中ZCode 的 App 打开会直接调用launchZcodeAppProfile()且 ZCode Profile 不接受 Agent 参数ZCode profiles can only open the app; agent arguments are not supported.。常见问题请求绕过 CCR确认 Profile 已Enabled且从 CCR 打开 ZCode若已运行请从 CCR 重新打开。应用内模型不对检查ZCode model字段。Bot 中继掉线ZCode App 必须保持打开关闭应用会立即导致中继离线。WorkBuddyApp-only 与模型列表白名单WorkBuddy 在 CCR 中固定为App only入口模式不可编辑。创建步骤Add Profile→ 选择WorkBuddy填写Profile name。确认WorkBuddy model、Provider ID与Provider Name。可选地限制Allowed model list允许的模型列表留空表示 WorkBuddy 中可用全部 CCR 模型。保存然后用播放按钮打开 WorkBuddy。发一条消息确认回复正常再到Request logs验证请求经过网关。字段参考见 WorkBuddy setup and configuration。与 ZCode 相比WorkBuddy 多出两个实用字段Allowed model list可选多选。有选择时只写入这些模型为空时所有 CCR 模型可用选中的WorkBuddy model作为默认模型。APP_PATHCCR 无法自动探测到 WorkBuddy 时手动指定 WorkBuddy 可执行文件的路径。模型列表变更后需要从 CCR 重新打开 WorkBuddy如果 WorkBuddy 的设置窗口已打开请关闭并重新打开该窗口以刷新模型列表。启动命令同样带app后缀ccr-app WorkBuddy - Work appccr WorkBuddy - Work appWorkBuddy 与 ZCode 一样被归入 Codex 兼容 AgentisCodexCompatibleAgent()返回 true因此在源码中共享 Codex 启动计划与 Provider ID 机制见 packages/core/src/profiles/launch-core.ts其网关配置写入逻辑位于 packages/core/src/profiles/service.ts 的 Profile 应用流程中。常见问题只出现一个模型重新应用 WorkBuddy Profile 并从 CCR 重新打开Allowed model list为空时应能使用全部 CCR 模型。请求绕过 CCR确认 Profile 已Enabled且从 CCR 打开已运行则从 CCR 重新打开。WorkBuddy 未找到设置APP_PATH指向 WorkBuddy 可执行文件。OpenCodeCLI 与桌面应用双形态OpenCode 是一个采用 OpenAI 兼容 Provider 模型的编码 AgentCCR 同时支持OpenCode CLI与OpenCode 桌面应用。创建步骤Add Profile→ 选择OpenCode填写Profile name选择Scope与Entry mode。确认Provider ID、Provider Name与OpenCode model。保存然后用终端按钮打开 CLI或用播放按钮通过 CCR Desktop 打开 OpenCode 桌面应用。发一条消息确认回复正常再到Request logs验证请求经过网关。字段参考见 OpenCode setup and configuration。OpenCode 支持CLI APP/CLI only/App only三种入口模式、Effect scope、Provider ID/Provider name、OpenCode model、Config file、Environment variables与Bot仅 App 入口。注意 OpenCode 桌面应用是单实例的从 CCR 切换 Profile 时CCR 会为你切换当前生效的 Profile而不是再启动一个应用实例。启动命令示例ccr-app OpenCode - Workccr OpenCode - Work源码中buildOpenCodeLaunchPlan()仅支持 CLI 形态OpenCode App profiles must be opened through CCR Desktop.会注入OPENCODE_CONFIG环境变量指向由 packages/core/src/agents/opencode/profile-config.ts 解析出的 OpenCode 配置文件CLI 包装器为ccr-opencode-wrapper-slug见 packages/core/src/profiles/launch-core.ts。常见问题请求绕过 CCR确认 Profile 已Enabled且从 CCR 打开直接启动的 OpenCode 不受影响除非作用域为System default。opencode命令找不到确保 OpenCode CLI 已安装并与启动 CCR Desktop 的 shell 环境一致。应用未切换 ProfileOpenCode 桌面应用是单实例的请在 CCR 中切换 Profile。启动命令速查与验证闭环综合各 Agent 的差异可将启动命令归纳为如下速查表Agent形态桌面命令从卡片复制CLI 命令Claude CodeCLI Appccr-app Claude Code - Workccr Claude Code - WorkCodexCLI Appccr-app Codex - Workccr Codex - WorkGrok CLICLI onlyccr-app Grok - Workccr Grok - WorkKimi CLICLI onlyccr-app Kimi - Workccr Kimi - WorkZCodeApp onlyccr-app ZCode - Work appccr ZCode - Work appWorkBuddyApp onlyccr-app WorkBuddy - Work appccr WorkBuddy - Work appOpenCodeCLI Appccr-app OpenCode - Workccr OpenCode - Work这些命令中的app后缀、引号规则以及 Windows 下的.cmd包装器逻辑均来自profileOpenCommand()与profileLaunchSpawnCommand()的实现见 packages/core/src/profiles/launch-core.ts非 Windows 平台使用 POSIX 引号Windows 平台通过cmd.exe /d /v:off /c执行.cmd/.bat脚本。每次接入新的 Agent 后建议按以下闭环验证从 CCR 的 Profile 卡片启动 Agent终端按钮或播放按钮。发送一条消息并确认 Agent 正常回复。打开Request logs确认该请求经过了 CCR 网关并查看实际使用的 Provider 与模型。对支持/model的 CLIClaude Code、Grok、Kimi 等执行/model确认 CCR 暴露的模型列表已出现。常见问题汇总请求绕过 CCR / 未出现在 Request logs绝大多数情况是 Profile 未Enabled或 Agent 不是从 CCR 启动的仅当作用域为System default时直接启动的 Agent 才会受 Profile 影响。/model中看不到 CCR 模型先确认 CCR 中已配置至少一个 Provider 模型且该 Agent 的启动形态确实由 CCR 管理Grok/Kimi 需要从 Profile 卡片命令启动。命令找不到对应的 Agent 可执行文件确保 Agent CLI 已安装并且与启动 CCR Desktop 时相同的 shell 环境中可用WorkBuddy 等应用可显式配置APP_PATH。应用形态未生效或未切换 Profile多数桌面应用是单实例的请从 CCR 重新打开或直接切换 Profile。模型固定不住对 Claude Code 检查分档模型别名对 Codex/WorkBuddy/ZCode 检查对应模型字段与Allowed model list。如果某个 Agent 的字段释义或高级主题多实例、Bot 绑定、AgentClaw IM 接力需要进一步深入可以继续阅读对应配置文档Claude Code配置文档、Codex配置文档、Grok配置文档、Kimi配置文档、ZCode配置文档、WorkBuddy配置文档、OpenCode配置文档。【免费下载链接】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），仅供参考