
Hermes 与 CLIProxyAPI
日常写代码还是 Cursor + Claude Code + Codex。下面两块都不替代 IDE,补的是 IDE 之外:
| Hermes | CLIProxyAPI | |
|---|---|---|
| 干什么 | 本机常驻 Agent,聊天软件也能当入口 | 把已登录的 CLI 订阅转成本地兼容 API |
| 主场 | 本机进程、网关、记忆与 skills | 127.0.0.1:8317 上的代理 |
| 不干什么 | 不盯 UI、不改像素 | 不当 IDE,也不创造额外额度 |
Hermes 自己就能换 provider,不一定非经 CLIProxyAPI。CLIProxyAPI 更适合「客户端只认 OpenAI / Claude 接口,手里却是 CLI 订阅」。
Hermes Agent
Nous Research 的开源 Agent。仓库:NousResearch/hermes-agent。文档:hermes-agent.nousresearch.com/docs。MIT。
模型随便换:OpenRouter、OpenAI、Anthropic、DeepSeek、本地,一条 hermes model 切。自己现在走 DeepSeek,微信网关也是它在回。
和 Cursor / Claude Code 的差别:
| Cursor / Claude Code | Hermes | |
|---|---|---|
| 主场 | 仓库、编辑器、终端 | 本机常驻进程 |
| 入口 | IDE / CLI | CLI、桌面 App、Telegram / Discord / Slack / 微信… |
| 记忆 | 基本按会话 | 跨会话记偏好、环境、教训 |
| 复用 | 项目里的 rules / CLAUDE.md | skills,做完难活可以存成下次直接加载的流程 |
它会自己搜过去的会话,复杂任务结束后可以写成 skill。定时任务也能配,做完推到微信或 Telegram。
安装
macOS / Linux / WSL:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc
hermes
Windows 用 PowerShell:iex (irm https://hermes-agent.nousresearch.com/install.ps1)。
装完先走向导:
hermes setup
hermes model
hermes doctor
不想攒一堆 key,可以用 Nous Portal,一条 hermes setup --portal 把模型和部分工具网关绑到订阅上。自己没走这条,模型用 DeepSeek,工具按需开。
自己怎么用
hermes # 终端对话
hermes desktop # 桌面 App
hermes gateway # 消息网关
配置在 ~/.hermes/config.yaml,密钥只放 ~/.hermes/.env。项目约定还是写进仓库的 AGENTS.md / CLAUDE.md,它会读。
微信这条线:网关连上之后,手机发一句,本机 Agent 调工具再回。合盖会睡的话,会话就断;要关盖还跑,得另想办法(Amphetamine,或者专门给 Agent 保活的 Adrafinil)。
适合:本机自动化、定时汇报、手机远程支使电脑、多平台同一套脑子。
不适合:人还在编辑器里盯 UI、改像素。那种继续 Cursor。边界清楚的长任务继续 Claude Code。
它能执行本机命令、读文件、开浏览器。网关务必开配对 / 白名单,别对所有人开放。密钥别写进聊天记录。
CLIProxyAPI
日常那套里,CC Switch 解决的是「同一套 Claude Code 换供应商」。CLIProxyAPI 反过来:订阅已经在 CLI 里登过了,想给 Cursor、Cline、自写脚本当 API 用。
仓库:router-for-me/CLIProxyAPI。手册:help.router-for.me。桌面端:EasyCLIProxyAPI。
本机起一个代理。你用各家 CLI 的 OAuth 登录(Claude Code、OpenAI Codex、Google Antigravity / Gemini、Grok Build,也接 Kimi),它对外提供 OpenAI / Gemini / Claude / Codex / Grok 兼容端点。客户端改 base_url 指向本机即可。
多账号可以轮询。上游也能配 OpenRouter 这类 OpenAI 兼容服务。流式、工具调用、图文输入都支持。默认监听 8317。
和中转站不是一类东西。中转站卖的是别人的 key;这个跑在你机器上,用的是你自己登进去的订阅。
安装
macOS 用 Homebrew,服务默认读 $(brew --prefix)/etc/cliproxyapi.conf。想继续用家目录配置,先有文件再软链,悬空软链服务会立刻退:
brew install cliproxyapi
mkdir -p ~/.cli-proxy-api
# 按官方示例准备好 ~/.cli-proxy-api/config.yaml 之后:
brew_conf="$(brew --prefix)/etc/cliproxyapi.conf"
ln -sfn "$HOME/.cli-proxy-api/config.yaml" "$brew_conf"
brew services start cliproxyapi
懒得点命令,装 EasyCLIProxyAPI,托盘里启停、改配置。
Docker:
docker run --rm -p 8317:8317 \
-v /path/to/config.yaml:/CLIProxyAPI/config.yaml \
-v /path/to/auth-dir:/root/.cli-proxy-api \
-v /path/to/plugins:/CLIProxyAPI/plugins \
eceasy/cli-proxy-api:latest
插件目录要挂进去,不然容器一重启,商店里装的插件就没了。
登录走官方文档里的 OAuth 流程(Claude / Codex / Gemini / Grok 各有一条)。登完,把 Cursor、Cline、OpenCode 的 API 地址指到 http://127.0.0.1:8317。
用量统计从 v6.10.0 起不再内置,要看板用 CPA Usage Keeper 或 CPA-Manager-Plus。
和现有工具怎么叠
| 需求 | 用谁 |
|---|---|
| Claude Code 换 DeepSeek / GLM | CC Switch |
| 订阅当 API,给别的客户端用 | CLIProxyAPI |
| 只想便宜、国内直连 | DeepSeek 官方 API |
| 人在仓库里写代码 | Cursor / Claude Code,别把代理当 IDE |
| 本机常驻、微信入口 | Hermes;它能自己换模型,不必先过这层代理 |
别当免费午餐
各家订阅条款通常按「官方客户端」算,拿 OAuth 转成通用 API,可能违 ToS,封号、限流自己扛。号池、轮询、对外网开端口,风险再加一档。本机 127.0.0.1、加访问密钥,别裸奔到公网。
额度窗口还在(Codex 的 5h / 7d 那些),代理不会变出更多配额,只是换了入口。模型名、渠道别名以当前文档为准,README 里的 GPT / Claude / Gemini 版本号更新很快。
自己的用法:官方额度紧、又想在只认标准 API 的工具里蹭已有订阅时再开。日常写代码,还是直接走对应客户端更省事。
工具会换。Hermes 值一试的点是入口不绑死在 IDE;CLIProxyAPI 值一试的点是订阅能被别的客户端接着用。两者都不要当成「免费无限额度」。