5分钟跑通EasyCLIProxyAPI新手快速开始教程含离线安装与核心启动【免费下载链接】EasyCLIProxyAPIA desktop GUI for CLIProxyAPI and a tool for automatically configuring popular AI agents.项目地址: https://gitcode.com/gh_mirrors/easy/EasyCLIProxyAPIEasyCLIProxyAPI 是 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获取对应操作系统的发行包Windows 为 ZIPmacOS 为 DMGLinux 为 TAR.GZWindows / Linux 用户解压压缩包即可macOS 用户打开 DMG 安装启动 EasyCLIProxyAPI操作系统架构格式Windowsamd64、aarch64ZIPmacOSamd64、aarch64DMGLinuxamd64、aarch64TAR.GZ Linux 与 macOS 都支持应用内自动升级启动失败时自动回滚无需担心升级翻车。三、第二步安装内核含离线安装方法启动软件后进入左侧的版本管理页面这是新手最容易被忽略的一步软件只是外壳真正干活的 CLIProxyAPI 内核需要先安装。安装内核有两种方式在线安装直接安装最新版本。页面支持切换 GitHub 官方源、GitCode 国内源或 GitHub 镜像代理还可以添加自定义 HTTPS 镜像前缀更新会优先使用所选渠道失败时自动回退离线安装发行包本身已携带匹配版本的 CLIProxyAPI 内核压缩包当前内置版本见 core-version.txt在没有外网的环境里也能完成安装⚠️ 注意更新检查只负责比对版本不会自动下载或安装一切由你手动确认。各版本的更新说明可在 docs/release-notes/ 中按语言查阅。四、第三步启动内核并复制本地 API 地址内核安装完成后回到首页点击启动按钮等待「运行状态」变为运行中确认「安装状态」「内核版本」「进程 PID」等信息正常显示复制所需的本地 API 地址OpenAI 兼容格式http://127.0.0.1:8317/v1Claude 兼容格式 / Gemini 兼容格式http://127.0.0.1:8317此时「API 接入」卡片会显示可连接状态说明本地代理服务已经跑通任何支持自定义 Base URL 的客户端都可以直接接入。内核的安装、版本对比逻辑实现在 src-tauri/src/main.rs 中想深挖源码的同学可以从这里入手。五、第四步接入上游服务二选一本地代理跑通后给它配上上游才能真正调用模型。EasyCLIProxyAPI 提供两条路径方式 AOAuth 浏览器登录适合有对应订阅账号的用户进入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 的功能导览章节。七、常见问题速查问题解决办法首页显示「未安装」去版本管理页面先安装 CLIProxyAPI 内核下载内核超时在版本管理页面切换为 GitCode 国内源或镜像代理无外网环境使用发行包内置内核压缩包执行离线安装浏览器授权跳不回来OAuth 页面支持手动粘贴回调链接完成登录升级后功能异常应用内升级失败会自动回滚也可手动重装完整包结语跟着以上五步走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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考