Claude Code→Hermes Agent移行ガイド｜現実的な手順と判断軸【2026年版】

Claude Code から Hermes Agent への移行を検討する人が、2026年4月以降に明確に増えています。引き金は Anthropic の OAuth 規約変更と、Nous Research が公開した「the open source agent that grows with you」をキャッチコピーとするセルフホスト型エージェントランタイムへの関心でした。本記事では、Claude Code と Hermes Agent の機能差・現実的な移行手順・移行すべき人と留まるべき人の判断軸を、両者を実際に運用している立場から整理します。

なぜ今「Claude Code から Hermes Agent への移行」が話題なのか

2026年に入ってから、英語圏の開発者コミュニティで「Claude Code から Hermes Agent に乗り換えた」という記録が一気に増えました。背景には3つの動きが重なっています。

• 2026-02 Hermes Agent 公開：Nous Research が「the open source agent that grows with you」というキャッチコピーで自律エージェントランタイムを公開。多層メモリと永続的なマシンアクセスを前提に設計されています。
• 2026-03〜 Nous Research と Teknium 氏が Claude Code 比較を積極発信：ローンチ後、X 上で「Claude Code から乗り換えた」「Claude Code を SWE-bench で上回った」といった訴求が継続的に流れ、英語圏コミュニティで「移行論」が定着しました。
• 2026-04-04 Anthropic OAuth 規約変更：Claude Pro/Max サブスクリプションのトークンを第三者ハーネス経由で叩く構成が規約違反として明示され、Claude Code 以外のクライアントから Claude Max を流用する経路が事実上塞がれました。

この3つが噛み合い、「Claude Code から離れる選択肢」を真面目に検討する開発者が増えています。Hermes Agent はそうした層の最有力候補に浮上した、というのが2026年5月時点の構図です。

ただし、結論を先に書いておくと、多くの開発者にとって Claude Code に留まる方が合理的です。理由は本記事の中盤以降で具体的に整理します。

Claude Code と Hermes Agent の機能比較

まず両者の設計思想と機能差を整理します。私は Claude Code を Max 20x プランで日々運用しており、Hermes Agent も Mac mini 上で立ち上げて挙動を確認した上で書いています。

機能の網羅性だけで見れば、Hermes Agent が広く・Claude Code が深い、という構図になります。モデル選択の自由度・セルフホスト・自己進化するスキル・複数メッセンジャー対応はすべて Hermes Agent 側の優位です。一方、Claude Code は Claude モデルとの統合品質・セットアップの簡便さ・Anthropic 純正である安心感で抜けています。

モデル選択の自由度が決定的な差になるケース

機能比較表のなかで、移行検討者がいちばん気にしているのがモデル選択です。Claude Code は Claude モデルに固定されているため、コスト最適化の余地が限定されます。Max 20x の $200/月でも、業務量が多い開発者だとレートリミットに当たります。

Hermes Agent は OpenAI 互換エンドポイントに対応していれば何でも繋がります。私が動作確認した範囲では、DeepSeek V3 系・MiniMax 系・OpenRouter 経由の各種モデル・ローカル LLM（Ollama / LM Studio）が問題なく接続できました。プロバイダ間の切り替えは設定ファイルの書き換えだけで済みます。

「あるタスクはコスト重視の安いモデル、別のタスクは品質重視で Claude Sonnet」という使い分けが、1つのエージェント基盤の中で完結する。これは Claude Code には構造上できない芸当です。

セルフホストが効くのは規約・データ管轄の論点

セルフホストの優位性は、コストよりも規約とデータ管轄の論点で効きます。クライアントの機密データを外に出せない案件、自社のオンプレ環境内で完結させたい案件、自宅 IP で SNS 検知を回避したいケースなどです。

Microsoft Teams 経由でクライアント機密データを on-premise で扱う事例が公式 user stories に掲載されており、これは Claude Code では原理的に不可能な運用です。Anthropic のサーバーを必ず経由する以上、データが社外に出ること自体を許容できない案件は Claude Code を選べません。

Hermes Agent への現実的な移行手順

「ワンコマンドで Claude Code 環境がそのまま Hermes Agent に再現される」と期待しているなら、ここで立ち止まってください。2026年6月時点で、Nous Research が公式に提供している専用移行コマンドは存在しません。実際の移行は、Hermes Agent のセットアップを通常通り行ったうえで、Claude Code 側の資産を手動でマッピングしていく作業になります。

移行作業を5つのステップに分解して整理します。

Step 1. CLAUDE.md → Hermes Agent メモリ層への手動取り込み

Claude Code の CLAUDE.md は、プロジェクトの規約・コンテキストを記述するためのファイルです。Hermes Agent は同等の役割を MEMORY.md と SOUL.md（3層メモリ構造）で担っています。

移行時は CLAUDE.md の内容を MEMORY.md にコピーする（または hermes memory setup で初期化したファイルに統合する）形が基本です。ファイル構造と参照ルールが微妙に違うため、丸コピーではなく内容を見直しながらの統合を推奨します。

Step 2. .claude/skills/ → Hermes Agent skills への手動移植

Claude Code の Skills（.claude/skills/{name}/SKILL.md）は、Hermes Agent の Skills ディレクトリにそのままドロップしてもほぼ動きます。両者のフォーマットは似ているためです。

ただし以下は手動調整が必要です。

• ハーネス固有のスラッシュコマンド呼び出し
• mcp__ プレフィックスのツール呼び出し（Claude Code 固有名前空間）
• Hooks との連動部分

「とりあえずコピー → エラーが出た部分だけ直す」というアプローチで実用上は十分です。

Step 3. .mcp.json → Hermes Agent MCP 設定への移行

Claude Code の .mcp.json は MCP サーバ接続情報を持っています。Hermes Agent も MCP に対応しており、接続情報の構造はほぼ互換です。

Hermes 起動後に hermes tools enable <mcp-server-name> で個別に有効化していくのが標準フローです。Built-in MCP Catalog（Linear / n8n / AgentMail 等）に該当するサーバはそちらから直接有効化した方が早いケースもあります。

Step 4. permissions / Hooks の組み直し

ここは完全な互換性がありません。Claude Code の permissions は宣言的な権限制御、Hermes Agent は HERMES_WRITE_SAFE_ROOT 環境変数 + Hooks 実装で同等の制限を組みます。

セキュリティ監査 #7826（Critical 4件 / High 9件）への対応も含めて、ここは設計から組み直す前提で計画してください。本番運用に進む前に Docker 隔離の検討も合わせて行うべきです。

Step 5. セッション履歴・サブエージェント定義は失われる前提

Claude Code の ~/.claude/projects/ 配下のセッション履歴、.claude/agents/ 配下のサブエージェント定義、.claude/output-styles/ などのハーネス固有資産は、Hermes Agent には機械的に移行できません。

「Claude Code 固有のハーネス資産は失われる前提」で計画するのが安全です。逆に、CLAUDE.md と Skills と MCP 設定さえ移行できれば、実務上の核心は維持できます。

Anthropic OAuth 規約変更が移行検討の追い風になっている事実

移行検討者にとって最大の追い風になっているのが、2026-04-04 から有効になった Anthropic の OAuth 規約変更です。これは Claude Code 移行論を語る上で外せない論点なので、独立して整理します。

何が変わったか

規約変更の核心は、「Claude Pro / Max サブスクリプションの OAuth トークンを、Anthropic 純正クライアント以外（＝第三者ハーネス）から呼び出す構成が明示的に禁止された」という点です。違反するとアカウント BAN・サブスク強制解約のリスクがあります。

これまで一部の開発者は、Claude Code のサブスクトークンを抜き取って自作エージェントから叩く構成で「Max $200 でほぼ無制限に Claude を使う」運用をしていました。2026-04-04 以降、この経路は規約違反として明確に塞がれています。

なぜこれが Hermes Agent への移行を後押しするのか

第三者ハーネスから Claude を叩きたいユーザーには、選択肢が2つ残されました。

• Anthropic API キーを直接利用する：規約上は完全に合法。ただし従量課金で、ヘビーユーザーには Max 20x より高くつくケースがある。
• Claude 以外のモデルに乗り換える：DeepSeek / OpenAI / オープンモデルを使えば Anthropic 規約から自由になる。

Hermes Agent は後者の経路を最も自然に取れるエージェントです。Anthropic API キー直接利用にも対応していますし、Claude を使わない選択肢（DeepSeek / OpenAI / ローカル LLM）にもネイティブ対応しています。「Claude Code の規約変更で詰まったから乗り換える」という動機は、Hermes Agent の設計と相性が良すぎる。

海外の移行事例｜何を期待して、何が実際に起きたか

抽象論だけだと判断が難しいので、英語圏で公開されている移行記録のうち、特に参考になるものを引用します。

@techNmak：10日でコードベースを「私より理解する」エージェントに

"10 days ago I installed an open-source agent. Today it knows my codebase better than I do."
（10日前にオープンソースのエージェントをインストールした。今ではそのエージェントは、私自身よりも私のコードベースを理解している）

— @techNmak、2026-04-07

同氏は Claude Code から Hermes Agent への移行体験を共有しており、セッションをまたぐ永続記憶が、長期プロジェクトでは Claude Code の手動 MEMORY.md 運用を上回ると評価しています。同じプロジェクトを数週間〜数ヶ月にわたって触り続ける開発者には、自己生成スキルと多層メモリの積み上げが効いてきます。

@NathanWilbanks_：累計 900,000+ compute 秒、$100K+ 相当の業務自動化

2026-04-25 時点で Day 297 のマイルストーンを記録した同氏は、Hermes Agent を「クライアントワーク自動化スイートの基盤」として運用しています。累計 900,000秒（=250時間）超の自律稼働で、$100K+ 相当の業務を自動化したと公開しています。

この規模は Claude Code では構造上難しい。Claude Code はセッション単位の対話を前提にしており、月単位で常駐させて永続的に動かす設計ではありません。「24時間常駐＋複数ワークフロー＋プッシュ受信」が必要なユースケースでは、Hermes Agent の優位が明確に出ます。

コスト破壊事例：$130 / 5日 → $10 / 5日

Greg Isenberg と Imran 氏のポッドキャストで紹介された事例では、同等の業務を Claude Code 系で $130 / 5日かかっていたものが、Hermes Agent + DeepSeek 系モデルで $10 / 5日に圧縮されたと報告されています。約13分の1のコスト圧縮です。

これはモデル選択の影響が大きいので一般化はできませんが、コスト最適化を真剣に追う案件では Hermes Agent のモデル不問設計が直接効いてきます。「Claude Sonnet でやっていた処理のうち、品質が必要ない部分を安いモデルに振る」という設計が可能になるのが大きい。

事例を読むときの注意点

派手な数字が出ている移行事例には、注意して読むべき点があります。

• 初期セットアップ工数が記述されていないケースが多い：Docker 構成・モデル接続・WSL2 / aarch64 まわりのトラブルシュートに、最初の数十時間を吸われる事例が複数あります。
• 「同じ業務を反復している」前提：自己生成スキルが効くのは反復タスクです。毎回違う種類の単発タスクをこなす開発者には旨味が薄い。
• セキュリティ監査 #7826 への対応コストが見えにくい：公式 Issue #7826 で Critical 4件 / High 9件 が指摘されており、本番運用には Docker 隔離・HERMES_WRITE_SAFE_ROOT 設定・skill 監査などの追加対策が必要です。

移行すべき人 / 留まるべき人の判断軸

ここまでの整理を踏まえて、私自身の判断軸を出します。Hermes Agent 推し一辺倒にはしません。Claude Code に留まる方が合理的なケースも多いのが実態です。

Hermes Agent に移行すべき人

• 24時間常駐＋複数ワークフロー＋プッシュ受信が業務要件にあるユーザー（SNS 自動化、監視ボット、長期エージェント運用）
• クライアント機密データをセルフホストで完結させる必要がある案件（医療・金融・on-premise 必須の業種）
• Claude 以外のモデル（DeepSeek / OpenAI / ローカル LLM）を主軸にしたい、またはモデル切替でコスト最適化したいユーザー
• Telegram / Discord / Slack / WhatsApp など複数チャネルから同時にエージェントを叩きたいユーザー
• 2026-04-04 の Anthropic OAuth 規約変更で第三者ハーネス経由の利用が塞がれて困っているユーザー
• Docker・SSH・サーバー運用に習熟しており、v0.x 台の不安定さを許容できる開発者

Claude Code に留まるべき人

• Claude モデルの品質（Sonnet 4.x / Opus 4.x）に強く依存しており、モデル変更で品質が落ちると業務が成り立たないユーザー
• セットアップに時間を割けない、「CLI 1行で動くこと」を最優先にしたいユーザー
• セッション単位の対話で十分で、24時間常駐の必要がないユーザー
• セキュリティ監査 #7826 の指摘に対する自前の対策（Docker 隔離・skill 監査・HERMES_WRITE_SAFE_ROOT 設定）を組む工数が取れない組織
• 非エンジニア層・小規模チーム・社内に運用エンジニアがいないクライアント
• Anthropic 規約の枠内で完結する範囲（Claude Code をそのまま使う）で業務要件が満たせるユーザー

併用が現実解になるケースも多い

実務的には、「メインは Claude Code、特定の常駐業務だけ Hermes Agent」という併用構成が最も合理的なケースが多いです。私自身、Claude Code を主開発環境として維持しつつ、別マシン（Mac mini）で Hermes Agent を立てて、SNS 自動化と長期常駐タスクだけ Hermes 側に寄せる構成を取っています。

「乗り換える / 乗り換えない」の二択ではなく、業務単位で適材適所に振り分けるのが現時点の正解です。Claude Code は Anthropic 純正の安心感、Hermes Agent はモデル自由とセルフホスト、それぞれの強みが効く場面が違うので、無理に統合する必要はありません。

中小企業・法人案件で考えるべきこと

株式会社Fyveとして中小企業の AI 導入を支援する立場から見ると、Hermes Agent の本格導入を法人クライアントに勧める段階にはまだ来ていないというのが2026年5月時点の判断です。理由を整理します。

• v0.x 台の不安定さ：マイナーバージョン間で破壊的変更が起きる可能性があり、業務システムとして組み込むには時期尚早です。v1.0 のリリースを待つのが安全です。
• 運用に英語・コマンドライン・サーバー知識が必要：Docker 運用・MCP 設定・モデル接続のトラブルシュートは非エンジニアには敷居が高く、社内に運用担当が必要になります。
• 日本語ユースケースの蓄積が薄い：海外の事例は豊富ですが、日本の中小企業特有の業務（介護記録・建設日報・補助金申請など）に最適化された運用パターンはまだ存在しません。
• セキュリティ監査 #7826 の対応工数：Critical 4件 / High 9件 への対応設計を、法人案件として責任を持って組むには専門エンジニアの工数が必要です。

逆に、Claude Code は CLI インストールだけで動き、permissions と Hooks の組み合わせで安全な運用設計が組めます。中小企業の AI 業務効率化には、まず Claude Code を導入して運用知見を貯めるのが現実的なルートです。Hermes Agent への移行は、その先の選択肢として温めておく形になります。

Claude Code 自体の中小企業向け活用については、別途まとめた記事があります。

AIエージェントとは？チャットAIとの違いを実務者が解説【中小企業向け】

また、Hermes Agent と OpenClaw の比較を先に押さえたい方は、こちらの記事を合わせてご覧ください。

Hermes Agent vs OpenClaw 徹底比較｜違い・使い分け・どっちを選ぶべきか実務者が解説【2026年版】

まとめ｜「移行ありき」ではなく「業務要件起点」で判断する

Claude Code から Hermes Agent への移行は、2026-04 の Anthropic OAuth 規約変更と Nous Research の積極的な比較訴求を引き金に、英語圏で本格的に議論され始めました。ただし、2026年6月時点で公式の専用移行コマンドは存在せず、CLAUDE.md / Skills / MCP 設定を手動でマッピングし、permissions と Hooks は組み直す前提の作業になります。

機能比較で見れば、モデル選択の自由度・セルフホスト・自己進化するスキル・複数メッセンジャー対応は Hermes Agent の優位です。一方、セットアップの簡便さ・Claude モデルの品質・Anthropic 純正である安心感は Claude Code の優位です。どちらが上、ではなく設計思想の違いです。

移行を検討するなら、まず「24時間常駐が必要か」「Claude 以外のモデルを使いたいか」「セルフホストが必須要件か」を自問するのが先です。これらに当てはまらないなら、Claude Code に留まる方が合理的です。中小企業の業務効率化案件では、現時点では Claude Code をベースに運用知見を貯めるルートを推奨します。

AI エージェントは「派手な新ツール」から「業務に根を張るインフラ」へ移りつつあります。乗り換えの判断は、煽りや流行ではなく、自社の業務要件起点で冷静に行うのが安全です。