企业官网建设流程全解析

5分钟跑通EasyCLIProxyAPI：新手快速开始教程（含离线安装与核心启动）

【免费下载链接】EasyCLIProxyAPIA desktop GUI for CLIProxyAPI and a tool for automatically configuring popular AI agents.项目地址: https://gitcode.com/gh_mirrors/easy/EasyCLIProxyAPI

EasyCLIProxyAPI 是 CLIProxyAPI 的便携桌面控制台，一个图形化的 AI 代理管理工具：把内核安装、OAuth 授权、API 接入、配额查询和使用记录集中到一个界面里，还能自动配置主流 AI 智能体客户端。本教程带你 5 分钟内完成安装、离线安装内核并启动本地 API 服务。

一、快速认识：EasyCLIProxyAPI 能做什么

第一次打开 EasyCLIProxyAPI 桌面控制台，你会看到这样的首页：左侧是功能导航（首页、API 接入、OAuth、智能体配置、使用记录等），右侧集中展示内核运行状态和三个可直接复制的本地 API 地址。

它的核心能力包括：

• 内核生命周期管理：一键启动、停止、重启 CLIProxyAPI 内核
• OAuth 账号授权：Codex、Claude、Antigravity、Kimi、xAI 等浏览器登录
• API 接入与协议转换：多 Provider 聚合，OpenAI / Claude / Gemini 协议互转
• 智能体客户端配置：自动把 Claude Code、Codex、OpenCode 等客户端指向本地代理
• 使用记录统计：Token 消耗、TPS、成功率、预估成本一目了然

项目整体由 Tauri、React 和 Rust 构建，发行包可携带匹配版本的 CLIProxyAPI 内核压缩包，首次安装和离线安装都很方便，这也是本教程的重点之一。

二、第一步：下载安装包（支持 Windows / macOS / Linux）

1. 获取对应操作系统的发行包（Windows 为 ZIP，macOS 为 DMG，Linux 为 TAR.GZ）
2. Windows / Linux 用户解压压缩包即可，macOS 用户打开 DMG 安装
3. 启动 EasyCLIProxyAPI

💡 Linux 与 macOS 都支持应用内自动升级，启动失败时自动回滚，无需担心升级翻车。

三、第二步：安装内核（含离线安装方法）

启动软件后，进入左侧的版本管理页面，这是新手最容易被忽略的一步：软件只是外壳，真正干活的 CLIProxyAPI 内核需要先安装。

安装内核有两种方式：

• 在线安装：直接安装最新版本。页面支持切换 GitHub 官方源、GitCode 国内源或 GitHub 镜像代理，还可以添加自定义 HTTPS 镜像前缀；更新会优先使用所选渠道，失败时自动回退
• 离线安装：发行包本身已携带匹配版本的 CLIProxyAPI 内核压缩包（当前内置版本见 core-version.txt），在没有外网的环境里也能完成安装

⚠️ 注意：更新检查只负责比对版本，不会自动下载或安装，一切由你手动确认。各版本的更新说明可在 docs/release-notes/ 中按语言查阅。

四、第三步：启动内核并复制本地 API 地址

内核安装完成后，回到首页：

1. 点击启动按钮，等待「运行状态」变为运行中
2. 确认「安装状态」「内核版本」「进程 PID」等信息正常显示
3. 复制所需的本地 API 地址：
   • OpenAI 兼容格式：http://127.0.0.1:8317/v1
   • Claude 兼容格式 / Gemini 兼容格式：http://127.0.0.1:8317

此时「API 接入」卡片会显示可连接状态，说明本地代理服务已经跑通，任何支持自定义 Base URL 的客户端都可以直接接入。内核的安装、版本对比逻辑实现在 src-tauri/src/main.rs 中，想深挖源码的同学可以从这里入手。

五、第四步：接入上游服务（二选一）

本地代理跑通后，给它配上"上游"才能真正调用模型。EasyCLIProxyAPI 提供两条路径：

方式 A：OAuth 浏览器登录（适合有对应订阅账号的用户）

进入OAuth页面，选择 Codex / Claude / Antigravity / Kimi / xAI 等登录卡片，点击开始登录。软件会自动打开浏览器授权页；如果浏览器无法自动跳回，还支持手动粘贴回调完成授权，对网络环境比较友好。

方式 B：手动添加 API Key（适合有现成 Key 的用户）

进入API 接入页面，按协议分类（Codex、OpenAI 兼容、DeepSeek、Claude、Gemini）管理上游凭证。点击新增填入密钥和服务地址后，可随时执行健康检测验证连通性；多个接入配置可以共存，统一通过本地 CLIProxyAPI 地址调用，协议自动转换。

六、下一步：让 AI 智能体接上本地代理

前面四步完成后，你可以进入智能体配置页面：软件会自动检测本机已安装的 Claude Code、Claude Desktop、Codex、OpenCode、Kimi Code 等客户端，帮助它们连接本地代理，并支持同步模型目录、选择默认模型、备份和恢复原始配置。更多功能说明见 README.zh-CN.md 的功能导览章节。

七、常见问题速查

结语

跟着以上五步走，5 分钟即可拥有一个稳定运行的本地 AI API 代理：安装包 → 装内核 → 启动 → 配上游 → 接智能体。EasyCLIProxyAPI 最大的价值在于把繁琐的 CLI 配置、协议转换和客户端接入全部图形化，新手也能零命令行上手。祝你使用愉快 🚀

【免费下载链接】EasyCLIProxyAPIA desktop GUI for CLIProxyAPI and a tool for automatically configuring popular AI agents.项目地址: https://gitcode.com/gh_mirrors/easy/EasyCLIProxyAPI