开始使用
多智能体框架
ZCode 采用多智能体框架架构，将自研 ZCode Agent 与多款主流命令行 AI 智能体整合到同一个桌面端体验中。您可以在应用内直接选择框架、配置模型、设定权限模式，并在同一个任务中持续推进开发，不需要在不同工具之间来回切换。
如何选择合适的智能体框架
创建任务时，可根据任务难度、项目类型和上下文形式选择最合适的智能体框架。默认建议从 ZCode Agent 开始；当任务需要某个外部框架的专长时，再切换到 Claude Code、Codex、Gemini CLI 或 OpenCode。
| Agent 框架 | 定位 | 适合场景 |
|---|---|---|
| ZCode Agent | ZCode 自研默认框架，与桌面端任务、模型、权限、文件引用和提交流深度集成 | 日常开发、需求拆解、多文件编辑、项目内连续任务 |
| Claude Code | Anthropic 的命令行编码智能体，长链路规划和跨文件推理能力强 | 架构重构、复杂多步骤修改、遗留系统升级 |
| Codex | OpenAI 的编码智能体，擅长代码诊断、Bug 修复和工程化执行 | Bug 定位、回归修复、测试补齐、深度问题排查 |
| Gemini CLI | Google 的命令行智能体，具备大上下文、多模态和前端实现优势 | 前端页面、设计稿转代码、大上下文代码阅读 |
| OpenCode | 开源智能体框架，轻量、可扩展，便于接入不同模型后端 | 开源项目、自定义模型、灵活工作流 |
ZCode Agent
ZCode Agent 是 ZCode 自研的默认智能体框架。它直接理解 ZCode 的工作区、任务列表、文件引用、模型选择、权限模式和 Git 分支状态，因此更适合承担从需求理解到代码修改再到提交前检查的一整条开发链路。
Claude Code
Claude Code 适合处理复杂项目里的长链路任务，例如跨模块重构、遗留逻辑梳理、架构调整和多文件变更。它在规划、分解步骤、维护上下文一致性方面表现突出。
Codex
Codex 适合做精确的代码诊断、Bug 修复、测试补齐和工程化问题排查。它对代码差异、错误栈、测试失败和边界条件通常比较敏感，适合围绕证据做最小必要修改。
Gemini CLI
Gemini CLI 适合前端实现、视觉到代码、大上下文阅读和多模态相关任务。它可以在需要阅读大量上下文、理解界面截图或快速生成页面结构时提供帮助。
OpenCode
OpenCode 是轻量灵活的开源智能体框架，适合需要自定义模型后端、接入开源工作流或保持工具链可扩展的场景。
切换智能体框架
在对话过程中，可以随时通过顶部菜单切换不同的智能体框架，无需重新创建任务。不同框架各有所长，灵活切换可以让您在同一个工作流中获得最佳的 AI 辅助效果。
工作流建议
- 日常开发优先用 ZCode Agent：它与 ZCode 的任务、模型、权限、文件引用和提交流结合最紧密。
- 复杂重构切换 Claude Code：当任务需要长链路规划、跨文件理解和持续推理时更合适。
- Bug 修复切换 Codex：当已有日志、复现路径或测试失败证据时，Codex 更适合做精准诊断。
- 前端与多模态任务切换 Gemini CLI：当任务涉及截图、界面实现、大上下文阅读时更高效。
- 自定义工作流切换 OpenCode：当需要开源框架、可扩展模型后端或更灵活执行链路时使用。