OpenCode から Claude API に接続

OpenCode で 1折AI の接続先、API キー、モデルを設定します。プロトコルの選択、設定例、接続確認、エラーの調べ方を説明します。

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

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

OpenCode v1 設定

公式 v1 Providersに基づき、/connect を実行し、Other を選択、provider ID に onezhe を入力し、当サイトの API Key を記入します。プロジェクトの opencode.json にマージ：

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "onezhe": {
5
      "npm": "@ai-sdk/openai-compatible",
6
      "name": "1折AI",
7
      "options": { "baseURL": "https://1zheai.com/v1" },
8
      "models": {
9
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
10
      }
11
    }
12
  }
13
}

その後、/models でこの provider のモデルを選択します。/connect は認証情報のみを保存し、provider 設定の代わりにはなりません。ここでは Chat Completions 用の SDK を明示的に選択しており、Responses 用の @ai-sdk/openai に誤って変更してはいけません。公式では options.apiKey: "{env:ONEZHE_API_KEY}" で環境変数を参照することも許可されています。

OpenCode v2 設定

公式 v2 Providersに基づき、ネイティブな v2 フィールドを使用します。上記の v1 と混在させてはいけません。プロジェクトの opencode.jsonc にマージ：

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "providers": {
4
    "onezhe": {
5
      "name": "1折AI",
6
      "env": ["ONEZHE_API_KEY"],
7
      "package": "@opencode/ai/providers/openai-compatible",
8
      "settings": { "baseURL": "https://1zheai.com/v1" },
9
      "models": {
10
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
11
      }
12
    }
13
  }
14
}

OpenCode を起動するプロセスの環境で ONEZHE_API_KEY を提供し、その後 /models で onezhe/claude-sonnet-4-6 を選択します。v2 の主な違いは providers、package、settings であり、v1 の provider、npm、options ではありません。まず opencode --version で使用しているメジャーバージョンを確認してください。

ネイティブな Anthropic を使用する場合、v1 公式では provider.anthropic.options.baseURL の上書きが許可されており、例に /v1 が含まれます。v2 では @opencode/ai/providers/anthropic-compatible が列挙されています。本チュートリアルは明示的な OpenAI 互換設定を使用しており、モデル名から独自にプロトコルを変更したり、キャッシュやツール呼び出しがすべて検証済みであると約束したりしてはいけません。

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

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

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

費用とその他の接続方法

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