Warning
This is a reverse-engineered proxy of GitHub Copilot API. It is not supported by GitHub, and may break unexpectedly. Use at your own risk.
Warning
GitHub Security Notice: Excessive automated or scripted use of Copilot (including rapid or bulk requests, such as via automated tools) may trigger GitHub's abuse-detection systems. You may receive a warning from GitHub Security, and further anomalous activity could result in temporary suspension of your Copilot access.
GitHub prohibits use of their servers for excessive automated bulk activity or any activity that places undue burden on their infrastructure.
Please review:
Use this proxy responsibly to avoid account restrictions.
基于 Electron + React + Vite 的桌面 GUI，为 copilot-proxy 提供图形化管理界面，无需命令行即可管理代理服务。
- GitHub OAuth 登录（Device Code 流程，内置验证码弹窗）
- 自动检测账号类型（个人 / 商业 / 企业）
- 服务启停，独立日志弹窗窗口（过滤、跟踪/暂停、可调字号、自动换行、主题同步）
- 模型列表拉取 & 默认模型 / 快速模型选择（选择即保存，主界面支持一键刷新模型列表）
- Claude Code 集成：一键启动 & 写入/清除
~/.claude/settings.json配置；若已存在持久化配置，切换模型后自动同步 - Claude Code
--dangerously-skip-permissions模式：设置中可开启跳过权限确认，启用时在设置页和启动时均弹出二次确认弹窗 - 用量看板（配额进度条 + 详细数据折叠展示）
- 对话记录：将经过代理的请求与 AI 回复记录到本地 JSON 文件，内置对话浏览器（按会话/日期分组、全文搜索、批量删除、实时推送、配色/语言同步）
- 风险声明对话框（首次启动弹出，需接受后方可启动服务）
- 5 套内置主题：Lavender (Frost)、Peach (Sakura)、Cherry、Midnight、Aurora
- 配置管理：端口、账号类型、详细日志、手动审批、速率限制等
- 系统托盘：启停控制、模型信息、最小化到托盘
- 中英文双语支持（一键切换，首次启动自动检测系统语言）
- Claude Code 安装检测（未安装时提示并禁用相关按钮）
- 跨平台支持：Windows 和 macOS（arm64 + x64）
- 关闭窗口行为可配置（最小化到托盘 / 退出 / 每次询问，支持记住选择）
从 Releases 页面下载：
- Windows：安装版（
-setup.exe，推荐，支持轻量更新）或便携版（-portable.exe） - macOS：DMG 安装包（arm64 适用于 Apple Silicon，x64 适用于 Intel）
macOS 首次打开提示
由于应用未经 Apple 公证，macOS 会提示"无法验证开发者"。请按以下步骤操作：
- 双击 DMG 挂载，将应用拖入 Applications
- 右键（或 Control+点击） 应用图标 → 选择 "打开" → 在弹窗中点 "打开"
- 如果右键没有"打开"选项，前往 系统设置 → 隐私与安全性，滚到底部点击 "仍要打开"
- 只需首次操作，之后可正常双击打开
# 克隆仓库（含子模块）
git clone --recurse-submodules https://github.com/kylefu8/copilot-proxy-gui.git
cd copilot-proxy-gui
# 安装依赖
npm install
# 安装 proxy 依赖
cd copilot-proxy && bun install && cd ..
# 开发模式启动
npm run desktop:devnpm run desktop:build产物在 release/ 目录下。
- 前端：React 18 + Vite 5
- 桌面壳：Electron 33
- 代理服务：copilot-proxy（git submodule）
GUI 默认请求本地 http://localhost:4399，可在设置页修改端口。
关闭窗口时会自动停止 proxy 子进程。
| 命令 | 说明 |
|---|---|
service_start |
启动代理服务 |
service_stop |
停止代理服务 |
service_logs |
获取服务日志 |
auth_status |
检查 token 状态 |
auth_device_code_start |
启动 Device Code 登录流程 |
delete_token |
删除已保存 token |
fetch_models |
拉取模型列表 |
detect_account_type |
检测账号类型 |
launch_claude_code |
启动 Claude Code |
write_claude_env |
写入 Claude 配置 |
clear_claude_env |
清除 Claude 配置 |
check_claude_env |
检查 Claude 配置 |
check_claude_installed |
检查 Claude Code 是否已安装 |
open_external |
打开外部链接 |
resize_window |
调整窗口大小 |
open_log_window |
打开独立日志查看器窗口 |
update_log_theme |
同步主题到日志窗口 |
open_conversation_window |
打开对话记录浏览器窗口 |
list_conversation_sessions |
列出所有对话会话 |
load_conversation_session |
加载指定会话的对话记录 |
delete_conversation_sessions |
删除指定会话 |
clear_conversations |
清除所有对话记录 |
本项目基于 copilot-proxy（by Jer-y）开发，核心代理服务实现来自该项目，特此感谢！
A desktop GUI for copilot-proxy, built with Electron + React + Vite. Manage the proxy service without the command line.
- GitHub OAuth login (Device Code flow, built-in verification code popup)
- Auto-detect account type (individual / business / enterprise)
- Service start/stop, standalone log viewer popup window (filter, follow/pause, adjustable font size, word wrap, theme sync)
- Model list fetching & default/fast model selection (saves on select, with one-click model refresh on the main screen)
- Claude Code integration: one-click launch & write/clear
~/.claude/settings.json; when persistent Claude config already exists, model changes auto-sync - Claude Code
--dangerously-skip-permissionsmode: optional setting to skip permission checks, with two-stage confirmation dialogs (on enable + on launch) - Usage dashboard (quota progress bar + collapsible detail view)
- Conversation recording: save proxy requests and AI responses to local JSON files, with built-in viewer (session/date grouping, full-text search, batch delete, real-time push, theme/language sync)
- Risk disclaimer dialog (shown on first launch, must accept before starting)
- 5 built-in themes: Lavender (Frost), Peach (Sakura), Cherry, Midnight, Aurora
- Settings: port, account type, verbose logging, manual approval, rate limiting, etc.
- System tray: start/stop, model info, minimize to tray
- Chinese/English bilingual support (one-click toggle, auto-detects system language on first launch)
- Claude Code installation check (warns and disables buttons if not installed)
- Cross-platform support: Windows & macOS (arm64 + x64)
- Configurable close behavior (minimize to tray / quit / ask each time, with remember option)
Download from the Releases page:
- Windows: Installer (
-setup.exe, recommended, supports lightweight updates) or Portable edition (-portable.exe) - macOS: DMG installer (arm64 for Apple Silicon, x64 for Intel)
macOS First Launch Note
The app is not notarized by Apple, so macOS will show a warning. To open it:
- Double-click the DMG to mount, then drag the app to Applications
- Right-click (or Control+click) the app → select "Open" → click "Open" in the dialog
- If "Open" is not available, go to System Settings → Privacy & Security, scroll down and click "Open Anyway"
- This is only needed the first time; after that you can double-click to open normally
# Clone the repo (with submodules)
git clone --recurse-submodules https://github.com/kylefu8/copilot-proxy-gui.git
cd copilot-proxy-gui
# Install dependencies
npm install
# Install proxy dependencies
cd copilot-proxy && bun install && cd ..
# Start in dev mode
npm run desktop:devnpm run desktop:buildOutput is in the release/ directory.
- Frontend: React 18 + Vite 5
- Desktop shell: Electron 33
- Proxy service: copilot-proxy (git submodule)
The GUI connects to local http://localhost:4399 by default. The port can be changed in Settings.
The proxy child process is automatically stopped when the window is closed.
| Command | Description |
|---|---|
service_start |
Start proxy |
service_stop |
Stop proxy |
service_logs |
Get logs |
auth_status |
Check token status |
auth_device_code_start |
Start Device Code login |
delete_token |
Delete saved token |
fetch_models |
Fetch model list |
detect_account_type |
Detect account type |
launch_claude_code |
Launch Claude Code |
write_claude_env |
Write Claude config |
clear_claude_env |
Clear Claude config |
check_claude_env |
Check Claude config |
check_claude_installed |
Check if Claude Code CLI is installed |
open_external |
Open external link |
resize_window |
Resize window |
open_log_window |
Open standalone log viewer window |
update_log_theme |
Sync theme to log viewer window |
open_conversation_window |
Open conversation viewer window |
list_conversation_sessions |
List all conversation sessions |
load_conversation_session |
Load entries for a session |
delete_conversation_sessions |
Delete specific sessions |
clear_conversations |
Clear all conversation data |
This project is based on copilot-proxy by Jer-y. Special thanks!