Hagicode Desktop
本地化的 AI 代码助手,保护隐私,提升效率
正在加载版本信息...
若此页加载安装包失败,将自动跳转到 canonical 的 Index Desktop 版本历史页: https://index.hagicode.com/desktop/history/
核心功能
本地运行
所有数据本地处理,无需上传到云端,确保代码隐私安全
隐私保护
代码完全不上传,支持离线使用,保护你的知识产权
快速响应
毫秒级响应时间,无需等待网络请求,提升开发效率
跨平台支持
支持 Windows、macOS 和 Linux,满足不同开发环境需求
自动更新
自动检查更新,一键升级到最新版本,获取最新功能
多语言支持
内置中英文界面,支持国际化开发团队协作
系统要求
操作系统: Windows 10/11 (64-bit)
处理器: Intel Core i3 或同等性能处理器
内存: 4GB RAM (推荐 8GB)
磁盘空间: 2GB 可用空间
网络: 初始下载需要网络连接(后续可离线使用)
操作系统: macOS 12+ (Monterey 或更高版本)
处理器: Apple Silicon (M1/M2/M3) 或 Intel Core i3+
内存: 4GB RAM (推荐 8GB)
磁盘空间: 2GB 可用空间
网络: 初始下载需要网络连接(后续可离线使用)
操作系统: Ubuntu 20.04+ / Debian 11+ / 其他主流发行版
处理器: Intel Core i3 或同等性能处理器
内存: 4GB RAM (推荐 8GB)
磁盘空间: 2GB 可用空间
网络: 初始下载需要网络连接(后续可离线使用)
快速安装
下载安装包
根据你的操作系统选择对应的安装包
运行安装程序
双击下载的安装包,按照提示完成安装
启动应用
首次启动时会引导你完成初始配置
开始使用
配置完成后即可开始使用 Hagicode Desktop
常见问题
Desktop 版本和 Server 版本有什么区别?
Hagicode 提供两种部署方式:Desktop 版本和 Server 版本。两种版本各有优势,但都采用用户自主管理服务器和数据的方式,因此都具备更好的数据保护特性。
Desktop 版本
- 在本地电脑上运行,更加轻便
- 无需配置服务器,开箱即用
- 适合个人开发者和轻量使用场景
- 所有数据完全本地化
Server 版本
- 可部署在远程服务器上
- 支持多用户远程访问
- 更适合团队协作和广泛扩展
- 为未来的企业级功能和多设备同步做准备
无论选择哪种版本,你都完全掌控自己的服务器和数据,享受更好的隐私保护和数据安全。
安装后还需要做什么?
Hagicode Desktop 本质上是一个启动器,安装完成后首次启动时,它会引导你完成以下步骤:
- 下载 Hagicode Core: Desktop 会自动检测并提示下载 Hagicode 核心组件
- 安装核心组件: 按照界面提示完成核心组件的安装
- 配置默认 Agent CLI: 选择当前支持的 Agent CLI,并完成对应的登录、授权或本地安装。
整个过程在 Desktop 界面中都有清晰的提示指引。首次启动请保持网络连接以完成核心组件下载;部分 Agent CLI 还需要手动安装或认证,但这不影响它们属于当前支持范围。
完成这些步骤后,你就可以正常使用 Hagicode Desktop 的所有功能了。
如何检查更新?
Desktop 会自动检查更新。当有新版本可用时,会在界面右上角显示提示。你也可以在"设置"中手动检查更新。
支持哪些 AI Agent CLI?
Hagicode Desktop 当前活跃支持以下 Agent CLI:
- 当前活跃支持:Claude Code、Codex、GitHub Copilot、OpenCode、Hermes、QoderCLI、Kiro、Kimi、Gemini、DeepAgents、Codebuddy
- 手动安装或认证:Hermes、Gemini、DeepAgents 需要先完成本地安装或认证;其余 CLI 提供一键安装入口或引导安装流程。
- 历史兼容:IFlowCli 仅保留给旧数据兼容,不属于当前活跃支持范围。
是否支持,与是否提供一键安装,是两件事。某个 CLI 需要手动安装,并不表示它尚未支持。
是否支持离线使用?
是的!Hagicode Desktop 支持完全离线使用:
- 首次安装和配置需要网络连接(下载核心组件和 AI 模型)
- 配置完成后可断网使用所有功能
- 你的代码和数据永远不会上传到云端
- 所有 AI 处理都在本地完成
macOS 提示应用已损坏或无法打开,怎么办?
如果你已经将 Hagicode Desktop 安装到默认路径 /Applications/Hagicode.app,但首次启动时被 macOS Gatekeeper 拦截,常见原因是系统为从互联网下载的应用附加了 com.apple.quarantine 隔离属性。
这属于 macOS 的安全隔离机制,不是 Hagicode 安装向导下载失败或应用本体缺失。
sudo xattr -dr com.apple.quarantine /Applications/Hagicode.app 请在终端中以管理员权限执行这条命令。执行完成后,重新启动 Hagicode Desktop 即可。
遇到问题如何获取帮助?
如果你在使用 Hagicode Desktop 时遇到问题,可以通过以下方式获取帮助:
- 技术支持群:加入 QQ 群 610394020
- 在线文档:查看完整的使用文档和教程
- GitHub Issues:在项目仓库提交问题报告