# 快速上手

从安装到完成第一条 AI 对话。如需先观看操作演示，参见[视频教程](https://aicode.murk.top/md/guide/video-tutorials.md)。

## 系统要求

- Android 8.0（API 26）及以上
- arm64-v8a 或 x86_64 设备

## 下载安装

从 [GitHub Releases](https://github.com/jieapi/aicode/releases/latest) 下载，三个包按设备选择：

| 包名 | 适用场景 |
| --- | --- |
| `armsolo` | 真机（arm64 设备），体积最小 |
| `x86solo` | 模拟器、Chromebook（x86_64） |
| `universal` | 通用包，同时含两种架构，体积较大 |

::: warning 架构要选对
架构不匹配会导致内置容器无法运行。不确定时使用 `universal`。
:::

推荐直接点击[文档站首页](https://aicode.murk.top/md/index.md)的「下载 APK」，将通过加速镜像直接下载最新正式版的 `universal` 通用包（镜像不可用时自动回退至 GitHub 原链）。

## 1. 配置 AI 供应商

::: tip 首次启动有新手引导
首次启动时会自动开启新手引导（1.12.0 新增），依次引导完成下面几步；也可随时点击「跳过」，或之后在「设置 → 重新运行新手引导」再次启动。
:::

AiCode 自身不提供模型，需要先接入一个模型服务。

1. 点主页左上角菜单按钮打开侧边栏，点底部「设置」。
2. 进入「AI 配置 → AI 供应商」，点右上角 + 新建，在「配置」标签填写四项：
   - **名称**：别名，例如「官方 OpenAI」。
   - **上游格式**：`OpenAI` / `Anthropic` / `Gemini` 三选一。第三方中转站一般选 `OpenAI`。
   - **API Key**：你的密钥，形如 `sk-xxx`。
   - **Base URL**：API 根地址，**留空时按上游格式使用官方地址**；用第三方中转时填入中转服务的地址。
3. 底部切到「模型」标签添加模型：
   - 点击「拉取模型」从服务端同步可用列表，点击每行右侧的「+」逐个添加，或用右上角「全部添加」一键加入。
   - 点击右上角 + 手动输入模型名（例如 `gpt-4o`）。中转站模型名拉取不全时使用此方式。
   - 可选：点击模型行编辑元数据（上下文窗口、价格、图片输入与工具调用等能力开关）。

填完退出编辑页时会自动保存，没有单独的保存按钮。

## 2. 选择模型

回到聊天主页，点击输入框下方工具栏的模型按钮，在弹窗中选择刚添加的模型。顶部搜索框可以筛选，模型按供应商分组显示，点击分组标题可以折叠或展开。

## 3. 准备执行环境

默认使用内置的本地容器，无需任何配置。第一次使用时，在主页点击进入终端，按提示完成一次初始化即可（解压系统、安装基础工具），之后 AI 就能正常执行命令。

如需把远程服务器当执行后端，见[远程 SSH 模式](https://aicode.murk.top/md/guide/remote-ssh.md)；容器与镜像的详细设置见[容器与镜像](https://aicode.murk.top/md/guide/container.md)。

## 4. 开始对话

在输入框输入内容后点击发送。输入框下方工具栏最左侧的模式按钮可以在 BUILD、PLAN、AUTO 之间切换，区别见[三种模式](https://aicode.murk.top/md/guide/modes.md)。

## 实用贴士

- 在主页空会话中选择的模型将被记录为新会话的默认模型，后续新建会话自动沿用。
- 识图、生图与标题总结支持独立指定专属模型，详见[默认模型](https://aicode.murk.top/md/guide/default-models.md)。
- AI 修改代码前会自动创建快照，支持一键安全回滚，详见[检查点与撤销](https://aicode.murk.top/md/guide/checkpoint.md)。
- 执行编译等耗时任务前，建议开启[软件权限](https://aicode.murk.top/md/guide/app-permissions.md)中的后台运行保活，防止系统在切换后台时终止进程。