> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCodeでAiHubMixを使用する

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
```

***

2. OpenCodeの起動とログイン

インストール後、以下の手順でログインし、OpenCodeを設定します。

### ステップ 1. ログイン

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

```
opencode auth login
```

***

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

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

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc1.png" alt="図片" />

***

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

AiHubMixアカウントにログインしてAPIキーを取得します。OpenCodeのログイン画面でそれを入力して認証を完了します。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc2.png" alt="図片" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc3.png" alt="図片" />

***

3. インストールの確認

OpenCodeが正常にインストールされ設定されたことを確認するには、以下を実行します：

```
opencode
```

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc4.png" alt="図片" />

コンソールが有効なモデル応答を返す場合、セットアップは完了です。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc5.png" alt="図片" />

***

<h2 id="custom-base-url">
  カスタム Base URL
</h2>

デフォルトでは、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 が組み込みの設定と自動的に深くマージしてくれるため、プロバイダー全体を書き直す必要はありません：

```json theme={null}
{
  "$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 を完全に終了してから再起動します。以下のコマンドを実行して確認してください：

```bash theme={null}
opencode debug config
```

出力された `provider.aihubmix.options.baseURL` に、記入したアドレスが表示されていれば成功です。

***

4. 問題とヒント

* APIキーの検証が失敗した場合は、AiHubMixで再認証し、キーのステータスを確認してください。
* アプリ内ヘルプの表示：`opencode` -> `/help`
* 公式ドキュメント：[https://opencode.ai/docs/](https://opencode.ai/docs/)

***

最終更新日：2026-06-01