Claude Pro / Max 不支持第三方工具用 OAuth 登录（只 API Key），但 OpenAI 反而是 ChatGPT 订阅可以通过 Codex CLI 的 OAuth 拿到对 GPT-5.x 的访问权。这篇记录我用 opencode + Hermes-agent 把这条路串起来的过程。

工具栈是啥

  • opencode：开源 AI Agent CLI，类似 Claude Code，模型层抽象做得不错
  • oh-my-opencode：opencode 的配置增强（主题、插件、provider 模板）
  • Hermes-agent：独立的 Python agent，封装了 Codex 的 OAuth 流程

三者关系：opencode 负责"做事"（编辑文件、跑命令），Hermes-agent 负责"出脑子"（通过 ChatGPT 订阅调 GPT-5.x）。

为什么这么折腾

  • Claude API Key 按 token 算，重度用每月几百刀
  • ChatGPT Pro/Plus 订阅 20 刀，包含 Codex CLI 用 GPT-5 的额度
  • Anthropic 不允许 Pro/Max OAuth 给第三方工具用，所以同样的"白嫖订阅"路径在 Claude 这边走不通

如果你已经有 ChatGPT 订阅，这套方案能省不少钱。

安装步骤

# 1. opencode
curl -fsSL https://opencode.ai/install | bash

# 2. oh-my-opencode（配置增强，可选但强烈推荐）
git clone https://github.com/oh-my-opencode/oh-my-opencode ~/.opencode/oh-my-opencode

# 3. Hermes-agent
git clone <hermes repo> ~/.hermes
cd ~/.hermes && pip install -e .

注意：opencode 和 oh-my-opencode 都安装到 ~/.opencode/，~/.config/opencode/ 是早期版本的目录，新版别用了。

配置 OAuth

Hermes-agent 启动一次会弹浏览器走 Codex OAuth：

hermes login
# 浏览器跳到 chatgpt.com 授权 → 回调拿 token → 存到 ~/.hermes/credentials.json

token 默认有效期一周，到期再 hermes login 续就行。

opencode 接 Hermes provider

在 ~/.opencode/opencode.json 配 provider：

{
  "provider": {
    "hermes-codex": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hermes (GPT-5 via Codex OAuth)",
      "options": {
        "baseURL": "http://127.0.0.1:8765/v1",
        "apiKey": "dummy"
      },
      "models": {
        "gpt-5.4": { "name": "GPT-5.4" }
      }
    }
  }
}

Hermes-agent 启服务：

hermes serve --port 8765

之后 opencode 里选 model 就能看到 hermes-codex/gpt-5.4。

几个坑

  1. OAuth token 短命：一周内必续，写个 cron 提醒自己
  2. ChatGPT 订阅有 rate limit：用得猛会触发，别拿来跑批
  3. Codex 的 GPT-5 不是公开 API 的 GPT-5：context window 和 capability 有差异，吃 tool use 不如直连 API 稳
  4. Hermes-agent 不是 opencode 一部分：升级 opencode 不会动 Hermes，反之亦然，别混在一起调试

适用场景

  • 个人项目、学习、做小工具：强推
  • 公司生产、对 SLA 有要求：别，OAuth 随时可能被官方堵死
  • 想要 Claude 的能力：这套方案接不到 Anthropic，老老实实买 API Key

教训一句话：opencode 是工具，Hermes 是省钱通道，两者解耦让你能随时切回正经 API Key，别把它们当一个东西。

标签: none

添加新评论