OpenCode GUI クライアントは OpenAI 互換の chat/completions プロトコルを使用します。カスタムプロバイダーを 4AICode に向けると、gpt-6-astra、gpt-5.6-sol、gpt-5.5、gpt-5.4、gpt-5.4-mini、gpt-5.3-codex などを OpenCode で利用できます。

前提条件

4AICode トークン：ダッシュボード → トークン管理で作成。形式は sk-4ai-...
プロバイダー ID：4aicode
Base URL：https://relay.4aicode.com/v1
デフォルトモデル：gpt-5.4
コードモデル：gpt-5.3-codex

GUI クライアント設定

左下の歯車設定を開き、Provider / Models 設定ページで OpenAI 互換または Custom プロバイダーを追加します。

界面フィールドは次のとおり入力します。

フィールド	値
Provider / Type	`OpenAI Compatible` または `Custom`
Name / Display name	`4AICode`
Provider ID	`4aicode`
Base URL / API Base URL	`https://relay.4aicode.com/v1`
API Key	`sk-4ai-xxxxxxxxxxxxxxxx`
Model ID	`gpt-5.4`
Small model ID	`gpt-5.4-mini`
Timeout / Request timeout	`600000` ms または `600` s
Chunk timeout / Stream timeout	`120000` ms または `120` s

保存後、メイン画面に戻り、下部のモデルピッカーで次を選択します。

4AICode / GPT-5.4

新しい会話を作成し、送信：

Hello

正常に応答すれば GUI 設定は完了です。

GUI に表示されるタイムアウトエラー

次のようなエラーが出た場合、GUI のタイムアウトフィールドを重点的に確認してください。

Provider response headers timed out after 10000ms

OpenCode GUI がプロバイダー応答ヘッダーの待機中にタイムアウトしたことを意味します。Codex 上流の最初の応答チャンクが 10 秒を超えることがあるため、GUI の詳細設定でタイムアウト値を増やしてください。

フィールド	推奨値
Request timeout / Timeout	`600000` ms
Chunk timeout / Stream timeout	`120000` ms

GUI 版にタイムアウト入力欄がない場合は、以下の opencode.json 方式で追加してください。

設定ファイル方式

GUI でタイムアウトを直接入力できない版向け。作成または編集：

~/.config/opencode/opencode.json

追加：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "4aicode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "4AICode",
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "apiKey": "sk-4ai-xxxxxxxxxxxxxxxx",
        "timeout": 600000,
        "chunkTimeout": 120000
      },
      "models": {
        "gpt-6-astra": {
          "name": "GPT-6 Astra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini"
        },
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex"
        }
      }
    }
  },
  "model": "4aicode/gpt-5.4",
  "small_model": "4aicode/gpt-5.4-mini"
}

OpenCode GUI を再起動後、モデルピッカーで 4AICode / GPT-5.4 を選択します。

対話的に認証情報を追加

プロジェクトディレクトリに入り OpenCode を起動：

opencode

OpenCode 内で実行：

/connect

プロンプトに従い選択・入力：

Provider: Other
Provider ID: 4aicode
API key: sk-4ai-xxxxxxxxxxxxxxxx

プロジェクトルートに opencode.json を作成または編集し、上記「設定ファイル方式」の内容を参考にしてください。

OpenCode に戻り実行：

/models

4AICode 配下のモデルを選択します。

環境変数方式

トークンを環境変数に保存。チームで opencode.json を共有する場合に適しています。

export FOURAICODE_API_KEY="sk-4ai-xxxxxxxxxxxxxxxx"

opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "4aicode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "4AICode",
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "apiKey": "{env:FOURAICODE_API_KEY}",
        "timeout": 600000,
        "chunkTimeout": 120000
      },
      "models": {
        "gpt-6-astra": {
          "name": "GPT-6 Astra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.4-mini": {
          "name": "GPT-5.4 Mini"
        },
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex"
        }
      }
    }
  },
  "model": "4aicode/gpt-5.4",
  "small_model": "4aicode/gpt-5.4-mini"
}

グローバル設定パス

ユーザーレベル設定：

~/.config/opencode/opencode.json

プロジェクトレベル設定はプロジェクトルート：

opencode.json

プロジェクトレベル設定が優先され、特定リポジトリ用にプロバイダーとモデルを固定するのに適しています。

利用可能なモデル

モデル	OpenCode モデル形式	用途
`gpt-6-astra`	`4aicode/gpt-6-astra`	新世代フラッグシップ；公式価格の 15% で課金
`gpt-5.6-sol`	`4aicode/gpt-5.6-sol`	複雑なコーディング、長時間タスク、複数ファイルリファクタ向けフラッグシップ
`gpt-5.6-terra`	`4aicode/gpt-5.6-terra`	コスパに優れたバランス型
`gpt-5.6-luna`	`4aicode/gpt-5.6-luna`	軽量タスク；より安く速い
`gpt-5.5`	`4aicode/gpt-5.5`	前世代フラッグシップ
`gpt-5.4`	`4aicode/gpt-5.4`	推奨デフォルト；一般タスクでより安定
`gpt-5.4-mini`	`4aicode/gpt-5.4-mini`	軽量タスク、迅速な検証、コスト重視
`gpt-5.3-codex`	`4aicode/gpt-5.3-codex`	コード最適化と Codex 系タスク

モデルフィールドには 4aicode/gpt-5.3-codex など OpenCode 完全形式を使用してください。界面表示名は GPT-5.3 Codex で構いません。

FAQ

Provider response headers timed out after 10000ms

OpenCode GUI がプロバイダー応答ヘッダー待機中にタイムアウトしたことを意味します。Codex 上流の最初の応答チャンクが 10 秒を超えることがあります。設定で timeout と chunkTimeout を増やしてください。

{
  "provider": {
    "4aicode": {
      "options": {
        "baseURL": "https://relay.4aicode.com/v1",
        "timeout": 600000,
        "chunkTimeout": 120000
      }
    }
  }
}

gpt-5.4-mini で Hello を送り接続を確認した後、gpt-5.4 または gpt-5.3-codex に戻してください。

401 Unauthorized

APIキーが期限切れまたはコピーミス。ダッシュボード → トークン管理で新しいトークンを作成し、/connect の認証情報または環境変数を更新してください。

400 Model Not Supported

表のリテラルモデル ID を使用。一般的な選択は 4aicode/gpt-5.4 と 4aicode/gpt-5.3-codex です。

設定後にモデル一覧が表示されない

次の 3 点を確認：

/connect で入力した Provider ID が 4aicode
opencode.json のプロバイダーキーが "4aicode"
model が 4aicode/gpt-5.4 など完全形式

OpenCode 設定