跳到正文
智码 AICoder
智码 AICoder
免费下载
Gitee 198 6657 9313
Esc
本栏目菜单

安装指南

系统要求

要求 最低版本
Windows Windows 10 (x64)
macOS macOS 12 Monterey
Linux x86_64；Debian / Ubuntu 系推荐 .deb，.AppImage 仅适合 Ubuntu 22.04 一带
磁盘空间 约 200 MB
AI CLI 工具 Claude Code / Codex / heng-agent 等十家 AI 编程 CLI（至少一个）

Windows 安装

  1. 从 下载页面 获取 .exe 安装程序
  2. 双击运行安装程序
  3. 选择安装语言（中文 / 英文）
  4. 选择安装模式：
    • 仅当前用户：安装到用户目录，无需管理员权限
    • 所有用户：安装到 Program Files，需要管理员权限
  5. 点击"安装"，等待完成
  6. 点击"完成"启动应用

WebView2 运行时

智码 AICoder 基于 WebView2 运行。Windows 10 (1803+) 和 Windows 11 已自带 WebView2。如果遇到启动失败，请从 微软官网 手动安装 WebView2 运行时。

macOS 安装

  1. 从 下载页面 获取 .dmg 文件
    • Apple Silicon (M1/M2/M3/M4)：选择 ARM 版本
    • Intel Mac：选择 x64 版本
  2. 双击打开 .dmg 文件
  3. 将应用图标拖拽到 Applications 文件夹
  4. 首次打开时若被 macOS 拦截，见下方「macOS 安全提示」处理

macOS 安全提示

应用走 ad-hoc 签名、未经 Apple 公证（并非恶意软件），首次打开可能遇到两种提示：

  • 「无法验证开发者」：打开「系统设置 → 隐私与安全性」，在底部找到智码 AICoder 的提示，点击「仍要打开」。
  • 「已损坏，无法打开，你应该将它移到废纸篓」（Apple Silicon 上更常见，且不会出现「仍要打开」按钮）：打开「终端」执行下面这条命令解除限制，再重新打开应用：
sudo xattr -rd com.apple.quarantine "/Applications/智码 AICoder.app"

若没把应用拖进 Applications，可把 .app 直接拖进终端窗口自动补全路径。

给应用开「完全磁盘访问」（macOS 15 及以上建议）

装好后建议顺手做这一步，可以一次性免掉后续反复出现的系统权限弹窗。

macOS 15 (Sequoia) 起新增了「App 数据」这一隐私类别，应用读到其他 App 的数据目录时，系统就会弹一次「"智码 AICoder.app" 想访问其他 App 的数据」。在智码终端里跑的 Claude Code、Codex 等命令行工具触发这类访问时，系统会把弹窗记在智码 AICoder 名下——因为 macOS 按「负责的应用」而不是「实际执行的命令」来归属权限请求。所以这类弹窗不是智码在读你的数据，也没法从智码这一侧关掉。

而且这个授权是按被访问的 App 分别记的：命令每撞上一个新的 App 数据目录就会再弹一次，逐个点「允许」会没完没了。给智码一次「完全磁盘访问」即可一并覆盖。

操作步骤：

  1. 打开「系统设置 → 隐私与安全性 → 完全磁盘访问」
  2. 在列表里找到「智码 AICoder」，把右侧开关打开
  3. 退出并重新打开智码 AICoder（这一步不能省，权限变更要重启应用才生效）

不用手动把应用拖进列表

智码在启动时已经向系统登记过一次，所以第三方应用常见的「点 + 号 → 输入密码 → 翻到访达里找 .app 拖进来」这一串都不需要，列表里直接就有「智码 AICoder」，拨开关即可。

也可以在应用内操作：打开「设置 → 通用」，未授权时顶部会出现一张引导卡片，点「打开系统设置」直接跳到对应页面，开完点「我已开启，重新检测」确认结果。

不开会怎样

不影响正常使用，只是命令行工具访问受保护目录时会弹窗打断，被拒绝的那次访问会失败。若之前误点过「不允许」，同样在这个页面把开关打开即可覆盖。

Linux 安装

从 下载页面 获取安装包，优先选 .deb：

sudo apt install ./AICoder_*_amd64.deb

Ubuntu 24.04 及更新的系统不要用 AppImage

.AppImage 是在 Ubuntu 22.04 上构建的，捆绑的旧库与新系统的库对不上，启动会直接崩溃。.deb 直接使用系统自带的库，任何版本的 Debian / Ubuntu 都适用。.AppImage 只适合 Ubuntu 22.04 一带的较旧发行版。

运行前请确保系统已安装 WebKitGTK 4.1（libwebkit2gtk-4.1-0）与 libayatana-appindicator3-1，多数现代发行版默认已带。非 Debian 系发行版的处理办法见 下载页 → Linux。

自动更新

安装完成后，应用会自动检查新版本更新。

  • 后台静默检查，不打扰工作
  • 有新版本时，更新包在后台静默下载，全程不中断当前会话
  • 下载完成后弹出提示，由你选择合适的时机重启应用完成升级
  • 重启后新版本即生效

无需手动下载新版本。

卸载

Windows

  • 打开「设置 → 应用 → 已安装的应用」
  • 找到「智码 AICoder」，点击卸载

macOS

  • 打开 Finder → Applications
  • 将「智码 AICoder」拖拽到废纸篓

Linux

  • .deb 安装的：sudo apt remove aicoder
  • .AppImage：直接删除该文件即可

数据位置

应用数据存储在以下位置：

平台 路径
Windows %APPDATA%\com.agilefr.tauri\
macOS ~/Library/Application Support/com.agilefr.tauri/
Linux ~/.local/share/com.agilefr.tauri/（设置了 $XDG_DATA_HOME 时在 $XDG_DATA_HOME/com.agilefr.tauri/）

卸载不会删除数据

卸载应用不会自动删除用户数据。如需完全清理，请手动删除上述数据目录。

最后更新：