EasyAIConfig

一个本地优先的 AI 编程工具配置中心。

管理 Provider、模型、OAuth / API Key、用量、终端启动、反代网关和常用工具安装。

---

是什么

EasyAIConfig 用来把 Codex、Claude Code、OpenCode、OpenClaw、Gemini CLI、Hermes Agent、Claude Desktop 等工具的配置集中到一个本地桌面应用里。

它解决的核心问题很简单：

• 不手写散落在各处的配置文件
• 不反复复制 Base URL、API Key、模型名
• 不靠记忆切换不同 Provider / OAuth 账号
• 不打开一堆终端手动启动工具
• 不到处翻日志和本地文件看用量

核心能力

能力	说明
Provider 管理	保存、切换、检测 API Key Provider，支持本地 Router
OAuth / API Key	支持官方登录和中转 API Key 两种路径
模型管理	自动拉取 /v1/models，也支持手动维护可用模型
用量看板	读取本地日志 / JSONL / SQLite，汇总用量、费用和模型分布
启动工具	支持应用内终端、系统终端、Termius、Warp、iTerm 等启动方式
反代网关	本地统一入口，支持请求日志、搜索、分页、清理和保留策略
工具安装	管理 Codex、Claude Code、OpenCode、OpenClaw、IDE 插件和桌面应用
资产中心	查看配置、MCP、Skill、会话、提示词等本地资产
手机遥控	Flutter App 扫码配对，远程新建 / 审批 / 镜像 Codex 与 Claude Code

截图

桌面端

手机端

扫码配对电脑上的远程服务后，可在手机上建会话、走快速通道、镜像终端，并查看用量。

   

   

截图	说明
配对	扫码或手动填入电脑局域网地址 + token
会话列表	查看进行中的 Codex / Claude Code 会话与连接状态
新建会话	选择快速 / 终端 / 镜像模式，指定工作目录与模型
快速通道	手机直接起桥接会话，不必先开电脑终端
工具菜单	发图、切模型、推理强度、用量、进入全屏终端
用量	查看 Codex 周限额与 Credits

更多手机端说明见 EasyAIConfig/README.md。

安装

桌面版 / 手机版（推荐）

安装包在 Cloudflare R2（GitHub Release 不放大安装包，只在介绍里放下载链接）。

打开 最新 Release 看本版本直链，或用下面固定入口（始终最新版）：

平台	下载
macOS Apple Silicon	EasyAIConfig_aarch64.dmg
macOS Intel	EasyAIConfig_x64.dmg
Windows	EasyAIConfig_x64-setup.exe
Linux	EasyAIConfig_amd64.AppImage
Android	EasyAIConfig.apk

macOS 请下 .dmg；不要下 .app.tar.gz（应用内自动更新用）。

macOS 首次打开若被拦截：

sudo xattr -rd com.apple.quarantine /Applications/EasyAIConfig.app

手机端自行构建

也可本地打 APK：

cd EasyAIConfig
flutter build apk --release
# 产物：build/app/outputs/flutter-apk/app-release.apk

使用前先在桌面端开启「远程」服务，再用手机扫码配对。同一 Wi‑Fi 直连；跨网可走 VPS 反向隧道。

Web 模式

npm install -g easyaiconfig
easyaiconfig

Web 模式会启动本地服务并打开浏览器。Windows 下推荐优先使用桌面版。

快速开始

1. 打开 EasyAIConfig
2. 选择工具，例如 Codex
3. 选择官方 OAuth 或 API Key 模式
4. 填写 Base URL、API Key、模型
5. 点击保存
6. 点击启动，选择应用内终端或外部终端

手机遥控：

1. 桌面端打开终端页 →「远程」→ 开启本机服务
2. 手机 App 扫码配对（确认顶栏 IP 是你这台电脑）
3. 新建会话，选快速 / 终端 / 镜像

本地文件

常见配置位置：

工具	配置
Codex	~/.codex/config.toml、~/.codex/auth.json
Claude Code	~/.claude/settings.json
OpenCode	~/.config/opencode / opencode.json
OpenClaw	~/.openclaw
Gemini CLI	~/.gemini

EasyAIConfig 默认在本机读写这些文件，不需要把密钥上传到远端服务。

开发

npm install
npm start

桌面开发：

npm run desktop:dev

构建桌面版：

npm run desktop:build

发布

推送 tag 触发 GitHub Actions 构建：

git tag v1.0.63
git push origin v1.0.63

License

MIT