CLIProxyAPI + OpenCode

AI 编程工具如今如雨后春笋一般，而且都变得好用了。不过，一般还是建议使用 IDE 或 VS Code 插件。

IDE 可选：

• 字节 Trae：https://www.trae.cn/
• 腾讯 CodeBuddy：https://www.codebuddy.cn/
• 阿里 Qoder：https://qoder.com/

以上均支持 Windows 和 macOS，目前只有 Qoder 支持 Linux。注意区分国内版与海外版，差别主要在于模型与费用。

VS Code 插件可选：

• Copilot
• Cline
• Lingma
• Windsurf
• ...

所有工具的对比与选择，您都可以进一步咨询 AI。

而本文要介绍的是另一种玩法：CLI 代理 —— CLIProxyAPI。

介绍

CLIProxyAPI

CLIProxyAPI 是一个为 CLI 提供 OpenAI/Gemini/Claude/Codex 兼容 API 接口的代理服务器。

您可以使用本地或多账户的 CLI 方式，通过任何与 OpenAI/Gemini/Claude 兼容的客户端和 SDK 进行访问。

也就是，通过 CLIProxyAPI 可以把 Gemini/Claude/Codex 等多个模型，都通过统一的 API 对外开放。

之后，在编程工具或 VS Code 插件里把 OpenAI API 改成自己的代理地址就可以用了。或者，用脚本访问服务。

另外，其杀手级功能则是多账号负载均衡与高可用、团队共享与远程访问。

• 多账号轮询：可以登录多个账号，代理会自动轮询使用，突破单账号的速率限制
• 自动故障转移：某个账号超限或报错，自动切换到下一个可用账号
• 权重分配：可以为不同账号设置权重（比如付费账号权重高，免费账号权重低）

OpenCode

那有了 CLIProxyAPI 代理服务，怎么用起来呢？本文将结合 OpenCode 来打造自己的 AI 编程助手。

OpenCode 是一个开源的 AI 编码代理。它提供终端界面、桌面应用和 IDE 扩展等多种使用方式。

其通过 CLIProxyAPI 提供的统一 API 入口，就可以把 Gemini/Claude/Codex 等多个模型都用起来。

那我们开始吧 ☺️

开始

以下是 Linux 安装步骤，建议依照官方手册进行。

CLIProxyAPI

一键安装,

# https://help.router-for.me/cn/introduction/quick-start.html
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

Go 代码 🤔，有环境直接源码编译，再 systemd 管理服务。

配置使用，

$ cd ~/cliproxyapi/

# 使用配置
#  auth-dir 指定凭证目录，用于多账户
#  remote-management 管理页面设定，密钥加一下
$ nano config.yaml

# Codex OAuth 登录
$ ./cli-proxy-api --codex-login
...
Codex authentication successful
Saving credentials to /home/john/.cli-proxy-api/codex-*.json
Authentication saved to /home/john/.cli-proxy-api/codex-*.json
Codex authentication successful!

# 启动服务
$ ./cli-proxy-api
...
API server started successfully on: :8317

# 常驻服务
$ systemctl --user start cliproxyapi.service

# 访问服务
$ curl http://localhost:8317/
{"endpoints":["POST /v1/chat/completions","POST /v1/completions","GET /v1/models"],"message":"CLI Proxy API Server"}

# 管理界面
$ open http://localhost:8317/management.html

管理界面，

OpenCode

一键安装,

# https://opencode.ai/docs/zh-cn/
curl -fsSL https://opencode.ai/install | bash
# or
npm i -g opencode-ai@latest

$ opencode -v
1.2.24

配置使用，

# 设置环境变量（快速开始）
cat <<-EOF >> ~/.bashrc
# openai
export OPENAI_BASE_URL="http://localhost:8317/v1"
export OPENAI_API_KEY="sk-gocoding"
EOF

printenv | grep OPENAI

# 使用全局配置（规范方式）
nano ~/.config/opencode/opencode.json

# 启动 OpenCode
opencode

# 启动 OpenCode，指定工程目录
mkdir -p ~/Codes/hello-code
opencode ~/Codes/hello-code

运行界面，

编写代码，

更多玩意，

• Awesome OpenCode

结语

CLIProxyAPI + OpenCode 准备好了，那就愉快地写代码吧 👾