Remote AI：Codex 图形化编程工作台

项目简介

Remote AI（原名 Codex Switch）是一款面向 Codex 的图形化 AI 编程工作台，用直观界面把对话编程、项目管理和多账号管理整合在一起。你可以直接在应用内与 Codex 对话，理解代码、实现功能、排查问题，并随时查看执行进度和文件改动。

它提供账号登录与切换、用量查看、第三方 Provider、本地热切换代理、Token 分析、Skills 市场和一键换肤，支持在本机启动网页版，也可连接自建后端与移动端，实现跨设备协同管理。

主要功能

• Codex GUI 编程助手：选择本地文件夹即可按项目开展任务，支持查看或切换 Git 分支；可输入文字、粘贴图片、引用文件或文件夹，输入 / 选择命令或技能；可调整模型、思考强度和访问权限，实时查看计划、命令输出与文件差异，并支持中断任务、搜索/重命名/置顶/归档对话。
• 账号管理与本地代理：复用 Codex CLI 的 OAuth 2.0 + PKCE 登录流程，支持应用内登录与系统浏览器登录，可导入多个 auth.json 及常见第三方 JSON 导出，原子化切换 ~/.codex/auth.json，并以 .cs 备份包导出和恢复配置。
• 用量与切号：展示账号邮箱、套餐与到期时间、主/次用量窗口、重置卡和当日 Token；支持自动切号、阈值设置、手动或定时刷新，以及在额度耗尽后切换主用量窗口使用率最低的账号。
• 第三方模型服务商：支持 OpenAI Responses、兼容 Chat Completions 的 Provider、多模型与中转站余额查询，统一经监听 127.0.0.1:15722 的本地代理使用，并可在官方账号与 Provider 间热切换。
• Token 分析：记录经本地代理转发的请求用量，提供按周热力图、趋势图以及 Token 类型、Provider、模型和账号消耗排行。
• 个性化：内置 300+ 套 Dream Skin 主题预设，支持一键应用、自定义背景与恢复；提供紧凑圆形或玻璃面板样式的悬浮用量球。
• 其他：内置 Skills 市场、Computer Use 电脑助手、2FA 验证码面板、官方 Codex 会话统计栏。
• 跨设备：桌面客户端可同时启动网页版，默认仅监听本机，也支持访问密钥远程管理与 --headless --port 无界面运行；Expo 移动端可查看账号摘要、刷新用量与重置卡，并远程切换指定 PC 的模型或 Provider。

安装与使用

各平台安装包在 Releases 提供：Windows（EXE/MSI，含 ARM64）、macOS（DMG，Apple 芯片与 Intel）、Linux（DEB/AppImage），以及 Android APK 和 iOS 未签名包。

Linux .deb 安装后可用 csw 命令启动。

在浏览器中使用可访问 RemoteAI Web：先安装 PC 端，进入首页按提示完成 Codex 安装，保持 PC 端运行并联网，网页端登录与 PC 端相同的云端账号即可连接电脑。

无界面运行（端口只对本次运行生效）：

csw.exe --headless --port=18080

启动后通过 http://127.0.0.1:18080 访问，--headless 必须与 --port 同时使用。

从源码开发需要 Node.js 18+、npm、Rust 工具链与 Tauri 2 系统依赖，然后执行：

npm install
npm run dev:app

使用说明：选择「添加账户」登录或导入 auth.json，在账号列表刷新用量，点「切换」替换 Codex 当前凭据；若 ChatGPT/Codex 进程仍缓存旧凭据，可在控制台或托盘选择「重启 ChatGPT」。

注意事项

• 账号和服务商密钥仅保存在 Rust 后端，不会暴露给桌面端 React 界面或应用日志。
• 启用网页局域网监听后，持有网页版访问密钥的用户拥有完整管理权限；需要调用模型的设备应使用单独的代理 API Key。
• .cs 备份包含本地账号与服务商配置，不应作为可公开的无密钥文件分发。
• 三方 Provider 仅可在本地代理运行时使用，切换官方模型与 Provider 后需重启 ChatGPT/Codex。
• 移动端与云端同步需要已部署的后端服务。

本作品整理自 GitHub 开源项目 piperhex/remoteai，原作者 @piperhex，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。