---
title: "Hermes Agent での Claude API 接続"
description: "1折AI の Claude API リレーのアドレス、API キー、モデルを Hermes Agent に設定する手順。プロトコルの選択、設定例、検証手順、よくあるエラーを含む。"
headingIds: {"接続の検証とトラブルシューティング":"section-1","費用とその他の接続方法":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

エラーを見つけましたか？ページのアドレスと説明を添えて[サポートに連絡](mailto:support@1zheai.com)してください。API キーやアカウント情報は送信しないでください。

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

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

[公式 Providers](https://hermes-agent.nousresearch.com/docs/integrations/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. [呼び出しログ](/ja/docs/usage-logs/) を開き、リクエスト時刻、モデル、ステータス、使用量を照合します。テキスト応答が 1 回成功しただけで、すべての Agent 機能が互換であるとは限りません。
4. 404 が発生した場合は、本ページのアドレスとプロトコルが対応しているか確認します。401 が発生した場合は、キーの出所とプロセスが環境変数を読み取っているか確認します。429 が発生した場合は、レート制限情報を確認してから再試行します。詳細は[エラーコードとトラブルシューティング](/ja/docs/troubleshooting/)を参照してください。

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

## 費用とその他の接続方法

[Claude API のリアルタイム価格](https://1zheai.com/en/pricing/)と[課金ルール](/ja/docs/pricing-explained/)を確認してください。他のクライアントが必要な場合は[ツール接続カタログ](/ja/docs/integrations/)に戻ってください。自分でプログラムを書く場合は[SDK と開発ガイド](/ja/docs/guides/)を利用できます。