AI创业内参
Agent工坊

【Agent工坊】一行命令把 Claude Pro / ChatGPT Pro 变成本地 API：Hermes Proxy 完整上手指南

AI创业内参

你每月花 $20/$200 订阅的 AI 服务，现在可以当 API 用——不需要额外付费，不需要 API Key，不需要复杂配置。Hermes Agent v0.14 推出的 hermes proxy，把你的订阅变成了 OpenAI 兼容的本地接口。

前言

如果你同时是这几个工具的深度用户——Claude Pro（$20/月）或 ChatGPT Pro（$200/月），加上 Codex CLI、Aider、Cline、Continue 这些 AI 编程助手——你可能一直被一个问题困扰：

订阅里的模型再好用，也只能在官方界面里用。想接入编程工具？得另外买 API Key。

尤其是 ChatGPT Pro 用户，$200/月包含了 GPT-5.5 的无限使用权限、Codex 的完整能力，但这些能力只存在于 ChatGPT 网页端和桌面 App 里。你的终端、VS Code、Neovim、JetBrains 全家桶——统统用不了。

Hermes Agent v0.14 的 hermes proxy 彻底解决了这个问题。它的核心思路简单到令人惊讶：

用你的 OAuth 登录态，搭一个本地的 OpenAI 兼容代理，让任何支持 OpenAI API 的工具都能直接调你的订阅模型。

一句话总结：一个订阅，所有工具都能用。

背景：为什么这个功能值得关注

Hermes Proxy核心架构

▲ Hermes Proxy核心架构：OAuth订阅通过本地代理转为OpenAI兼容API，驱动Codex/Aider/Cline/Continue等所有AI编程工具

订阅疲劳是真实存在的

先算一笔账。一个重度 AI 工具用户每月的支出可能长这样：

项目费用
ChatGPT Pro（含 GPT-5.5 + Codex）$200/月
Claude Pro$20/月
Cursor Pro$20/月
Claude API（按量）$50-200/月
OpenAI API（按量）$50-200/月
合计$340-640/月

问题出在哪里？ChatGPT Pro 的 $200 和 Claude Pro 的 $20 已经在为同一批模型付费了，但因为订阅模型和 API 是两套体系，你不得不再买一份 API 额度。

hermes proxy 把这层隔离打破了。你的 OAuth 登录态 = 你的 API Key。不需要 API 付费，不需要管理额度，不需要在多个账单之间纠结。

每月AI工具支出对比

▲ 传统方案 vs Hermes Proxy方案：每月节省$200，成本降低近50%

不只是省钱——是工作流的统一

更重要的是，这改变了你的工具使用方式：

  • Codex CLI 可以直接用 ChatGPT Pro 的 GPT-5.5 做代码生成
  • Aider 可以直接用 Claude Pro 的 Sonnet 4 做结对编程
  • Cline / Roo Code 可以切到 SuperGrok 的 grok-4.3（上下文窗口 100 万 token）做大规模代码库分析
  • 你自己写的脚本、自动化流水线、CI/CD 流程——全部可以接入

而且这一切不需要配置 API Key，不需要记 endpoint，不需要管理多个账号。一个 hermes proxy 启动，所有工具自动发现。

核心实操：三步跑通 Hermes Proxy

前置条件

  • 已安装 Hermes Agent v0.14.0 或更高版本（pip install hermes-agent 或 pip install --upgrade hermes-agent）
  • 已通过 hermes login 完成至少一个 OAuth 提供商的登录（Claude Pro / ChatGPT Pro / SuperGrok）
  • 操作系统：Linux / macOS / Windows（v0.14 开始支持 Windows Beta）

步骤 1：启动代理

hermes proxy

就这么简单。启动后你会看到类似这样的输出：

✓ Proxy listening on http://localhost:11434

  Active providers: claude-pro, chatgpt-pro

  Model mapping: claude-sonnet-4 → claude-pro, gpt-5.5 → chatgpt-pro

三步配置完成

▲ 三步完成Hermes Proxy配置：启动代理 → 配置base_url → 所有工具立即可用

默认端口是 11434（与 Ollama 默认端口相同，如果你同时运行 Ollama，可以通过 --port 参数更换）。

步骤 2：配置你的工具

任何支持 OpenAI 兼容 API 的工具，只需要把 base_url 指向 Hermes Proxy 即可。

Codex CLI 配置：

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

export OPENAI_API_KEY="hermes-proxy" # 任意非空值即可，Hermes 不检查

codex

Aider 配置：

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

      --openai-api-key hermes-proxy \

      --model openai/gpt-5.5

Cline / Roo Code (VS Code 插件) 配置：

在插件设置中：

  • API Provider：选择 OpenAI Compatible
  • Base URL：`
  • API Key：填入任意非空字符串（如 hermes-proxy）
  • Model：选择你想用的模型（如 gpt-5.5、claude-sonnet-4）

Continue (VS Code / JetBrains) 配置：

在 ~/.continue/config.json 中：

{

  "models": [{

    "title": "ChatGPT Pro via Hermes",

    "provider": "openai",

    "model": "gpt-5.5",

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

    "apiKey": "hermes-proxy"

  }, {

    "title": "Claude Pro via Hermes",

    "provider": "openai",

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

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

    "apiKey": "hermes-proxy"

  }]

}

步骤 3：验证连通性

用 curl 快速验证代理是否正常工作：

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

应该返回可用模型列表，包含你已登录的 OAuth 提供商所对应的模型。

发送一个测试请求：

curl -s http://localhost:11434/v1/chat/completions \

  -H "Content-Type: application/json" \

  -H "Authorization: Bearer hermes-proxy" \

  -d '{

    "model": "gpt-5.5",

    "messages": [{"role": "user", "content": "用一句话解释什么是hermes proxy"}]

  }' | python3 -m json.tool

成功返回就说明你的订阅模型已经作为 API 可用了。

进阶配置：多提供商、端口管理、SSH 隧道

切换模型

Hermes Proxy 会自动检测你已登录的 OAuth 提供商，并暴露对应的模型。模型名称映射如下：

OAuth 提供商模型名称说明
Claude Proclaude-sonnet-4Claude Sonnet 4
Claude Proclaude-opus-4Claude Opus 4（如有权限）
ChatGPT Progpt-5.5GPT-5.5
ChatGPT Progpt-5GPT-5
ChatGPT ProcodexCodex 编程模型
SuperGrokgrok-4.3Grok 4.3（100万 token 上下文）

在工具中选择对应的模型名称即可自动路由到正确的提供商。

更换端口

hermes proxy --port 8080

如果你本地已经运行了 Ollama（默认也是 11434），可以换一个不冲突的端口。

远程访问（SSH 隧道）

如果你在远程服务器上运行 Hermes Proxy，可以通过 SSH 隧道在本地访问：

# 在本地机器执行

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

# 然后本地工具配置 base_url 为 http://localhost:11434/v1

指定提供商

# 只暴露 Claude Pro（隐藏其他提供商）

hermes proxy --provider claude-pro

# 同时暴露多个

hermes proxy --provider claude-pro --provider chatgpt-pro

后台运行

# 使用 nohup 或 screen/tmux

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

# 或使用 systemd（生产环境推荐）

# 创建 /etc/systemd/system/hermes-proxy.service

真实场景演示：用 ChatGPT Pro 驱动 Codex CLI 完成一个完整项目

假设你有一个数据分析任务：读取 CSV 文件，清洗数据，生成可视化图表。ChatGPT Pro 订阅里有 GPT-5.5 和 Codex，Codex CLI 需要 OpenAI 兼容 API。

不用 Hermes Proxy 的情况：

  1. 需要单独购买 OpenAI API 额度
  2. 需要申请 Codex API 访问权限（可能再等几周）
  3. 每次调用都要算 token 费用，担心账单爆

使用 Hermes Proxy 的情况：

  1. 启动 hermes proxy
  2. 配置 `OPENAI_API_BASE=
  3. 运行 codex "分析 sales.csv，清洗缺失值，绘制月度趋势图"

Codex CLI 自动通过代理调用 ChatGPT Pro 的 Codex 模型，完成：

  • CSV 文件解析
  • 缺失值检测与填充策略
  • Matplotlib 图表生成
  • 结果说明文档

整个过程零额外费用——你已经在为 ChatGPT Pro 付费了。

项目配置持久化

手动 export 环境变量容易忘。推荐在项目根目录放 .env 文件：

# .env（不提交到 Git）

OPENAI_API_BASE=http://localhost:11434/v1

OPENAI_API_KEY=hermes-proxy

或者在项目的 .claude/ 或 .aider.conf.yml 中固化配置。

踩坑与排障

踩坑 1：Ollama 端口冲突

现象：启动 hermes proxy 时报错端口被占用。

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

解决：

# 方案 A：给 Hermes Proxy 换个端口

hermes proxy --port 11435

# 方案 B：先停 Ollama，用完 Hermes Proxy 再启动 Ollama

systemctl stop ollama

hermes proxy

# ... 使用完毕后

systemctl start ollama

踩坑 2：OAuth 登录态过期

现象：代理返回 401 或 "not authenticated" 错误。

原因：OAuth token 过期或你还没有用 hermes login 完成对应提供商的登录。

解决：

# 检查当前登录状态

hermes auth status

# 重新登录需要的提供商

hermes login --provider chatgpt-pro

# 或

hermes login --provider claude-pro

# 或

hermes login --provider supergrok

踩坑 3：Codex CLI 报 "model not found"

现象：Codex CLI 配置了 Hermes Proxy，但报模型不可用。

原因：Codex CLI 默认使用自己的模型名称，可能与 Hermes Proxy 暴露的名称不一致。

解决：在 Codex CLI 中显式指定模型名称：

codex --model gpt-5.5 "你的任务描述"

或者检查 Hermes Proxy 暴露的模型列表：

curl -s http://localhost:11434/v1/models | python3 -c "

import sys, json

for m in json.load(sys.stdin).get('data', []):

    print(f\" - {m['id']}\")

"

踩坑 4：SSH 远程服务器上的 OAuth 认证流程

现象：在无头（headless）远程服务器上运行 hermes login --provider chatgpt-pro，无法完成浏览器跳转的 OAuth 流程。

原因：OAuth 需要浏览器完成登录跳转，远程服务器通常没有桌面环境。

解决：Hermes v0.14 针对这个场景提供了 SSH 隧道文档。基本思路是：

  1. 在服务器上启动 hermes proxy 但不提供登录态
  2. 在本地机器上通过 SSH 端口转发访问服务器上暴露的 OAuth 回调端点
  3. 完成认证后，token 保存在服务器本地

详细文档参见 Hermes 官方的 SSH-to-tunnel 指南（链接在 v0.14 release notes 中标注）。

踩坑 5：Roo Code / Cline 连接失败

现象：在 VS Code 插件中配置了 Hermes Proxy，但无法连接。

原因：部分 VS Code 插件对 OpenAI 兼容 API 的实现不完全标准，可能需要额外的 header 或路径处理。

解决：

  • 确保 Base URL 结尾带 /v1
  • API Key 不要留空（填 hermes-proxy 或任意非空字符串）
  • 在插件日志中查看具体错误，通常是路径拼接问题
  • 如果问题持续，尝试通过 Aider 或其他 CLI 工具先验证代理是否正常

常见问题（FAQ）

Q: 这样用算滥用吗？会不会被封号？

A: Hermes Proxy 使用的是你已经在付费的 OAuth 订阅。它只是在你的本地机器上把 OAuth 认证转化为 API 协议，不涉及任何跨账号或违规操作。从技术上讲，它和你在浏览器里手动发请求没有本质区别。当然，如果你用脚本疯狂并发，任何一个提供商的服务条款都会有限制。合理使用，不要滥用。

Q: 速度怎么样？会比直接用 API 慢吗？

A: Hermes Proxy 是一个本地进程，代理本身几乎不增加延迟（< 5ms）。实际的响应速度完全取决于后端提供商的模型推理速度。ChatGPT Pro 和 Claude Pro 的响应速度与各自的官方 API 基本一致。

Q: 支持流式输出（streaming）吗？

A: 支持。Hermes Proxy 完整实现了 OpenAI 的 /v1/chat/completions 接口（含 stream: true），所以 Aider、Cline 等依赖流式输出的工具都能正常工作。

Q: 同时能用几个工具？

A: 没有硬性限制。Hermes Proxy 会同时处理多个并发请求。但要注意后端提供商本身有并发限制——如果同时开 10 个 Codex CLI 实例疯狂请求，可能会触发限流。

Q: Windows 上好用吗？

A: v0.14 是 Hermes 第一个正式支持 Windows Beta 的版本。hermes proxy 在 Windows 上同样可用，建议在 PowerShell 或 Windows Terminal 中运行。

Q: 和 OpenAI API 的差异有哪些？

A: Hermes Proxy 实现了 OpenAI Chat Completions API 的核心功能（/v1/models、/v1/chat/completions）。以下功能暂不支持：

  • Function calling / tool use（部分提供商本身不支持）
  • Vision / 多模态输入（取决于后端提供商的 OAuth 桌面端权限）
  • Embeddings、Fine-tuning、Assistants、Batch 等非 Chat 端点

对于 AI 编程助手的日常使用场景（Cline、Aider、Codex、Continue），核心的 Chat Completions 已经足够。

实战技巧：最大化 Hermes Proxy 的价值

技巧 1：不同任务用不同模型

这是 Hermes Proxy 最大的隐藏价值——你可以根据任务类型自动切换模型，而不用切换工具或重新配置。

# 代码生成/重构：用 ChatGPT Pro 的 GPT-5.5（代码能力最强）

aider --model openai/gpt-5.5

# 大规模代码库分析：用 SuperGrok 的 grok-4.3（100万 token 上下文）

aider --model openai/grok-4.3

# 代码审查/文档：用 Claude Pro 的 Sonnet 4（解释能力出色）

aider --model openai/claude-sonnet-4

在同一个项目里，你可以：

  • 用 gpt-5.5 写新功能和重构
  • 用 grok-4.3 分析整个代码库的架构和依赖关系
  • 用 claude-sonnet-4 生成文档和代码注释

所有这一切，只需要改 --model 参数。不需要切换工具、不需要不同的 API Key、不需要重新登录。

技巧 2：批量脚本自动化

如果你经常需要批量处理文件——比如把 50 个 Python 文件从同步改为异步——传统做法是手动改或用模板替换。现在可以写个简单脚本：

#!/bin/bash

# batch-refactor.sh

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

export OPENAI_API_KEY="hermes-proxy"

for file in src/**/*.py; do

    echo "Processing: $file"

    codex --model gpt-5.5 \

      "将 $file 中的同步数据库查询改为 async/await 模式，保持业务逻辑不变" \

      --file "$file"

done

配合 hermes proxy 后台运行，这个脚本可以无人值守跑完整个项目。同样的思路可以用于：

  • 批量添加类型注解
  • 自动生成单元测试
  • 代码风格统一化
  • 多语言翻译（i18n 文件生成）

技巧 3：CI/CD 集成

在 GitHub Actions 或 GitLab CI 中集成 Hermes Proxy：

# .github/workflows/code-review.yml

name: AI Code Review

on: [pull_request]

jobs:

  review:

    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@v4

      - name: AI Review

        run: |

          # 在 CI 机器上启动 hermes proxy

          hermes proxy --port 11434 &

          sleep 3

          # 获取 PR 的 diff

          git diff origin/main > /tmp/pr.diff

          # 让 Codex 做代码审查

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

          export OPENAI_API_KEY="hermes-proxy"

          codex --model gpt-5.5 \

            "Review this PR diff for bugs, security issues, and code style problems: $(cat /tmp/pr.diff)"

⚠️ CI 环境中的 OAuth 认证需要在 CI secrets 中保存 token，或使用 Hermes 的 CI 专用认证模式。具体配置参见 Hermes 官方文档的 CI/CD 集成章节。

技巧 4：token 消耗可视化

想知道你的订阅模型通过代理被调用了多少次？可以启用代理日志：

# 启动时开启详细日志

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

# 实时查看请求统计

tail -f /tmp/hermes-proxy.log | grep -E "request|completion|tokens"

对于团队使用场景，这个日志可以帮助你了解各工具的模型使用情况，识别出哪些场景真正需要 Pro 订阅、哪些场景用基础模型就够了。

风险提示

在使用 Hermes Proxy 前，有几点必须了解：

  1. 不是官方 API：Hermes Proxy 使用的是 OAuth 订阅的 Web/桌面端接口，不是提供商正式开放的 API。提供商可能在未来的更新中改变接口行为或对高频调用施加限制。
  2. 并发限制：OAuth 接口的并发限制通常比 API 更严格。ChatGPT Pro 和 Claude Pro 的网页端/桌面端本身就不是为高并发设计的。如果你用 Hermes Proxy 驱动 5 个同时运行的 AI 编程 Agent，可能会触发临时限流。
  3. 功能覆盖不完整：如前所述，Function calling、多模态、Embeddings 等功能暂不支持。如果你的工作流强依赖这些功能，Hermes Proxy 目前无法完全替代官方 API。
  4. SSH 远程认证复杂：在无头服务器上完成 OAuth 认证流程需要额外的 SSH 隧道配置，比本地环境多几步操作。
  5. 不适合生产级应用：Hermes Proxy 更适合开发、测试和个人项目。如果你的产品依赖 AI API，建议仍然使用官方 API（有 SLA 保障和明确的使用条款）。

同类方案对比

在 Hermes Proxy 出现之前，社区已经有类似的"OAuth 转 API"方案。这里做一个简要对比：

方案支持平台配置复杂度稳定性社区活跃度
Hermes ProxyClaude/ChatGPT/Grok⭐ 一行命令🟢 官方维护🔥 高（17K+ Stars）
Claude-to-ChatGPT 桥接工具Claude → OpenAI⭐⭐ 需手动配置🟡 社区维护一般
第三方反向代理各平台⭐⭐⭐ 需自建🔴 易被封分散

Hermes Proxy 的最大优势在于它是 Hermes Agent 的官方功能，而不是第三方 hack。Nous Research 团队在设计和维护上都投入了相当精力，长期可靠性更有保障。

总结

Hermes Proxy 是 Hermes Agent v0.14 中最有实用价值的功能之一。它的核心价值不在于技术复杂度（本质上就是一个协议转换代理），而在于它打通了订阅模型和工具生态之间的壁垒。

对于 AI 创业者来说，这意味着：

  • 降低成本：ChatGPT Pro $200/月的订阅现在可以驱动整个工具链，不再需要额外买 API 额度
  • 统一工具栈：Codex CLI、Aider、Cline、Continue、自定义脚本——全部使用同一套模型
  • 简化配置：不再管理多个 API Key、多个计费账户、多个配额

hermes proxy 的启动只需要一行命令。试试看。

相关链接：

  • Hermes Agent v0.14.0 Release Notes（GitHub: NousResearch/hermes-agent/releases/tag/v2026.5.16）
  • Hermes Proxy 官方文档（hermes-agent.nousresearch.com/docs）
  • ChatGPT Pro 订阅详情（openai.com/chatgpt/pricing）
  • Claude Pro 订阅详情（claude.ai/pricing）

本文由AI辅助创作，经人工审核编辑发布。各工具和服务的功能、价格可能随时变化，请以官方最新信息为准。

#AI创业 #Agent工坊 #HermesAgent #AI工具 #一人公司

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