Hagicode
Hagicode
桌面版

Hagicode Desktop

本地化的 AI 代码助手，保护隐私，提升效率

正在加载版本信息...

打开版本历史页前往 Container 页面

若此页加载安装包失败，将自动跳转到 canonical 的 Index Desktop 版本历史页： https://index.hagicode.com/desktop/history/

核心功能

本地运行

所有数据本地处理，无需上传到云端，确保代码隐私安全

隐私保护

代码完全不上传，支持离线使用，保护你的知识产权

快速响应

毫秒级响应时间，无需等待网络请求，提升开发效率

跨平台支持

支持 Windows、macOS 和 Linux，满足不同开发环境需求

自动更新

自动检查更新，一键升级到最新版本，获取最新功能

多语言支持

内置中英文界面，支持国际化开发团队协作

系统要求

操作系统: Windows 10/11 (64-bit)

处理器: Intel Core i3 或同等性能处理器

内存: 4GB RAM (推荐 8GB)

磁盘空间: 2GB 可用空间

网络: 初始下载需要网络连接（后续可离线使用）

快速安装

1

下载安装包

根据你的操作系统选择对应的安装包

2

运行安装程序

双击下载的安装包，按照提示完成安装

3

启动应用

首次启动时会引导你完成初始配置

4

开始使用

配置完成后即可开始使用 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：在项目仓库提交问题报告