English | 简体中文 | 日本語

EasyCLIProxyAPI

A portable desktop console for CLIProxyAPI.
Our goal is to make tokens free—as in freedom.

Overview

EasyCLIProxyAPI is a graphical desktop management tool built on CLIProxyAPI. It brings core lifecycle management, OAuth authorization, API provider aggregation, protocol conversion, credential management, quota inspection, usage records, model aliases, and agent client configuration into one interface.

The application is built with Tauri, React, and Rust. It can carry a matching CLIProxyAPI core archive, making first-time setup and offline installation easier.

Feature Tour

Core dashboard and version management

The core dashboard provides a complete view of the local proxy runtime:

• Start, stop, restart, and refresh the CLIProxyAPI core.
• View installation state, runtime state, process ID, listening port, and LAN access settings.
• Compare the installed, latest, and bundled core versions.
• Install the latest core, reinstall it, or use an offline package when GitHub is unavailable.
• Copy ready-to-use OpenAI, Claude, and Gemini-compatible API endpoints.
• Check the EasyCLIProxyAPI application version and local connectivity from one page.

OAuth account authorization

The OAuth page centralizes browser-based authorization for supported providers:

• Codex OAuth
• Claude OAuth
• Antigravity OAuth
• Kimi OAuth
• xAI OAuth

EasyCLIProxyAPI opens the authorization page in the browser and supports completing the callback flow when an automatic redirect is unavailable.

API provider aggregation

The provider workspace manages upstream API credentials and endpoints by protocol or provider:

• Codex
• OpenAI-compatible providers
• DeepSeek
• Claude
• Gemini

You can add multiple connections, search existing entries, refresh provider state, and use them through the unified local CLIProxyAPI endpoint. Requests and responses can be converted between supported OpenAI, Claude, Gemini, and compatible formats.

Agent client configuration

The agent client page detects installed desktop and CLI clients and helps connect them to the local proxy. Supported clients include:

• Claude Code
• Claude Desktop
• Codex
• OpenCode
• OpenClaw
• Hermes Agent

For supported clients, the application can synchronize the available model catalog, select a default model, back up the original configuration before applying managed settings, restore the previous configuration, and launch an available desktop or CLI entry point.

Additional Capabilities

• Manage core settings, API keys, remote management credentials, plugins, and routing strategy.
• Create client-visible model aliases and map them to provider models and reasoning levels.
• Upload, download, inspect, and manage authentication files.
• Review provider quotas and account availability.
• Browse local usage records and token statistics.
• Keep the application available from the macOS menu bar or Windows system tray.

Quick Start

1. Download the package for your operating system from GitHub Releases.
2. Extract the Windows or Linux archive, or open the macOS DMG.
3. Launch EasyCLIProxyAPI.
4. Open the Core page and install the bundled or latest CLIProxyAPI core.
5. Start the core, then copy the required local endpoint or configure an OAuth/API provider.

Supported Platforms

GitHub Actions builds the following release packages:

Operating System	Architecture	Package
Windows	amd64, aarch64	ZIP
macOS	amd64, aarch64	DMG
Linux	amd64, aarch64	TAR.GZ

Related Project

• CLIProxyAPI — the proxy core managed by this application.