# 使用指南 — Remote AI

> 从安装到第一个任务，再到跨设备连接。这里是 Remote AI 的入门路线。

Source: https://remoteai.piperhex.com/guide/

## 01 / 安装 Remote AI

前往 GitHub Releases，选择适合操作系统和处理器架构的安装包。安装后打开应用，按首页提示完成 Codex 准备。

## 02 / 准备账号或 Provider

登录可用的 Codex 账号，或添加兼容的第三方 Provider。确认模型可用，并了解对应服务的额度和费用。

## 03 / 开始第一个任务

进入 Codex GUI，选择项目，描述希望完成的目标。可以附上图片或引用文件，再查看回复、命令结果和文件改动。

## 04 / 从另一块屏幕继续

让电脑保持在线并运行 Remote AI。在网页或移动端登录相同云端账号，选择目标电脑，继续已有对话。

- 产品名称: Remote AI（原 Codex Switch）

- 产品定位: 面向 Codex 的开源图形化 AI 编程工作台

- 桌面平台: Windows、macOS、Linux，具体架构以发布包为准

- 远程入口: 网页版与移动端，连接运行 Remote AI 的电脑

- 开源协议: Apache-2.0

- 模型来源: 用户自己的 Codex 账号或兼容 Provider

### Remote AI 是什么？

Remote AI（原 Codex Switch）是一款面向 Codex 的开源图形化 AI 编程工作台，整合项目对话、账号与模型管理、用量分析和跨设备连接。

### 使用 Remote AI 需要付费吗？

Remote AI 以 Apache-2.0 协议开源。使用 Codex 或第三方模型仍需相应账号或 API 服务，模型额度和费用由对应服务方决定。

### 可以只打开网页就开始吗？

远程网页版需要连接一台已安装并运行 Remote AI 的电脑。先在电脑上准备 Codex，再用相同云端账号登录网页并选择电脑。

### 支持哪些操作系统？

桌面端提供 Windows、macOS 和 Linux 发布包，具体架构以 Releases 为准。电脑助手等系统功能有各自的平台要求。

## 遇到问题时

先检查当前电脑、账号与模型是否可用。远程连接时，确认两端登录相同云端账号，目标电脑在线。仍有问题，可以查阅仓库文档或提交包含复现步骤的 Issue。

[GitHub](https://github.com/piperhex/remoteai) · [Apache-2.0](https://github.com/piperhex/remoteai/blob/master/LICENSE)