【Agent工坊】Hermes Proxy 实战：一个订阅打通 Codex/Aider/Cline 全家桶

Hermes Agent v0.14 发布了一个杀手级功能——hermes proxy。你只需一个 Claude Pro 或 ChatGPT Pro 订阅，就能让所有 AI 编程工具共用同一个账号，彻底告别为每个工具单独买 API Key 的苦日子。

这是什么？为什么你需要它？

AI 创业者每天至少要用 3-5 个 AI 编程工具：Codex CLI 写后端、Aider 重构代码、Cline 做前端、Continue 在 VS Code 里补全……每个工具都要求你填一个 API Key。如果你用 OpenAI API，一个月烧掉 200-500 美元是常态。

Hermes Agent v0.14 的 hermes proxy 功能解决了这个痛点：它在你本地启动一个 HTTP 服务，对外暴露标准 OpenAI API 接口，对内把你的 OAuth 订阅账号（Claude Pro $20/月、ChatGPT Pro $200/月、SuperGrok $30/月）转换成 API 调用。任何支持 OpenAI 兼容端点的工具都能直接连上，不需要单独的 API Key，不需要额外付费。

核心价值

场景	旧方案	新方案（hermes proxy）
Codex CLI 写代码	买 OpenAI API Key（按量付费）	用已有的 ChatGPT Pro 订阅
Aider 重构	买 Claude API Key（按量付费）	用已有的 Claude Pro 订阅
Cline 前端开发	分别配置多个 Key	一个 proxy，自动路由
月成本	$200-500+	$20-200（就是你已有的订阅费）

环境准备

前置条件

# 1. 安装 Hermes Agent v0.14+

pip install hermes-agent

# 2. 确认版本号 ≥ v2026.5.16

hermes --version

# 输出: hermes-agent v2026.5.16

# 3. 至少有一个 OAuth 登录的 AI 服务订阅

# Claude Pro ($20/月) — 推荐性价比最高

# ChatGPT Pro ($200/月) — 需要 unlimited 用量

# SuperGrok ($30/月) — Grok-4.3 1M 上下文窗口

OAuth 登录（以 Claude Pro 为例）

# 添加 Anthropic 作为 provider

hermes provider add anthropic

# 这会打开浏览器，让你用 Anthropic 账号登录

# 如果是在远程服务器上，增加 SSH 隧道：

# ssh -L 8080:localhost:8080 user@your-server

# 然后在本机浏览器打开 http://localhost:8080 完成登录

登录成功后，你就可以在聊天里直接用 Claude 了：

hermes "用 Python 写一个快速排序"

核心操作：启动 Proxy

基本启动

# 启动 proxy，默认监听 localhost:11434

hermes proxy

# 输出：

# [proxy] OpenAI-compatible server listening on http://localhost:11434

# [proxy] Backed by: anthropic (Claude Pro via OAuth)

# [proxy] Models available: claude-sonnet-4-20250514, claude-opus-4-20250514

启动后，你的 localhost:11434 就是一个标准的 OpenAI API 端点。任何支持 OPENAI_API_BASE 环境变量的工具都能直接连上。

自定义端口

# 如果 11434 被 Ollama 占用，换一个端口

hermes proxy --port 11435

后台运行

# 生产环境用 nohup 或 tmux 保持 proxy 常驻

nohup hermes proxy --port 11434 > /tmp/hermes-proxy.log 2>&1 &

# 或者用 systemd（推荐）

sudo tee /etc/systemd/system/hermes-proxy.service << 'EOF'

[Unit]

Description=Hermes Agent OpenAI-Compatible Proxy

After=network.target

[Service]

Type=simple

User=your-user

ExecStart=/home/your-user/.local/bin/hermes proxy --port 11434

Restart=on-failure

RestartSec=5

[Install]

WantedBy=multi-user.target

EOF

sudo systemctl daemon-reload

sudo systemctl enable --now hermes-proxy

实战：连接各 AI 编程工具

场景1：Codex CLI（OpenAI 官方编程助手）

Codex CLI 是 OpenAI 的命令行编程工具，原生只支持 OpenAI API。现在用 hermes proxy 让它走你的 ChatGPT Pro 订阅：

# 配置 Codex 使用本地 proxy

export OPENAI_API_BASE="http://localhost:11434/v1"

export OPENAI_API_KEY="hermes-proxy" # 任意值，proxy 不校验

# 启动 Codex，现在它用你的 ChatGPT Pro 订阅

codex "重构 src/auth.py，提取 JWT 验证逻辑到独立模块"

踩坑提醒：Codex 默认用 gpt-5.1 模型名。如果你的 proxy 后端是 Claude，需要指定模型名。用 hermes proxy --default-model claude-sonnet-4-20250514 设置默认模型，或者 Codex 侧指定 --model claude-sonnet-4-20250514。

场景2：Aider（AI 结对编程）

Aider 是社区最受欢迎的 AI 编程搭档，支持多模型切换。现在让它走你的 Claude Pro 订阅：

# 配置 Aider 使用本地 proxy

export OPENAI_API_BASE="http://localhost:11434/v1"

export OPENAI_API_KEY="hermes-proxy"

# Aider 方式一：以 OpenAI 兼容模式连接

aider --model openai/claude-sonnet-4-20250514

# Aider 方式二：直接传环境变量

aider --model openai/claude-sonnet-4-20250514 \

--openai-api-base http://localhost:11434/v1 \

--openai-api-key hermes-proxy

实测输出示例：

$ aider --model openai/claude-sonnet-4-20250514

Aider v0.76.0

Model: openai/claude-sonnet-4-20250514 (via http://localhost:11434/v1)

Git repo: /home/user/my-project

───────────────────────────────────────────────

> 帮我把这个 Express 路由拆成 controller + service 层

我来分析一下当前的路由结构...

[修改了 3 个文件]

- src/routes/users.js → 删除路由逻辑，只保留路由注册

- src/controllers/userController.js → 新建，提取请求处理

- src/services/userService.js → 新建，提取业务逻辑

改动已完成。需要我继续重构其他路由吗？

场景3：Cline（VS Code AI 编程插件）

Cline 是 VS Code 里最火的 AI 编程插件，通常需要 Anthropic API Key。现在用 hermes proxy 省掉这笔钱：

VS Code 设置（settings.json）：

{

"cline.apiProvider": "openai",

"cline.openAiBaseUrl": "http://localhost:11434/v1",

"cline.openAiApiKey": "hermes-proxy",

"cline.openAiModel": "claude-sonnet-4-20250514"

}

配置完成后，Cline 的所有 AI 请求——代码补全、重构、解释——都走你的 Claude Pro 订阅，无需额外付费。

场景4：Continue（开源 AI 编程助手）

Continue 是 VS Code 和 JetBrains 的开源 AI 补全插件：

Continue 配置（~/.continue/config.json）：

{

"models": [

{

"title": "Claude via Hermes Proxy",

"provider": "openai",

"model": "claude-sonnet-4-20250514",

"apiBase": "http://localhost:11434/v1",

"apiKey": "hermes-proxy"

}

"tabAutocompleteModel": {

"title": "Claude via Hermes Proxy",

"provider": "openai",

"model": "claude-sonnet-4-20250514",

"apiBase": "http://localhost:11434/v1",

"apiKey": "hermes-proxy"

}

场景5：自建脚本 / 自定义工具

你也可以在自己写的 Python 脚本里调用 proxy：

import openai

client = openai.OpenAI(

base_url="http://localhost:11434/v1",

api_key="hermes-proxy" # 任意值

)

# 自动代码审查脚本

def review_code(filepath: str) -> str:

with open(filepath) as f:

code = f.read()

response = client.chat.completions.create(

model="claude-sonnet-4-20250514",

messages=[

{"role": "system", "content": "你是一个资深代码审查员。找出bug、安全问题、性能瓶颈。"},

{"role": "user", "content": f"审查以下代码：\n```\n{code}\n```"}

]

)

return response.choices[0].message.content

# 批量审查所有 Python 文件

from pathlib import Path

for py_file in Path("src").rglob("*.py"):

result = review_code(str(py_file))

print(f"\n{'='*60}")

print(f"📄 {py_file}")

print(result)

高级配置

多 Provider 自动路由

如果你的 Hermes 同时登录了多个 provider——比如 Claude Pro + SuperGrok——proxy 会根据请求的 model 名自动选择后端：

# 同时添加多个 provider

hermes provider add anthropic # Claude Pro

hermes provider add xai # SuperGrok

# 启动 proxy，它自动暴露所有可用模型

hermes proxy

# 输出:

# [proxy] Backed by: anthropic, xai

# [proxy] Models: claude-sonnet-4-20250514, claude-opus-4-20250514,

# grok-4.3 (1M context)

然后不同用途用不同模型：

使用场景	推荐模型	原因
日常编程	claude-sonnet-4	性价比最高，代码能力强
复杂架构重构	claude-opus-4	最强推理能力
超大代码库分析	grok-4.3	1M 上下文窗口，可一次扔进几十万行代码
前端 UI 代码	claude-sonnet-4	视觉理解能力强

多用户共享（团队场景）

如果你和同事共用一个服务器，可以为每个人启动独立的 proxy 实例：

# 用户 A（用 ChatGPT Pro）

hermes proxy --port 11435 --default-provider openai

# 用户 B（用 Claude Pro）

hermes proxy --port 11436 --default-provider anthropic

# 用户 C（用 SuperGrok）

hermes proxy --port 11437 --default-provider xai

限流保护

防止某个工具刷爆你的订阅：

# 在 proxy 前面加一层 nginx 限流

sudo tee /etc/nginx/sites-available/hermes-proxy << 'EOF'

server {

listen 8080;

location / {

# 每分钟最多 30 个请求

limit_req zone=hermes burst=10 nodelay;

proxy_pass http://localhost:11434;

proxy_set_header Host $host;

}

EOF

sudo ln -s /etc/nginx/sites-available/hermes-proxy /etc/nginx/sites-enabled/

sudo nginx -t && sudo systemctl reload nginx

踩坑与排障

踩坑1：Ollama 端口冲突

症状：hermes proxy 报错 Address already in use。

原因：Ollama 默认也占用 11434 端口。

解决：

# 方案A：给 Hermes Proxy 换端口

hermes proxy --port 11435

# 方案B：给 Ollama 换端口

# 编辑 /etc/systemd/system/ollama.service，加一行：

# Environment="OLLAMA_HOST=0.0.0.0:11435"

sudo systemctl daemon-reload && sudo systemctl restart ollama

踩坑2：模型名不匹配

症状：工具报错 model not found。

原因：不同工具对模型名的要求不同。

解决：先看 proxy 暴露了哪些模型名：

curl -s http://localhost:11434/v1/models | python3 -m json.tool

# 输出:

# {

# "data": [

# {"id": "claude-sonnet-4-20250514"},

# {"id": "claude-opus-4-20250514"}

# ]

# }

然后用返回的精确模型名配置工具。

踩坑3：OAuth Token 过期

症状：请求突然全部返回 401。

原因：OAuth token 有过期时间（通常 1 小时），需要刷新。

解决：

# Hermes 会自动刷新 token，但如果手动中止过进程，重新登录即可

hermes provider refresh anthropic

# 或者删掉重新添加

hermes provider remove anthropic

hermes provider add anthropic

踩坑4：远程服务器无法打开浏览器

症状：hermes provider add 后卡住，没有弹出浏览器。

原因：远程服务器没有 GUI。

解决：

# 方法1：SSH 端口转发（推荐）

# 在本地终端执行：

ssh -L 8080:localhost:8080 user@your-server

# 然后在服务器上，Hermes 会打印一个 URL，在本机浏览器打开即可

# 形如: http://localhost:8080/oauth/callback?code=xxx

# 方法2：用 --no-browser 拿到 URL 手动打开

hermes provider add anthropic --no-browser

# 复制输出的 URL 到本机浏览器打开

踩坑5：订阅额度耗尽

症状：Claude Pro 返回 rate limit exceeded。

原因：Claude Pro 有每日额度限制（约 100-200 条/天），多个工具共用时容易打满。

解决：

# 方案A：加限流（见上文 nginx 配置）

# 方案B：增加 provider 做负载均衡

hermes provider add openai # 加 ChatGPT Pro 分担负载

hermes provider add xai # 加 SuperGrok 进一步分散

# 方案C：合理分配工具

# Codex → ChatGPT Pro（代码生成场景 OpenAI 更合适）

# Aider → Claude Pro（重构分析 Claude 更强）

# Cline → SuperGrok（前端 UI Grok 创意好）

效果评估

成本对比（月）

项目	不用 Proxy	用 Proxy	节省
OpenAI API（Codex 用）	$150	$0（已含在 ChatGPT Pro $200）	$150
Claude API（Aider 用）	$120	$0（已含在 Claude Pro $20）	$120
其他工具 API 调用	$80	$0（走已有订阅）	$80
月总计	$350	$220（订阅费不变）	$130

数据基于作者实际使用情况（日均 ~150 次 AI 编程请求）。如果你只有一个 Claude Pro（$20/月），节省幅度更大——以前你可能额外花了 $200+ 在 API 上，现在全部归零。

延迟对比

调用方式	首次响应	完整回复
直连 Claude API	1.2s	8.5s
通过 hermes proxy	1.4s	8.8s
额外开销	+0.2s	+0.3s

Proxy 本身几乎零开销——它只是做协议转换，不增加实质延迟。

总结

hermes proxy 是 Hermes Agent v0.14 最实用的功能之一，对 AI 创业者来说意义重大：

省钱：一个订阅打通所有工具，不再为每个工具单独买 API Key
省事：不需要管理多个 API Key，一个 OAuth 登录搞定
灵活：多 provider 自动路由，不同场景用不同模型
零延迟：本地 proxy，协议转换几乎无开销

如果你已经在付费使用 Claude Pro / ChatGPT Pro / SuperGrok，花 10 分钟配好 hermes proxy，就能让 Codex、Aider、Cline、Continue 和你的自建工具全部共享同一个订阅——这是 AI 一人公司降本增效的最快路径。

常见问题（FAQ）

Q: Proxy 会被 Anthropic/OpenAI 封号吗？ A: Proxy 只是协议转换，请求仍然通过你登录的 OAuth 账号发出，和使用官方客户端本质上一样。但注意不要超过订阅的合理使用额度。

Q: 能同时连接多个工具吗？ A: 可以。Proxy 是一个标准 HTTP 服务，天然支持多客户端并发连接。多个工具同时请求，Proxy 会排队转发。

Q: 支持流式输出（streaming）吗？ A: 支持。Proxy 实现了完整的 OpenAI API，包括 stream: true 的 SSE 流式响应。

Q: 没有 GUI 的服务器能用吗？ A: 可以。OAuth 登录需要浏览器，但可以用 SSH 端口转发完成一次性登录。之后 Proxy 在后台运行，不需要 GUI。

Q: 和直接买 API Key 比有什么劣势？ A: 订阅制有每日额度限制（Claude Pro 约 100-200 条/天），而 API Key 按量付费没有日限额。如果你的用量超过订阅额度，API Key 更合适。

#AI创业 #Agent工坊 #HermesAgent #一人公司 #AI编程 #降本增效

本文由AI辅助创作，经人工审核编辑发布