常见问题
基础问题
智码 AICoder 是什么？
智码 AICoder 是一款专为 AI 编程 CLI 工具（Claude Code、Codex、heng-agent、Grok、Kimi Code、CodeBuddy、Pi、Antigravity、OpenCode 等十家）打造的桌面管理客户端。它不是另一个 AI 对话工具，而是围绕现有 CLI 工具构建的效率层 — 解决你在终端里使用 AI 编程助手时遇到的会话管理、多账号、费用追踪等痛点。
智码 AICoder 是 Anthropic / OpenAI / Google 的官方产品吗？
不是。 智码 AICoder 是独立第三方开发的桌面客户端，与 Anthropic、OpenAI、Google 及其关联公司无任何隶属、合作或代理关系。
软件本身不提供 AI 模型服务，所有 AI 能力均来自您自行安装的官方 CLI 工具及您自行配置的服务商 API。"Claude"、"Codex"、"Gemini" 等是各自所有者的商标，本软件仅在描述兼容能力时引用上述名称。
完整的《用户协议与免责声明》可在软件内「设置 → 关于 → 法律声明」查看。
我需要自己付 API 费用吗？
是的，需要。 智码 AICoder 不内置任何 AI 服务额度。您需要：
- 官方订阅：自行向 Anthropic / OpenAI / Google 申请 Claude Pro/Max、ChatGPT Plus、Gemini 等订阅，或
- API Key：自行向对应服务商或其授权渠道申请 API Key（按 token 计费）
您购买的智码 AICoder 订阅费仅包含本客户端软件的使用授权，不含任何 AI 服务额度。
会消耗额外的 Token 吗？
不会。
智码 AICoder 的终端是真实的 PTY 伪终端，CLI 工具在里面原生运行，直接与各自的 API 服务通信。
智码 AICoder 不拦截、不修改、不转发任何 API 请求。
所有管理功能（会话列表、Token 统计、文件浏览等）都是读取本地数据，不产生 API 调用。使用本软件与直接在终端使用 CLI，Token 消耗完全一致。
支持哪些 AI 编程工具？
十家，顺序与智码里的工具列表一致：
| 工具 | 厂商 | 状态 |
|---|---|---|
| Claude Code | Anthropic | 完整支持 |
| Codex CLI | OpenAI | 完整支持 |
| heng-agent | 抓蛙师自研 · 开源 | 完整支持 |
| Grok Build CLI | xAI | 完整支持 |
| Kimi Code | 月之暗面 | 完整支持 |
| CodeBuddy | 腾讯 | 完整支持 |
| Pi | Earendil Works | 完整支持 |
| Gemini CLI | 已停服，历史会话可查看 | |
| Antigravity | 完整支持 | |
| OpenCode | 开源 · 多 Provider | 完整支持 |
应用会自动检测已安装的工具，无需手动配置。
heng-agent 是什么？
抓蛙师自研的终端编码智能体，中文优先，开源在 GitHub。它和 Claude Code 一样是命令行工具，在智码里排工具列表第三位：可以一键安装（用 uv，连不上 pypi.org 时自动换清华镜像），服务商、密钥和模型在 API 档案里配，终端和聊天两种模式都能用。详见多 AI 工具统一管理。
Gemini CLI 还能用吗？
不能新建了。Google 自 2026-06-18 起停止为消费者（免费 / AI Pro / Ultra）提供 Gemini CLI 服务，智码也不再启动新的 Gemini 会话。以前的 Gemini 会话都还在，可以查看、搜索、导出；要继续用 Google 的模型，改用 Antigravity。
免费试用有功能限制吗？
没有。30 天免费试用期内，所有功能完整可用，和付费版没有任何区别。
安装问题
Linux 上 AppImage 一启动就崩
多见于 Ubuntu 24.04 及更新的系统，报错类似 undefined symbol: g_task_set_static_name 或 Unable to spawn a new child process ... WebKitNetworkProcess。这是 .AppImage 捆绑的旧库与新系统不兼容所致，改用 .deb 安装即可：
sudo apt install ./AICoder_*_amd64.debWindows 安装后无法启动
可能的原因：
- 缺少 WebView2 运行时 — Windows 10 (1803+) 和 Windows 11 通常已自带。如果缺失，请从 微软官网 手动安装
- 杀毒软件拦截 — 部分杀毒软件可能误拦截。请将智码 AICoder 加入白名单
macOS 提示"无法验证开发者"或"已损坏，移到废纸篓"
首次打开时可能遇到 macOS Gatekeeper 拦截。应用走 ad-hoc 签名、未经 Apple 公证（并非恶意软件），分两种情况处理：
- "无法验证开发者"：打开「系统设置 → 隐私与安全性」，在底部找到智码 AICoder 的安全提示，点击「仍要打开」。
- "已损坏，无法打开，你应该将它移到废纸篓"（Apple Silicon 上更常见，且没有「仍要打开」按钮）：打开「终端」执行以下命令，再重新打开应用：
sudo xattr -rd com.apple.quarantine "/Applications/智码 AICoder.app"macOS 反复弹"智码 AICoder 想访问其他 App 的数据"
macOS 15 (Sequoia) 新增的「App 数据」隐私类别所致，并不是智码在读你其他软件的数据。
在智码终端里跑的 Claude Code、Codex 等命令行工具访问到其他 App 的数据目录时，系统按「负责的应用」归属权限请求，于是弹窗记在了智码名下。这类弹窗没法从智码一侧关掉；而且授权按被访问的 App 分别记，逐个点「允许」会一直弹。
解决办法：打开「系统设置 → 隐私与安全性 → 完全磁盘访问」，找到「智码 AICoder」把开关打开，然后退出并重新打开应用。列表里已经有智码，不需要手动添加。
详细说明见安装指南 → 给应用开「完全磁盘访问」。
如何更新到最新版本？
应用内自动检查更新。有新版本时会弹出通知，点击「安装更新」即可。
也可以随时从 下载页面 手动下载最新版本覆盖安装。
使用问题
如何切换 AI 工具？
两种方式：
- 底部状态栏 — 点击当前工具图标快速切换
- 设置中心 — CLI 工具标签页，管理工具的启用/禁用
多实例之间数据隔离吗？
完全隔离。 每个实例拥有独立的：
- 数据库
- 会话历史
- 登录凭据
- API 配置
MCP Server 配置在实例间共享，无需重复配置。heng-agent 没有登录态，各实例共用同一个 ~/.heng-agent；要分账号，给不同实例配不同的 API 档案即可。
如何启动多实例？
启动应用时添加参数：
# Windows
智码AICoder.exe --instance 2
# macOS（必须加 -n，否则会激活已有窗口而不是开新进程）
open -n -a "智码 AICoder" --args --instance 2Token 统计数据准确吗？
智码 AICoder 读取 Claude Code、Codex 在本机保存的会话记录来统计 Token，与 CLI 自身报告的数据一致。费用按各模型的官方定价计算。
数据存储在哪里？
| 平台 | 路径 |
|---|---|
| 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/） |
所有数据存储在本地，不上传到任何服务器。
支持 Linux 吗？
支持。 当前提供 Linux x86_64 的两种安装包：
| 安装包 | 适用 |
|---|---|
.deb（推荐） |
Debian / Ubuntu 系列，任何版本都适用；直接使用系统自带的 WebKitGTK 等库 |
.AppImage |
仅适合 Ubuntu 22.04 一带的较旧发行版 |
Ubuntu 24.04 及更新的系统请优先用 .deb：.AppImage 是在 Ubuntu 22.04 上构建的，捆绑的旧库与新系统的库对不上，启动会直接崩溃。运行前需确保系统已装 WebKitGTK 4.1（libwebkit2gtk-4.1-0）。
安装命令与非 Debian 系发行版的说明见 下载页 → Linux。
订阅问题
如何购买订阅？
在设置中心的「授权」标签页，查看试用状态并购买订阅。支持微信支付和支付宝。
订阅到期后数据会丢失吗？
不会。订阅到期后应用功能受限，但所有数据（会话、片段、设置）完整保留。续费后立即恢复。
更多帮助
遇到其他问题？欢迎通过以下方式反馈：
- Gitee Issues — 提交 Bug 或功能建议