[{"data":1,"prerenderedAt":713},["ShallowReactive",2],{"blog-post-hermes-agent-claude-chatgpt-subscription":3,"related-posts-hermes-agent-claude-chatgpt-subscription":691},{"id":4,"title":5,"author":6,"body":11,"category":669,"date":670,"description":671,"extension":672,"featured":673,"hideToc":673,"image":674,"imageAlt":675,"imageHeight":675,"imageWidth":675,"itemList":675,"lang":675,"meta":676,"navigation":677,"noindex":673,"path":678,"readingTime":679,"redirected":673,"relatedSlugs":675,"seo":680,"seoTitle":681,"stem":682,"subtitle":675,"tags":683,"updatedDate":670,"__hash__":690},"blog/blog/hermes-agent-claude-chatgpt-subscription.md","Hermes Agent With Your Claude or ChatGPT Subscription: Setup and Limits",{"name":7,"role":8,"avatar":9,"bio":10},"Shabnam Katoch","Growth Head","/img/avatars/shabnam-profile.jpeg","Shabnam leads growth at BetterClaw and has spent the past three years building organic distribution for AI-native products. She writes about no-code agent builders, content strategy, and what it actually takes to grow without an ads budget.",{"type":12,"value":13,"toc":656},"minimark",[14,18,25,28,33,36,39,60,63,67,74,77,126,129,133,139,146,215,218,235,242,280,285,295,303,313,319,326,330,336,339,368,371,375,378,381,440,450,454,467,470,488,491,494,498,504,507,510,572,575,578,582,588,595,598,601,609,613,619,628,640,646,652],[15,16,17],"p",{},"How to run Hermes on the subscription you already pay for, why limits run out faster than in the app, and when an API key is the better choice.",[19,20,22],"callout",{"type":21},"quick-fix",[15,23,24],{},"Yes, you can. For Claude, the official experimental plugin \"Claude Subscription DirectSDK\" runs Hermes turns through Anthropic's own Claude Code CLI on your Pro or Max plan. For ChatGPT, Hermes has a built-in \"ChatGPT or Codex Subscription\" sign-in. The catch is the same for both: every agent turn counts against your plan's limits, and an agent sends far more per turn than you do in the app.",[15,26,27],{},"Checked against Hermes v0.22.5 on 27 October 2026.",[29,30,32],"h2",{"id":31},"the-terms-question-first","The terms question first",[15,34,35],{},"Using a consumer subscription inside a third-party agent has been a moving target in 2026, so check the rules before you rely on it.",[15,37,38],{},"Here's where Anthropic's help centre stood when we checked on 27 October:",[40,41,42,51,54],"ul",{},[43,44,45,46,50],"li",{},"The Agent SDK, ",[47,48,49],"code",{},"claude -p"," and third-party apps built on it run against your plan's usage limits.",[43,52,53],{},"Changes Anthropic announced for that usage in May were paused on 15 June, and the page says \"nothing has changed for now.\"",[43,55,56,57,59],{},"Since 7 October, Max and Team plans also include monthly API credits that cover the Agent SDK, ",[47,58,49],{}," and the Claude API.",[15,61,62],{},"The DirectSDK plugin goes through the official Claude Code CLI rather than copying your login, which is the route those rules describe. Policies can change at short notice, so read Anthropic's current terms for your plan.",[29,64,66],{"id":65},"two-ways-to-use-a-claude-plan-and-they-bill-differently","Two ways to use a Claude plan, and they bill differently",[15,68,69],{},[70,71],"img",{"alt":72,"src":73},"Two Claude subscription routes in Hermes: DirectSDK plugin for Pro and Max, built-in Anthropic sign-in for Max with extra credits only — they bill differently","/img/blog/hermes-agent-claude-chatgpt-subscription-routes.jpg",[15,75,76],{},"Hermes has two Claude subscription routes. Picking the wrong one is the most common billing surprise.",[78,79,80,96],"table",{},[81,82,83],"thead",{},[84,85,86,90,93],"tr",{},[87,88,89],"th",{},"Route",[87,91,92],{},"Plans that work",[87,94,95],{},"What it uses up",[97,98,99,111],"tbody",{},[84,100,101,105,108],{},[102,103,104],"td",{},"DirectSDK plugin (experimental)",[102,106,107],{},"Pro and Max",[102,109,110],{},"Your plan's usage limits, through the Claude Code CLI",[84,112,113,120,123],{},[102,114,115,116,119],{},"Built-in Anthropic sign-in (",[47,117,118],{},"hermes model"," then Anthropic OAuth)",[102,121,122],{},"Max only, with extra usage credits bought",[102,124,125],{},"Only the extra usage credits. Hermes docs say your base Max allowance is never used",[15,127,128],{},"So on Pro, the built-in sign-in simply doesn't work. Hermes's docs are blunt about it: \"Pro looks like it should work; it doesn't.\" Use the plugin, or an API key.",[29,130,132],{"id":131},"set-up-hermes-with-your-claude-subscription","Set up Hermes with your Claude subscription",[15,134,135],{},[70,136],{"alt":137,"src":138},"Four steps to set up Hermes with your Claude subscription: install Claude Code CLI, install the plugin, log in, pick the provider","/img/blog/hermes-agent-claude-chatgpt-subscription-setup-steps.jpg",[15,140,141,142,145],{},"You need Hermes 0.21.4 or newer and the official Claude Code CLI, logged in. The plugin has no credentials of its own; everything goes through ",[47,143,144],{},"claude",".",[147,148,153],"pre",{"className":149,"code":150,"language":151,"meta":152,"style":152},"language-bash shiki shiki-themes github-light","npm install -g @anthropic-ai/claude-code\nhermes plugins install claude-subscription-directsdk\nclaude auth login\nhermes model\n# pick \"Claude Subscription DirectSDK (Experimental)\"\n","bash","",[47,154,155,175,189,200,208],{"__ignoreMap":152},[156,157,160,164,168,172],"span",{"class":158,"line":159},"line",1,[156,161,163],{"class":162},"s7eDp","npm",[156,165,167],{"class":166},"sYBdl"," install",[156,169,171],{"class":170},"sYu0t"," -g",[156,173,174],{"class":166}," @anthropic-ai/claude-code\n",[156,176,178,181,184,186],{"class":158,"line":177},2,[156,179,180],{"class":162},"hermes",[156,182,183],{"class":166}," plugins",[156,185,167],{"class":166},[156,187,188],{"class":166}," claude-subscription-directsdk\n",[156,190,192,194,197],{"class":158,"line":191},3,[156,193,144],{"class":162},[156,195,196],{"class":166}," auth",[156,198,199],{"class":166}," login\n",[156,201,203,205],{"class":158,"line":202},4,[156,204,180],{"class":162},[156,206,207],{"class":166}," model\n",[156,209,211],{"class":158,"line":210},5,[156,212,214],{"class":213},"sAwPA","# pick \"Claude Subscription DirectSDK (Experimental)\"\n",[15,216,217],{},"When we installed it on Hermes v0.22.5, the install finished with \"Plugin installed but not enabled\", even though the plugin's README says model providers don't need enabling. One command fixed it:",[147,219,221],{"className":149,"code":220,"language":151,"meta":152,"style":152},"hermes plugins enable claude-subscription-directsdk-experimental\n",[47,222,223],{"__ignoreMap":152},[156,224,225,227,229,232],{"class":158,"line":159},[156,226,180],{"class":162},[156,228,183],{"class":166},[156,230,231],{"class":166}," enable",[156,233,234],{"class":166}," claude-subscription-directsdk-experimental\n",[15,236,237,238,241],{},"To make it your default model, set this in ",[47,239,240],{},"~/.hermes/config.yaml",":",[147,243,247],{"className":244,"code":245,"language":246,"meta":152,"style":152},"language-yaml shiki shiki-themes github-light","model:\n  provider: claude-subscription-directsdk-experimental\n  default: sonnet\n","yaml",[47,248,249,259,270],{"__ignoreMap":152},[156,250,251,255],{"class":158,"line":159},[156,252,254],{"class":253},"shJU0","model",[156,256,258],{"class":257},"sgsFI",":\n",[156,260,261,264,267],{"class":158,"line":177},[156,262,263],{"class":253},"  provider",[156,265,266],{"class":257},": ",[156,268,269],{"class":166},"claude-subscription-directsdk-experimental\n",[156,271,272,275,277],{"class":158,"line":191},[156,273,274],{"class":253},"  default",[156,276,266],{"class":257},[156,278,279],{"class":166},"sonnet\n",[281,282,284],"h3",{"id":283},"two-errors-we-hit-during-setup","Two errors we hit during setup",[15,286,287,291,292,294],{},[288,289,290],"strong",{},"Claude Code not found."," With no ",[47,293,144],{}," binary available, Hermes stopped before sending anything:",[147,296,301],{"className":297,"code":299,"language":300},[298],"language-text","Claude Code is not installed (no `claude` on PATH or in the usual install directories).\nInstall it with `npm install -g @anthropic-ai/claude-code` or set\nCLAUDE_SUBSCRIPTION_DIRECTSDK_COMMAND to the binary.\n","text",[47,302,299],{"__ignoreMap":152},[15,304,305,308,309,312],{},[288,306,307],{},"An API key in your environment."," With ",[47,310,311],{},"ANTHROPIC_API_KEY"," exported, the plugin refused the request on purpose, so it can never quietly bill your key instead of your plan:",[147,314,317],{"className":315,"code":316,"language":300},[298],"❌ Claude Subscription DirectSDK (Experimental) rejected the request and\nretrying won't help:\nOAuth provider refuses conflicting native auth/backend overrides:\nANTHROPIC_API_KEY\n",[47,318,316],{"__ignoreMap":152},[15,320,321,322,325],{},"Here's the part that cost us ten minutes. We unset the key and got the same error again, because the Hermes gateway had already started with the key in its environment. Run ",[47,323,324],{},"hermes gateway stop"," (or restart) after changing environment variables, then try again.",[29,327,329],{"id":328},"why-you-hit-limits-so-fast","Why you hit limits so fast",[15,331,332],{},[70,333],{"alt":334,"src":335},"A 429 in Hermes with a Claude subscription is a plan limit, not a bug: agent turns resend large contexts and make several model calls per task","/img/blog/hermes-agent-claude-chatgpt-subscription-429-limit.jpg",[15,337,338],{},"In the Claude app, one message sends your message plus a short history. An agent turn is a different animal.",[40,340,341,347,353,359],{},[43,342,343,346],{},[288,344,345],{},"Every turn resends the whole working context."," In the plugin's own published test, a seven-call code review ran with 138,498 to 165,697 tokens of context per call. At list prices, those seven calls came to $0.88.",[43,348,349,352],{},[288,350,351],{},"One request becomes many."," Hermes may make several model calls per task: tool rounds, summaries and title generation. By default, those side tasks use your main model too, which here means your plan.",[43,354,355,358],{},[288,356,357],{},"Some models cost extra on some plans."," In the plugin's tests, Fable 5.1 answered \"requires usage credits\" on a Pro plan; Anthropic's plan rules put Fable on pay-as-you-go credits for Pro.",[43,360,361,364,365,145],{},[288,362,363],{},"Old CLI versions reject new models."," The plugin needs Claude Code 2.1.280 or newer for Opus 5.5, 2.1.284 for Sonnet 5.5 and 2.1.293 for Haiku 5.5. An older CLI answers with a 400 \"does not support this model\". Run ",[47,366,367],{},"claude update",[15,369,370],{},"That's why a plan that lasts a week of chatting can run dry in an afternoon of agent work.",[29,372,374],{"id":373},"fix-the-429-and-usage-limit-errors","Fix the 429 and \"usage limit\" errors",[15,376,377],{},"A 429 here means you hit a plan or session limit. It's not a bug, and retrying won't clear it until the window resets. The plugin passes Claude Code's rate_limit errors through as 429 exactly so Hermes can tell them apart from real failures.",[15,379,380],{},"What to do:",[40,382,383,393,411,424,430],{},[43,384,385,392],{},[288,386,387,388,391],{},"Type ",[47,389,390],{},"/usage"," in a Hermes chat."," With the plugin, it asks Claude Code for your plan limits, so you can see how much is left and when it resets.",[43,394,395,398,399,402,403,406,407,410],{},[288,396,397],{},"Add a fallback",", so Hermes switches instead of stopping: ",[47,400,401],{},"hermes fallback add",", or a ",[47,404,405],{},"fallback_providers"," list in ",[47,408,409],{},"config.yaml"," pointing at an API-key provider.",[43,412,413,416,417,419,420,423],{},[288,414,415],{},"Point side tasks at a cheaper model."," In ",[47,418,409],{},", the ",[47,421,422],{},"auxiliary"," settings let you move summaries and vision off your plan.",[43,425,426,429],{},[288,427,428],{},"Decide about extra usage."," If your Claude account has extra usage turned on, heavy runs can keep going past your limit and bill overage. Turn it off in your Claude account if you'd rather stop.",[43,431,432,435,436,439],{},[288,433,434],{},"After you've fixed the cause",", ",[47,437,438],{},"hermes auth reset \u003Cprovider>"," clears Hermes's own \"exhausted\" mark so it tries that credential again.",[15,441,442,443],{},"Already pay for ChatGPT Plus or Pro? Sign in with it on any BetterClaw agent, or use your own key at zero markup. ",[444,445,449],"a",{"href":446,"rel":447},"https://betterclaw.io",[448],"nofollow","Start your first agent.",[29,451,453],{"id":452},"using-chatgpt-plus-or-pro-with-hermes","Using ChatGPT Plus or Pro with Hermes",[15,455,456,457,459,460,463,464,145],{},"This one is built in, with no plugin. Run ",[47,458,118],{}," and pick ",[288,461,462],{},"ChatGPT or Codex Subscription",". Hermes shows a link and a code; you approve it in the browser, and it saves the login in ",[47,465,466],{},"~/.hermes/auth.json",[15,468,469],{},"A few details from Hermes's docs:",[40,471,472,479,485],{},[43,473,474,475,478],{},"If your organisation blocks device-code logins, use ",[47,476,477],{},"hermes auth add openai-codex --browser"," instead. It listens on port 1455, so over SSH you need a tunnel to that port.",[43,480,481,482,145],{},"If you already use OpenAI's Codex CLI, Hermes can import its login from ",[47,483,484],{},"~/.codex/auth.json",[43,486,487],{},"You get OpenAI's Codex models, with a context window of 272K tokens for most of them.",[15,489,490],{},"On limits, OpenAI's help centre says Codex usage counts toward an \"agentic usage limit\" shared with other ChatGPT agent features, and that bigger, longer tasks use more of it. Hermes's own docs say plainly that how its usage counts against your plan \"is not currently documented\", so watch your usage page for the first few days.",[15,492,493],{},"Hermes also knows the ChatGPT-specific errors. When a model isn't available on a ChatGPT account (\"model is not supported when using Codex with a ChatGPT account\"), it skips that model and moves on to your fallback rather than failing the whole run.",[29,495,497],{"id":496},"subscription-vs-api-key-which-costs-less","Subscription vs API key: which costs less?",[15,499,500],{},[70,501],{"alt":502,"src":503},"Same Claude plan, very different pace: light daily use stays well under the limit, heavy agent loops hit it in hours","/img/blog/hermes-agent-claude-chatgpt-subscription-usage-pace.jpg",[15,505,506],{},"Here's the honest maths, using Anthropic's API prices on 27 October: Sonnet 5.5 at $2 per million input tokens, $0.10 for cached input and $10 for output.",[15,508,509],{},"We assumed a modest agent turn of 20,000 input tokens and 1,000 output tokens, with and without 90% of the input cached.",[78,511,512,528],{},[81,513,514],{},[84,515,516,519,522,525],{},[87,517,518],{},"How you use the agent",[87,520,521],{},"Turns a month",[87,523,524],{},"API cost, no caching",[87,526,527],{},"API cost, 90% cached",[97,529,530,544,558],{},[84,531,532,535,538,541],{},[102,533,534],{},"Light: 10 turns a day",[102,536,537],{},"300",[102,539,540],{},"$15",[102,542,543],{},"about $5",[84,545,546,549,552,555],{},[102,547,548],{},"Daily agent: 50 turns a day",[102,550,551],{},"1,500",[102,553,554],{},"$75",[102,556,557],{},"about $24",[84,559,560,563,566,569],{},[102,561,562],{},"Heavy loops: 300 turns a day",[102,564,565],{},"9,000",[102,567,568],{},"$450",[102,570,571],{},"about $142",[15,573,574],{},"Compare that with Claude Pro at $20 a month ($17 billed annually) and Max from $100. For light and daily use, a subscription is often the better deal, until you hit its limits. For heavy loops, the plan's limits stop you long before the dollar maths matters, so an API key with caching, or a cheaper model for routine turns, is the reliable choice.",[15,576,577],{},"Real agent turns are often far bigger than 20,000 tokens (remember the 138,000-token review), so treat these as a floor, not a quote.",[29,579,581],{"id":580},"use-your-chatgpt-subscription-in-betterclaw","Use your ChatGPT subscription in BetterClaw",[15,583,584],{},[70,585],{"alt":586,"src":587},"What agent use actually costs on the API at Sonnet 5.5 prices: light use ~$5/month cached, heavy loops ~$142/month cached","/img/blog/hermes-agent-claude-chatgpt-subscription-api-cost.jpg",[15,589,590,591,594],{},"If you'd rather not manage CLIs, gateways and environment variables, BetterClaw lets you sign in with ChatGPT Plus or Pro on any agent's ",[288,592,593],{},"Model tab",". The models you get match what your ChatGPT plan includes.",[15,596,597],{},"You can switch that agent back to your own API key from any of 28+ providers at any time, with zero markup, and give each agent a different model.",[15,599,600],{},"If Hermes keeps rejecting your login instead, our Hermes auth error fix covers the sign-in failures.",[15,602,603],{},[288,604,605,606],{},"Your subscription or your key, your choice. BetterClaw: always-on agents, 28+ model providers. ",[444,607,449],{"href":446,"rel":608},[448],[29,610,612],{"id":611},"frequently-asked-questions","Frequently Asked Questions",[15,614,615,618],{},[288,616,617],{},"Can I use my Claude subscription with Hermes Agent?"," Yes. The official experimental \"Claude Subscription DirectSDK\" plugin runs Hermes turns on a Pro or Max plan through the Claude Code CLI. Hermes's built-in Anthropic sign-in only works on Max with extra usage credits, and only uses those credits.",[15,620,621,624,625,627],{},[288,622,623],{},"Why does Hermes give a 429 with my Claude subscription?"," A 429 means you hit your plan's or session's usage limit. Agent turns resend large contexts and make several model calls per task, so limits run out much faster than in the Claude app. Check ",[47,626,390],{},", wait for the reset, or add a fallback API-key provider.",[15,629,630,633,634,636,637,639],{},[288,631,632],{},"Can I use ChatGPT Plus with Hermes?"," Yes. Run ",[47,635,118],{}," and choose ",[288,638,462],{},", then approve the device-code login. Hermes uses OpenAI's Codex models, and usage counts toward your plan's agentic usage limit.",[15,641,642,645],{},[288,643,644],{},"Is a subscription cheaper than an API key for agents?"," For light and daily use, usually yes, as long as you stay within the plan's limits. For heavy agent loops, plan limits run out first, and an API key with prompt caching is more predictable. At Sonnet 5.5 prices, 1,500 modest turns a month cost about $24 to $75 on the API.",[15,647,648,651],{},[288,649,650],{},"Is it allowed to use a Claude subscription in Hermes?"," Anthropic's help centre, when we checked on 27 October 2026, said the Agent SDK and third-party apps built on it run against your plan's usage limits, and that changes announced in May were paused. The plugin uses the official Claude Code CLI. Rules change, so check Anthropic's current terms for your plan.",[653,654,655],"style",{},"html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .shJU0, html code.shiki .shJU0{--shiki-default:#22863A}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}",{"title":152,"searchDepth":177,"depth":177,"links":657},[658,659,660,663,664,665,666,667,668],{"id":31,"depth":177,"text":32},{"id":65,"depth":177,"text":66},{"id":131,"depth":177,"text":132,"children":661},[662],{"id":283,"depth":191,"text":284},{"id":328,"depth":177,"text":329},{"id":373,"depth":177,"text":374},{"id":452,"depth":177,"text":453},{"id":496,"depth":177,"text":497},{"id":580,"depth":177,"text":581},{"id":611,"depth":177,"text":612},"Guides","2026-10-28","Use your Claude Pro/Max or ChatGPT Plus subscription in Hermes Agent: how to set it up, why you hit 429 and usage limits fast, and what it really costs.","md",false,"/img/blog/hermes-agent-claude-chatgpt-subscription.jpg",null,{},true,"/blog/hermes-agent-claude-chatgpt-subscription","10 min read",{"title":5,"description":671},"Hermes With a Claude or ChatGPT Subscription: Setup, Limits","blog/hermes-agent-claude-chatgpt-subscription",[684,685,686,687,688,689],"hermes claude subscription","hermes chatgpt plus","hermes agent claude subscription","hermes claude code subscription","hermes claude subscription 429","hermes chatgpt plus usage limit","jjnw1f0ojxQo9ykll5lVp-oOdvULGGE8plHhjjtcPP0",[692,699,706],{"stem":693,"title":694,"description":695,"date":670,"image":696,"category":697,"redirected":673,"author":698,"readingTime":679},"blog/hermes-agent-keeps-stopping","Hermes Agent Keeps Stopping? How to Make It Finish the Job","Hermes stops after every reply, gets stuck or says \"goal blocked\"? Use /goal, raise the turn budget, fix timeouts and keep the gateway up. Every fix.","/img/blog/hermes-agent-keeps-stopping.jpg","Troubleshooting",{"name":7,"role":8,"avatar":9,"bio":10},{"stem":700,"title":701,"description":702,"date":670,"image":703,"category":669,"redirected":673,"author":704,"readingTime":705},"blog/hermes-agent-memory-providers","Hermes Agent Memory Providers Compared (and How to Fix Recall)","Honcho, Hindsight, Mem0, Supermemory, Mnemosyne and more for Hermes Agent: setup, cost, local vs cloud, and how to fix memory that won","/img/blog/hermes-agent-memory-providers.jpg",{"name":7,"role":8,"avatar":9,"bio":10},"13 min read",{"stem":707,"title":708,"description":709,"date":670,"image":710,"category":669,"redirected":673,"author":711,"readingTime":712},"blog/hermes-agent-telegram-setup","Hermes Agent Telegram Setup: Bot, Groups and Topics (2026)","Connect Hermes Agent to Telegram: create the bot, add the token, use it in groups and topics without @mentions, and fix the common errors.","/img/blog/hermes-agent-telegram-setup.jpg",{"name":7,"role":8,"avatar":9,"bio":10},"9 min read",1793257084426]