コンテンツへスキップ
1折AI ドキュメント
日本語

Hermes Agent での Claude API 接続

1折AI の Claude API リレーのアドレス、API キー、モデルを Hermes Agent に設定する手順。プロトコルの選択、設定例、検証手順、よくあるエラーを含む。

Hermes Agent のカスタムプロバイダー機能を使って 1折AI に接続します。まず API キーを作成 し、現在利用可能なモデル を確認してください。以下のモデル ID は例です。お使いのキーの権限に合わせて調整してください。

公式設定の確認日：2026-10-15。以下の設定は公式ドキュメントに基づいて整理したものです。当サイトでのエンドツーエンド検証は未完了です。長時間のタスクに使用する前に、簡単な質問応答とツール呼び出しの検証を済ませてください。OpenAI / GPT モデルは提供開始済みで、モデル一覧と価格はモデル説明を参照してください。

公式 Providersに基づき：ターミナルで hermes model を実行 → Custom endpoint を選択し、API mode で明示的に chat_completions を選択、Base URL に https://1zheai.com/v1 を入力し、キーとモデルを記入します。ChatGPT/Codex のログインは選ばないでください。これは別の接続方式です。

再利用可能な名前付き provider 設定（~/.hermes/config.yaml にマージ）：

yaml
providers:
  onezhe:
    api: https://1zheai.com/v1
    key_env: ONEZHE_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6
model:
  provider: custom:onezhe
  default: claude-sonnet-4-6

~/.hermes/.env でローカルに提供：

dotenv
ONEZHE_API_KEY=sk-替换为本站密钥

設定後、会話内で /model custom:onezhe:claude-sonnet-4-6 に切り替えられます。/model では、ターミナルの hermes model で新しい provider を作成することはできません。公式は anthropic_messages での転送に対応していますが、本チュートリアルでは URL からプロトコルを自動推測しないよう Chat Completions を使用します。OPENAI_BASE_URL はすべてのカスタム provider に共通する設定ではありません。上記の明示的な設定を使用してください。

接続の検証とトラブルシューティング

「接続の検証とトラブルシューティング」というセクション
  1. 設定を保存して再読み込みし、現在選択されているのが onezhe プロバイダー、または追加したカスタムモデルであることを確認します。
  2. 簡単な質問を 1 件送信し、応答が返ることを確認します。その後、取り消し可能な小さなタスクを試し、ツール呼び出しとマルチターン会話を個別に確認します。
  3. 呼び出しログ を開き、リクエスト時刻、モデル、ステータス、使用量を照合します。テキスト応答が 1 回成功しただけで、すべての Agent 機能が互換であるとは限りません。
  4. 404 が発生した場合は、本ページのアドレスとプロトコルが対応しているか確認します。401 が発生した場合は、キーの出所とプロセスが環境変数を読み取っているか確認します。429 が発生した場合は、レート制限情報を確認してから再試行します。詳細はエラーコードとトラブルシューティングを参照してください。

キーはローカル環境またはツールの資格情報ストレージにのみ保存し、コードリポジトリ、スクリーンショット、公開ログにコミットしないでください。バックグラウンドサービスはターミナルの環境変数を継承しない場合があります。補助モデル、検索、その他のツールには個別のプロバイダー設定がある場合があり、それぞれ確認が必要です。

費用とその他の接続方法

「費用とその他の接続方法」というセクション

Claude API のリアルタイム価格と課金ルールを確認してください。他のクライアントが必要な場合はツール接続カタログに戻ってください。自分でプログラムを書く場合はSDK と開発ガイドを利用できます。