---
title: "OpenCode から Claude API に接続"
description: "OpenCode で 1折AI の接続先、API キー、モデルを設定します。プロトコルの選択、設定例、接続確認、エラーの調べ方を説明します。"
headingIds: {"OpenCode v1 設定":"section-1","OpenCode v2 設定":"section-2","接続の検証とトラブルシューティング":"section-3","費用とその他の接続方法":"section-4"}
---

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

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

## OpenCode v1 設定

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

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "onezhe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "1折AI",
      "options": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

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

## OpenCode v2 設定

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

```json
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "onezhe": {
      "name": "1折AI",
      "env": ["ONEZHE_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

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 互換設定を使用しており、モデル名から独自にプロトコルを変更したり、キャッシュやツール呼び出しがすべて検証済みであると約束したりしてはいけません。

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

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/)をご利用ください。