什么是 CLIProxyAPI（命令行转标准 API 代理）？
很多顶级 AI 工具（如 GitHub Copilot CLI、Claude Code、Cursor、Gemini CLI 等）原本只能在黑框终端里由人类用键盘逐字敲命令交互，外部程序根本无法直接调用；而 CLIProxyAPI 就像一个“万能转接头兼外卖点单窗口” —— 在本地架设一个标准的 HTTP 代理网关，将第三方的标准 OpenAI/Anthropic API 请求自动翻译为命令行进程指令或借用终端凭据直发云端，让任何 GUI 客户端、Agent 和自动化脚本都能无缝接入！
只能人手敲键盘，第三方软件无法接入
官方为了绑定生态，只提供终端命令行客户端。输出结果夹杂着大量的 ANSI 颜色字符、光标控制码和交互式问答等待，其他软件（如 NextChat、Cherry Studio、Dify）根本无法通过标准的 HTTP 接口直接调用它。
- ❌ 接口不标准：没有暴露可编程的 JSON RESTful API
- ❌ 生态孤立：无法直接接入现有成熟的 Web 聊天面板和 Agent 框架
本地暴露标准 /v1 接口，生态秒级打通
在后台常驻运行，对外提供标准的 http://localhost:8080/v1/chat/completions。收到请求后，自动转译为 CLI 进程调用或借用其 OAuth 登录凭证直连官方核心，流式 SSE 返回给任何第三方客户端！
- ✨ 全生态兼容：一行配置让各种开源 WebUI / IDE 插件直接复用
- ✨ 流式无损打字机：完整支持 SSE（Server-Sent Events）毫秒级吐字
拆解 CLIProxyAPI 的 4 大核心支柱
从协议转译到伪终端模拟，读懂接口桥接的核心设计
1. OpenAI / Anthropic 协议对齐
提供 /v1/chat/completions 与 /v1/models 标准端点，自动完成多轮 messages 数组与提示词结构转换。
2. OAuth 凭证拦截与保活
读取本地 CLI 登录后生成的缓存 Token（如 ~/.config 凭据），在后台自动处理 Token 续期与请求头伪装。
3. PTY 伪终端与 ANSI 码清洗
对于纯进程调用模式，通过模拟 Linux PTY 虚拟终端消除控制台阻塞，并精准剥离终端颜色与光标乱码。
4. SSE 流式切片透传 (Streaming)
将 CLI 产生的实时标准输出（stdout）切分成标准的 data: {"choices": [{"delta": ...}]} 数据流，实现流畅打字机效果。
🕹️ CLIProxyAPI 请求流转与转译演练台
观察外部客户端发起一个标准请求时，代理中间件内部如何进行转译与数据回传：
http://127.0.0.1:8080/v1 发送标准 OpenAI 格式的 JSON 载荷，声明模型为 claude-3-5-sonnet。
让订阅特权在所有应用中通用
开发者拥有特定平台的 CLI 订阅（如 Copilot / Claude 终端），但更习惯使用 Obsidian 笔记插件、VSCode 扩展或沉浸式翻译等第三方工具。
通过 CLIProxyAPI 即可把这些特权直接转化为全机通用的 API Key，实现全工作流无缝互通。
子进程包装 vs 逆向网络层代理
- 子进程模式（Subprocess Wrapper）： 本地动态 spawn 启动 CLI 进程，通过管道读取标准输入输出；
- 协议级逆向代理（Direct Protocol Proxy）： 仅提取 CLI 的登录 Session/Cookie，直接在内存中构造官方私有 gRPC/HTTPS 数据包直连云端，性能极高。
避免高频并发与账号风险
官方平台通常会对客户端的请求特征（User-Agent、请求指纹、频率限制）进行严格的风控检测。
使用 CLIProxyAPI 时需合理控制请求并发数（Pacing），并妥善保管本地 Token，杜绝将代理端点无保护暴露在公网上。