安装指南

系统要求

要求	最低版本
Windows	Windows 10 (x64)
macOS	macOS 12 Monterey
磁盘空间	约 200 MB
AI CLI 工具	Claude Code / Codex / Gemini CLI（至少一个）

Windows 安装

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

WebView2 运行时

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

macOS 安装

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

macOS 安全提示

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

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

bash

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 数据目录就会再弹一次，逐个点「允许」会没完没了。给智码一次「完全磁盘访问」即可一并覆盖。

操作步骤：

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

不用手动把应用拖进列表

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

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

不开会怎样

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

自动更新

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

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

无需手动下载新版本。

卸载

Windows

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

macOS

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

数据位置

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

平台	路径
Windows	`%APPDATA%\com.agilefr.tauri\`
macOS	`~/Library/Application Support/com.agilefr.tauri/`

卸载不会删除数据

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

安装指南 ​

系统要求 ​

Windows 安装 ​

macOS 安装 ​

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

自动更新 ​

卸载 ​

Windows ​

macOS ​

数据位置 ​