AI 编程工具如今如雨后春笋一般,而且都变得好用了。不过,一般还是建议使用 IDE 或 VS Code 插件。
IDE 可选:
- 字节 Trae:www.trae.cn/
- 腾讯 CodeBuddy:www.codebuddy.cn/
- 阿里 Qoder: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
运行界面,
编写代码,
更多玩意,
结语
CLIProxyAPI + OpenCode 准备好了,那就愉快地写代码吧 👾