【免费下载链接】routaWorkspace-first multi-agent coordination platform for AI development, with shared Specs, Kanban orchestration, and MCP/ACP/ A2A support across web and desktop.项目地址https://gitcode.com/gh_mirrors/ro/routa点击查看免费下载Routa 是一个 Workspace-first 的多智能体协作平台支持通过统一的 Providers 配置接入 Claude Code、Codex、OpenCode 等主流 AI 编程 Agent让多模型在 Web 与桌面端无缝协同工作。本文带你用最少的步骤完成第一个 Provider 的接入理解「一个可用的 Provider 就足够上手」的核心理念。为什么 Provider 配置如此简单Routa 的设计哲学是所有 Agent 运行时都通过 ACPAgent Client Protocol做统一归一化你不需要为每个模型单独写胶水代码。官方建议的路径非常清晰——docs/configuration/providers-and-models.md 中给出的推荐顺序是在Providers中让一个 Provider 可用如有需要在Models中创建一个模型别名在Role Defaults中把该 Provider/模型绑定到角色回到工作区启动一个 Session 实用规则不需要配置所有 Provider一个能跑通的就足够开始使用了。四大配置面板一次看懂在 Routa 的设置界面中Provider 配置分布在四个面板各司其职面板职责Providers可用运行时、可见性与 Provider 专属凭据Registry可安装的 ACP Agent 列表Role Defaults每个角色ROUTA / CRAFTER / GATE / DEVELOPER的默认 Provider 与模型Models带 Base URL 与 API Key 的模型别名内置 Provider 类型三大主力当前内置的常见 Provider 选项包括来源docs/configuration/providers-and-models.mdClaude Code—— 通过 SDK 的 stream-json 协议接入 Claude 系列模型OpenCode / OpenCode SDK—— 原生 ACP 运行时也支持连接远程 OpenCode 服务器Codex—— 通过 API Key 启用 Codex 流程各 Provider 的命令行预置与能力元数据定义在 src/core/acp/acp-presets.ts而 Web 端的 Provider 列表接口则在 src/app/api/providers/route.ts 实现本地 Provider 可毫秒级返回、Registry 异步加载界面不会卡住。最快配置方法环境变量一览不同运行方式对应不同的凭据注入方式最常用的环境变量如下完整清单见 docs/configuration/environment-variables.md环境变量作用ANTHROPIC_API_KEY/ANTHROPIC_AUTH_TOKEN启用 AnthropicClaude Code执行路径OPENAI_API_KEY启用 OpenAI 系模型CODEX_API_KEY启用 Codex 流程OPENCODE_SERVER_URL/OPENCODE_API_KEY启用 OpenCode SDK 远程执行ROUTA_RUST_BACKEND_URLWeb 端指向本地后端服务器实践建议只设置你实际使用的那条 Provider 路径对应的变量即可。️ 桌面用户通常在应用内直接填入 Provider 专属凭据 CLI 用户通常全局配置一个 Provider Web 贡献者本地开发时设置ROUTA_RUST_BACKEND_URLAPI 型 Provider 的自动探测逻辑如检测到ANTHROPIC_AUTH_TOKEN即标记为 available位于 src/core/acp/api-based-providers.ts。验证接入是否成功跑通第一个 Session配置完成后最短验证路径来自 docs/quick-start.md创建 Workspace 并启用一个 Provider挂载一个真实代码仓库打开 Session提问Explain the architecture of this repository如果得到了有用的回答你的 Provider 配置就已经成功。CLI 用户同样可以用一行命令做冒烟测试routa -p Explain the architecture of this repository还可以用以下命令检查运行时状态routa acp list routa acp runtime-status多模型协同的原理Provider 归一化理解这一点能帮你少走弯路Routa 通过每个 Provider 的独立 Adapter 层把 Claude Code、OpenCode 等不同事件流统一归一为 ACP 会话更新设计决策见 docs/adr/0002-provider-normalization-via-acp.md。Provider 进程或桥接层 → 各 Provider 私有输出 → Adapter 归一化 → 统一会话更新 → 持久化、Trace、UI 流式渲染因此「哪个模型跑哪个角色」是 Provider 层的事而角色默认值Role Defaults绑定发生在配置层——这正是你能一站式切换 Claude Code、Codex、OpenCode 的底层保障。常见问题速查Q装了多个 Provider界面显示不可用先确认对应环境变量已注入。API 型 Provider 只有在检测到 Key 或 Server URL 时才会标记为available逻辑见 src/core/acp/api-based-providers.ts。QServerless 环境能用 CLI 型 Provider 吗不能。像 Codex 这类需要派生长驻子进程的 CLI Provider 在 Vercel 等 Serverless 环境不可用建议改用 Claude Code SDK 或 OpenCode SDK 这类 HTTP API 路径同样定义在 src/core/acp/api-based-providers.ts。Q需要配置所有 Provider 吗不需要。一个可用的 Provider 一条可用的模型路径就是完整上手所需的全部。小结Routa 的 Providers 配置遵循「先跑通一个再扩展更多」的原则✅ 在Providers中启用一个运行时Claude Code / Codex / OpenCode✅ 按需配置Models与Role Defaults完成角色绑定✅ 用一次真实仓库的 Session 提问验证结果掌握这套流程后你就可以在多模型协同的工作流中自由切换 Provider把 AI 开发协作的复杂度降到最低。赞分享【免费下载链接】routaWorkspace-first multi-agent coordination platform for AI development, with shared Specs, Kanban orchestration, and MCP/ACP/ A2A support across web and desktop.项目地址https://gitcode.com/gh_mirrors/ro/routa点击查看免费下载相关推荐CCX 客户端接入指南Claude Code / Claude Desktop / Codex / OpenCode 统一配置手册CCX 客户端接入指南Claude Code / Claude Desktop / Codex / OpenCode 统一配置手册 本篇技术指南以 客户端接入API网关LLM 网关后端CCX 客户端接入总览Claude Code / Claude Desktop / Codex / OpenCode 网关配置实战指南CCX 客户端接入总览Claude Code / Claude Desktop / Codex / OpenCode 网关配置实战指南 CCXClaudeAPI网关LLM 网关后端Sequoia-X A股自动选股拆解4个阈值筛出猛火收汁股收盘后全市场扫描只要3分钟Sequoia X A股自动选股拆解4个阈值筛出猛火收汁股收盘后全市场扫描只要3分钟 追高三次套三次割肉后它横盘一周再拉升——这种拉升前的停顿是手金融科技数据分析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考