OpenCode API キー設定

OpenCode API キー設定: ベース URL、プロバイダー、モデル

サードパーティ API で OpenCode を使うには、API キー、base_url、プロバイダー設定の 3 つが必要です。

Claude、Kimi、GLMなどを従量課金で利用: APIキーを取得し、opencode.jsonでbase_urlとproviderを設定し、テストメッセージで確認します。

opencode.json の例JSON
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

OpenCode not installed?

This page configures the OpenCode terminal CLI. If opencode --version already prints a version, skip ahead to the quick setup.

基本インストールコマンド

curl -fsSL https://opencode.ai/install | bash

Or install globally with npm (this exact command is commonly searched)

npm install -g opencode-ai@latest

Installation succeeds when opencode --version prints a version number.

安全なクイック設定

モデルを選び、設定をコピーし、ファイルを保存して、約 3 分で接続を検証します。

  • Claude Opus 5.5 (claude-opus-5-5)
  • Claude Sonnet 5.5 (claude-sonnet-5-5)
  • DeepSeek V4.1 Flash (deepseek-flash)
  • GLM-5.3 (glm-5.3)
  • Kimi K2.7 Code (kimi-k2.7-code)
  • GPT-6 Astra (gpt-6-astra)
  • Claude Fable 5.1 (claude-fable-5-1)
  • Fable 5 (claude-fable-5)
  • Haiku 4.5 (claude-haiku-4-5-20251001)
  • Opus 4.6 (claude-opus-4-6)
  • Opus 4.7 (claude-opus-4-7)
  • Opus 4.8 (claude-opus-4-8)
  • Opus 5 (claude-opus-5)
  • Sonnet 4.6 (claude-sonnet-4-6)
  • Sonnet 4.6 (claude-4.6-sonnet-medium)
  • Sonnet 5 (claude-sonnet-5)
  • DeepSeek V4 Flash (deepseek-v4-flash)
  • DeepSeek V4 Pro (deepseek-v4-pro)
  • 2.5 Pro (gemini-2.5-pro)
  • 3 Pro Preview (gemini-3-pro-preview)
  • 3.1 Pro Preview (gemini-3.1-pro-preview)
  • Gemini 3 Flash Preview (gemini-3.5-flash)
  • Gemini 3.6 Flash (gemini-3.6-flash)
  • Gemini 3.7 Flash (gemini-3.7-flash)
  • Gemini 3.8 Flash (gemini-3.8-flash)
  • GLM 5.1 (glm-5.1)
  • GLM 5.2 (glm-5.2)
  • Grok 4.5 (grok-4.5)
  • Grok 4.6 (grok-4.6)
  • Grok 4.7 (grok-4.7)
  • Grok 4.7 Build Fast (grok-4.7-build-fast)
  • Kimi K2.6 (kimi-k2.6)
  • Kimi K3 (kimi-k3)
  • GPT-5.5 (gpt-5.5)
  • GPT-5.6 Sol (gpt-5.6-sol)
  • GPT-5.6 Terra (gpt-5.6-terra)
  • GPT-6 Sol (gpt-6-sol)
  • Claude Haiku 5.5 (claude-haiku-5-5)
  • Gemini 3 Flash Preview (gemini-3-flash-preview)
  • Gemini 4 Argon (gemini-4-argon)
  • GPT-6.1 Sol (gpt-6.1-sol)
  • Jev 1.13 (jev-1.13.0)
  • Jev Latest (jev-latest)
  • Grok 4.5 (grok-4.5)
  • Grok 4.6 (grok-4.6)
  • Grok 4.7 (grok-4.7)
  • Grok 4.7 Build Fast (grok-4.7-build-fast)

1. モデルを選択

現在のカタログには 47 個のモデルが含まれています。

2. 設定をコピー

プロバイダー
aicodewith-anthropic
npm アダプター
@ai-sdk/anthropic
ベース URL
https://api.aicodewith.ai/v1
モデル ID
claude-opus-5-5
{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}
次へ: 設定を保存

3. opencode.json を保存して API キーを設定

既存の opencode.json をバックアップし、生成された内容から model と provider の両方をマージします。他のプロバイダーはそのままにし、実際のキーはローカル環境変数にのみ保存してください。

API キーページを開く

設定ファイルを保存

  1. 1. システムのターミナルを開く

    2. 以下のコマンドを実行して設定ファイルを開きます(存在しない場合は自動作成されます):

    notepad "$env:USERPROFILE\.config\opencode\opencode.json"
  2. 3. 手順 2 でコピーした設定を貼り付けて保存します

    Windows/Linux では Ctrl+S、macOS では Cmd+S を押します。

API キーを設定(your-key を実際のキーに置き換えます)

新しいターミナルを開くかシェル設定を再読み込みし、その後 OpenCode を再起動してください。

4. 再起動して検証

  1. システムのターミナルで実行opencode
  2. OpenCode 内で入力/models プロバイダーとモデル ID がページの選択と一致することを確認
  3. チャットで送信Reply with exactly: connection successful
  4. OpenCode が返信を表示することを確認し、AI Code With の使用記録でその時刻とモデルを照合します

使用記録は、リクエストが AI Code With に到達したことを確認するものです。成功判定は、ステータス、応答内容、OpenCode に実際に表示された返信から行います。

OpenCodeはどのようにしてサードパーティAPIに接続しますか?

OpenCodeは、選択したAPIサービスにリクエストを送信するためにカスタムProviderを使用します。ProviderはOpenCodeにどのサービスを呼び出すかを指示する名前空間であり、APIキーは認証を処理し、Base URLはサードパーティAPIのエンドポイントであり、Model IDは実際のモデルを選択します。

保存されると、リクエストはOpenCode → Provider → Base URL → モデルAPIの順に流れます。/modelsチェックと短いテストメッセージの後、時間とモデルで使用記録とリクエストを照合できます。

セットアップが失敗した場合、まずこの4つの点を確認してください

各項目は、詳細な手順を含む専用のトラブルシューティング記事にリンクしています。

  • 通常、APIキーが無効か、誤入力されているか、正しく読み取られていません。AICODEWITH_API_KEYが余分なスペースなしで設定されていること、およびOpenCodeが同じターミナルから起動していることを確認してください。

  • Model IDがProvider設定と一致しないか、チャネルがモデルをサポートしていません。生成されたModel IDとProviderのペアを文字単位で比較してください。

  • 通常、Base URLが間違っています。このページで生成された値をコピーし、/v1、/v1betaを追加したり、エンドポイントパスをでっち上げたりしないでください。

  • 設定が適用されない / Providerが見つからない

    詳細なトラブルシューティングを表示 →

    設定ファイルのパス、JSONが有効であること、OpenCodeがファイルを再読み込みしたことを確認してください。保存後にOpenCodeを再起動し、/modelsを実行してください。

よくある質問

Base URLは何にすればよいですか?

上記のクイックセットアップで生成されたBase URLをコピーしてください。/v1や/v1betaを手動で追加しないでください。

OpenCodeの設定ファイルはどこにありますか?

このページは~/.config/opencode/opencode.jsonを生成します。パスはインストール方法やバージョンによって異なる場合があるため、現在のOpenCodeドキュメントと比較してください。

セットアップが機能することを確認するにはどうすればよいですか?

/modelsを実行してモデルを選択し、短いメッセージを送信し、AI Code Withの使用記録で時間とモデルによりリクエストを照合します。

どのモデルがサポートされていますか?

Claude、GPT、Gemini、DeepSeek、GLM、Kimi、Grokなどがあります。「すべてのモデルを表示」をクリックして完全なカタログを参照してください。

完全なインストールまたはトラブルシューティングのドキュメントが必要ですか?

完全なインストールガイド、すべての設定パラメータ、完全なモデルリスト、およびトラブルシューティングについては、OpenCodeセットアップドキュメントを参照してください。

OpenCodeセットアップドキュメントを開く

Common problems: レート制限または429 · 利用量は記録されているのに OpenCode が返信を表示しない · reasoning part/text part が見つからない、または summaryParts の解析エラー · 403 Forbidden · BunInstallFailedError または models.dev のダウンロード失敗