常见问题
基础问题
智码 AICoder 是什么？
智码 AICoder 是一款专为 AI 编程 CLI 工具（Claude Code、Codex、Gemini CLI）打造的桌面管理客户端。它不是另一个 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 | ✅ 完整支持 |
| 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（必须加 -n，否则会激活已有窗口而不是开新进程）
open -n -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 或功能建议