---
title: "WorkBuddy での Claude API 接続"
description: "WorkBuddy で 1折AI Claude API リレーのアドレス、キー、モデルを設定するチュートリアル。プロトコル選択、設定例、検証手順、よくあるエラーを含みます。"
headingIds: {"接続の検証とトラブルシューティング":"section-1","費用とその他の接続方法":"section-2"}
---
WorkBuddy のカスタムプロバイダー機能を使用して 1折AI に接続します。まず [API キーを作成](/ja/docs/api-keys/) し、[現在利用可能なモデル](/ja/docs/models/) を確認してください。以下のモデル ID は例です。お使いのキーの権限に合わせて調整してください。
公式設定の確認日：2026-10-15。以下の設定は公式ドキュメントに基づいて整理したもので、当サイトでのエンドツーエンド検証はまだ完了していません。長時間のタスクに使用する前に、まず簡単な質問応答とツール呼び出しの検証を行ってください。OpenAI / GPT モデルはすでに提供されており、モデル一覧と価格は[モデル説明](/ja/docs/models/)をご覧ください。
[公式のモデル設定](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)に基づき：設定 → モデル → モデルを追加 → カスタム/Custom。当サイトのキーとモデル `claude-sonnet-4-6` を入力します。
完全なリクエストアドレスによる設定を採用します：詳細設定で「カスタムプロトコル」を有効にし、URL に `https://1zheai.com/v1/chat/completions` を入力し、保存後に会話のモデルセレクターでそのモデルを選択します。公式の説明によると、このスイッチを有効にすると入力した URL をそのまま使用し、パスの検証や自動補完は行いません。無効にすると標準的な `/chat/completions` に基づいて補完されます。したがって、完全な URL とスイッチはセットで記述する必要があります。
ここでの「カスタムプロトコル」は、OpenAI リクエストを Anthropic リクエストに自動変換できることを意味しません。`/v1/messages` を入力しただけでネイティブな Claude プロトコルが接続できたと主張することはできません。UI を優先し、未検証の `models.json` の手動フォーマットは提供しません。公式ページには現在のローカル設定パスと旧 `~/.codebuddy/models.json` の移行説明が同時に記載されているため、これを根拠に旧パスを一般的な現行パスとして記載しないでください。UI 上のツール能力表示も当サイトのエンドツーエンド検証の代わりにはなりません。
## 接続の検証とトラブルシューティング
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/)をご利用ください。