快速上手
从安装到完成第一条 AI 对话。如需先观看操作演示，参见视频教程。
系统要求
- Android 8.0（API 26）及以上
- arm64-v8a 或 x86_64 设备
下载安装
从 GitHub Releases 下载，三个包按设备选择：
| 包名 | 适用场景 |
|---|---|
armsolo | 真机（arm64 设备），体积最小 |
x86solo | 模拟器、Chromebook（x86_64） |
universal | 通用包，同时含两种架构，体积较大 |
架构要选对
架构不匹配会导致内置容器无法运行。不确定时使用 universal。
推荐直接点击文档站首页的「下载 APK」，将通过加速镜像直接下载最新正式版的 universal 通用包（镜像不可用时自动回退至 GitHub 原链）。
1. 配置 AI 供应商
首次启动有新手引导
首次启动时会自动开启新手引导（1.12.0 新增），依次引导完成下面几步；也可随时点击「跳过」，或之后在「设置 → 重新运行新手引导」再次启动。
AiCode 自身不提供模型，需要先接入一个模型服务。
- 点主页左上角菜单按钮打开侧边栏，点底部「设置」。
- 进入「AI 配置 → AI 供应商」，点右上角 + 新建，在「配置」标签填写四项：
- 名称：别名，例如「官方 OpenAI」。
- 上游格式：
OpenAI/Anthropic/Gemini三选一。第三方中转站一般选OpenAI。 - API Key：你的密钥，形如
sk-xxx。 - Base URL：API 根地址，留空时按上游格式使用官方地址；用第三方中转时填入中转服务的地址。
- 底部切到「模型」标签添加模型：
- 点击「拉取模型」从服务端同步可用列表，点击每行右侧的「+」逐个添加，或用右上角「全部添加」一键加入。
- 点击右上角 + 手动输入模型名（例如
gpt-4o）。中转站模型名拉取不全时使用此方式。 - 可选：点击模型行编辑元数据（上下文窗口、价格、图片输入与工具调用等能力开关）。
填完退出编辑页时会自动保存，没有单独的保存按钮。
2. 选择模型
回到聊天主页，点击输入框下方工具栏的模型按钮，在弹窗中选择刚添加的模型。顶部搜索框可以筛选，模型按供应商分组显示，点击分组标题可以折叠或展开。
3. 准备执行环境
默认使用内置的本地容器，无需任何配置。第一次使用时，在主页点击进入终端，按提示完成一次初始化即可（解压系统、安装基础工具），之后 AI 就能正常执行命令。
如需把远程服务器当执行后端，见远程 SSH 模式；容器与镜像的详细设置见容器与镜像。
4. 开始对话
在输入框输入内容后点击发送。输入框下方工具栏最左侧的模式按钮可以在 BUILD、PLAN、AUTO 之间切换，区别见三种模式。