常见问题
基础问题
智码 AICoder 是什么？
智码 AICoder 是一款专为 AI 编程 CLI 工具（Claude Code、Codex、Gemini CLI）打造的桌面管理客户端。它不是另一个 AI 对话工具，而是围绕现有 CLI 工具构建的效率层 — 解决你在终端里使用 AI 编程助手时遇到的会话管理、多账号、费用追踪等痛点。
会消耗额外的 Token 吗？
不会。
智码 AICoder 的终端是真实的 PTY 伪终端，CLI 工具在里面原生运行，直接与各自的 API 服务通信。
智码 AICoder 不拦截、不修改、不转发任何 API 请求。
所有管理功能（会话列表、Token 统计、文件浏览等）都是读取本地数据，不产生 API 调用。使用本软件与直接在终端使用 CLI，Token 消耗完全一致。
支持哪些 AI 编程工具？
| 工具 | 厂商 | 状态 |
|---|---|---|
| Claude Code | Anthropic | ✅ 完整支持 |
| Codex CLI | OpenAI | ✅ 完整支持 |
| Gemini CLI | ✅ 完整支持 |
应用会自动检测已安装的工具，无需手动配置。
免费试用有功能限制吗？
没有。30 天免费试用期内，所有功能完整可用，和付费版没有任何区别。
安装问题
Windows 安装后无法启动
可能的原因：
- 缺少 WebView2 运行时 — Windows 10 (1803+) 和 Windows 11 通常已自带。如果缺失，请从 微软官网 手动安装
- 杀毒软件拦截 — 部分杀毒软件可能误拦截。请将智码 AICoder 加入白名单
macOS 提示"无法验证开发者"
首次打开时可能遇到 macOS Gatekeeper 拦截：
- 打开「系统设置 → 隐私与安全性」
- 在底部找到智码 AICoder 的安全提示
- 点击「仍要打开」
如何更新到最新版本？
应用内自动检查更新。有新版本时会弹出通知，点击「安装更新」即可。
也可以随时从 下载页面 手动下载最新版本覆盖安装。
使用问题
如何切换 AI 工具？
两种方式：
- 底部状态栏 — 点击当前工具图标快速切换
- 设置中心 — CLI 工具标签页，管理工具的启用/禁用
多实例之间数据隔离吗？
完全隔离。 每个实例拥有独立的：
- 数据库
- 会话历史
- 登录凭据
- API 配置
MCP Server 配置在实例间共享，无需重复配置。
如何启动多实例？
启动应用时添加参数：
# Windows
智码AICoder.exe --instance 2
# macOS
open -a "智码 AICoder" --args --instance 2Token 统计数据准确吗？
智码 AICoder 通过解析 Claude Code 的 JSONL 日志文件获取 Token 数据，与 CLI 自身报告的数据一致。费用按各模型的官方定价计算。
数据存储在哪里？
| 平台 | 路径 |
|---|---|
| Windows | %APPDATA%\com.agilefr.tauri\ |
| macOS | ~/Library/Application Support/com.agilefr.tauri/ |
所有数据存储在本地，不上传到任何服务器。
支持 Linux 吗？
目前暂不支持 Linux。后续版本计划加入 .AppImage 和 .deb 格式。
订阅问题
如何购买订阅？
在设置中心的「授权」标签页，查看试用状态并购买订阅。支持微信支付和支付宝。
订阅到期后数据会丢失吗？
不会。订阅到期后应用功能受限，但所有数据（会话、片段、设置）完整保留。续费后立即恢复。
更多帮助
遇到其他问题？欢迎通过以下方式反馈：
- Gitee Issues — 提交 Bug 或功能建议