メインコンテンツへスキップ
OpenCodeは新しいモデルプロバイダーとしてAiHubMixをサポートしました。OpenCode内でAiHubMixのAPIキーを使用して、そのモデルサービスにアクセスできます。 AiHubMixは現在、GPT、Claude、DeepSeek、Gemini、Qwenを含む主要なモデルファミリーをサポートしています。OpenCodeで最適なパフォーマンスを得るために、以下のモデルが推奨されます：
  • claude-sonnet-4-5
  • glm-4.6
  • gpt-5
  • gpt-5-codex
このガイドでは、異なるオペレーティングシステム上でOpenCodeをインストール、設定、起動し、AiHubMix APIに接続するための段階的な手順を説明します。

​
システム要件

インストール前に、システムが以下の要件を満たしていることを確認してください：
  • Node.js ≥ 18.0.0
  • パッケージマネージャー（OS により任意）：
    • macOS / Linux: brew
    • Arch Linux: paru
    • Windows: choco、winget、または scoop
  1. OpenCodeのインストール
以下のいずれかの方法でOpenCodeをインストールできます： Node.jsを使用 
# CURLを使用 
curl -fsSL https://opencode.ai/install | bash

# NPMを使用
npm install -g opencode-ai

# Bunを使用
bun install -g opencode-ai

# PNPMを使用
pnpm install -g opencode-ai

# Yarnを使用
yarn global add opencode-ai
Homebrewを使用 (macOS / Linux) 
brew install sst/tap/opencode
Paruを使用 (Arch Linux) 
paru -S opencode-bin
Windows 
# Chocolateyを使用
choco install opencode

# WinGetを使用
winget install opencode

# Scoopを使用
scoop bucket add extras
scoop install extras/opencode

# NPMを使用 (Node.jsと管理者権限が必要)
npm install -g opencode-ai
  1. OpenCodeの起動とログイン
インストール後、以下の手順でログインし、OpenCodeを設定します。

​
ステップ 1. ログイン

ターミナルで以下のコマンドを実行します： 
opencode auth login

​
ステップ 2. AIプロバイダーの選択

ログインインターフェースで、モデルプロバイダーとしてAiHubMixを選択します。 図片

​
ステップ 3. APIキーで認証

AiHubMixアカウントにログインしてAPIキーを取得します。OpenCodeのログイン画面でそれを入力して認証を完了します。 図片 図片
  1. インストールの確認
OpenCodeが正常にインストールされ設定されたことを確認するには、以下を実行します： 
opencode
図片 コンソールが有効なモデル応答を返す場合、セットアップは完了です。 図片

​
カスタム Base URL

デフォルトでは、OpenCode は AIHubMix へのリクエストを https://aihubmix.com/v1 に送信します。リクエストを自前のゲートウェイ、企業プロキシ、またはアクセラレーションノード経由にしたい場合は、options.baseURL で上書きできます。OpenCode のソースコードを変更したり、再インストールしたりする必要はありません。

​
ステップ 1：設定ファイルを開く

~/.config/opencode/opencode.json（Windows の場合は %USERPROFILE%\.config\opencode\opencode.json）を開きます。

​
ステップ 2：options.baseURL を追加する

aihubmix プロバイダーの下に options.baseURL を追加します。このフィールドを書くだけで、OpenCode が組み込みの設定と自動的に深くマージしてくれるため、プロバイダー全体を書き直す必要はありません： 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihubmix": {
      "options": {
        "baseURL": "https://api.inferera.com"
      }
    }
  }
}
注意：baseURL にはドメインレベル（例：https://api.inferera.com）まで記入するだけで十分です。/v1 などのパスは SDK が自動的に付加します。自分で /v1 を追加しないでください（例：https://api.inferera.com/v1）。そうしないと /v1/v1/ のように連結されてしまい、404 になります。

​
ステップ 3：再起動して確認する

OpenCode を完全に終了してから再起動します。以下のコマンドを実行して確認してください： 
opencode debug config
出力された provider.aihubmix.options.baseURL に、記入したアドレスが表示されていれば成功です。
  1. 問題とヒント
  • APIキーの検証が失敗した場合は、AiHubMixで再認証し、キーのステータスを確認してください。
  • アプリ内ヘルプの表示：opencode -> /help
  • 公式ドキュメント：https://opencode.ai/docs/
最終更新日：2026-06-01