OpenWork

1. はじめに

OpenWorkは、75以上のモデルとローカルデプロイに対応したオープンソースのAIコーディングアシスタントです。MixRouteを通じて、OpenWorkでGPT、Claude、GLMなど、幅広い主要モデルや最先端モデルを利用でき、カスタムプロバイダーとモデルの設定にも完全に対応しています。 ダウンロード：https://openworklabs.com/

2. クイックセットアップ（MixRoute）

2.1 APIキーの取得

Mixroute APIコンソールでAPIキーを作成し、コピーします。

2.2 OpenWorkでカスタムプロバイダーを設定する

OpenWorkは、JSON設定ファイルによるカスタムプロバイダーの追加をサポートします。グローバルではなくワークスペース単位で設定することをおすすめします。

設定ファイルの場所を確認する

OpenWorkのワークスペース内で、設定ファイルを作成または編集してください。/path-to-your-workspace/.config/opencode/opencode.json

グローバルな場所~/.config/opencode/opencode.jsonにカスタムプロバイダーを追加することは推奨されません。OpenWorkはワークスペース単位の設定を優先するため、グローバル設定は上書きされ、無視されます。

プロバイダーを追加する

連携方法に応じて、対応するプロバイダー設定を追加してください。

OpenAI互換形式（標準モデルに推奨）

Chat Completionsに対応するモデルには、@ai-sdk/openai-compatibleを使用してください。

{
  "$schema": "https://opencode.ai/config.json",
  "disabled_providers": [],
  "provider": {
    "mixroute-compatible": {
      "name": "mixroute-compatible",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.mixroute.ai/v1",
        "apiKey": "{env:MIXROUTE_API_KEY}"
      },
      "models": {
        "glm-5.3": {
          "name": "glm-5.3"
        }
      }
    }
  }
}

@ai-sdk/openai-compatibleを使用すると、Chat Completionsプロトコルに対応する大半のモデルをカバーする、最も幅広い互換性が得られます。

Responses API（GPT-5.x Codexおよび同様のモデル）

一部のモデルにはResponses APIプロトコルが必要です。これらには@ai-sdk/openaiを使用してください。

{
  "mixroute-responses": {
    "name": "MixRoute OpenAI Responses",
    "npm": "@ai-sdk/openai",
    "options": {
      "baseURL": "https://api.mixroute.ai/v1",
      "apiKey": "{env:MIXROUTE_API_KEY}"
    },
    "models": {
      "gpt-5.6-luna": {
        "name": "gpt-5.6-luna"
      },
      "gpt-5.6-terra": {
        "name": "gpt-5.6-terra"
      },
      "gpt-5.6-sol": {
        "name": "gpt-5.6-sol"
      }
    }
  }
}

Responses APIが必要なモデルについては、セクション3を参照してください。

Anthropic Messages API（Claudeモデル）

Claudeモデルは@ai-sdk/anthropic経由で接続します。

{
  "mixroute-messages": {
    "name": "MixRoute Anthropic messages",
    "npm": "@ai-sdk/anthropic",
    "options": {
      "baseURL": "https://api.mixroute.ai/v1",
      "apiKey": "{env:MIXROUTE_API_KEY}"
    },
    "models": {
      "claude-sonnet-5": {
        "name": "claude-sonnet-5"
      }
    }
  }
}

保存して使用する

設定ファイルを保存し、OpenWorkを再起動してください。設定したプロバイダーとモデルがモデル選択リストに表示されます。

完全な設定例（すべてのプロバイダーを統合）:

{
  "$schema": "https://opencode.ai/config.json",
  "disabled_providers": [],
  "provider": {
    "mixroute-responses": {
      "name": "MixRoute OpenAI Responses",
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://api.mixroute.ai/v1",
        "apiKey": "{env:MIXROUTE_API_KEY}"
      },
      "models": {
        "gpt-5.6-luna": {
          "name": "gpt-5.6-luna"
        },
        "gpt-5.6-terra": {
          "name": "gpt-5.6-terra"
        },
        "gpt-5.6-sol": {
          "name": "gpt-5.6-sol"
        }
      }
    },
    "mixroute-messages": {
      "name": "MixRoute Anthropic messages",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.mixroute.ai/v1",
        "apiKey": "{env:MIXROUTE_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "claude-sonnet-5"
        }
      }
    },
    "mixroute-compatible": {
      "name": "mixroute-compatible",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.mixroute.ai/v1",
        "apiKey": "{env:MIXROUTE_API_KEY}"
      },
      "models": {
        "glm-5.3": {
          "name": "glm-5.3"
        }
      }
    }
  }
}

2.3 モデルの切り替え

設定が完了すると、会話画面または設定からプロバイダーとモデル（例：mixroute-responses/gpt-5.6-luna）を選択できます。

APIキーを設定ファイルに平文で記述するのではなく、MIXROUTE_API_KEY環境変数を通じて渡すことを推奨します。
セルフホストまたは別のサービスを使用する場合は、base URLを対応するアドレス（例：http://your-server:3003/v1）に変更してください。

2.4 OpenWorkを起動して会話を開始

設定後にOpenWorkを起動すると、モデル選択リストに追加したモデルが表示されます。

3. 一部のモデルにはResponses APIが必要（重要）

一部のモデルは、標準のChat Completionsとは異なるAPIインターフェースを使用し、Responses APIを必要とします。OpenWorkでそのようなモデルを選択した際に、次のようなエラーが発生する場合：

指定されたモデルではchatCompletion操作を使用できません。別のモデルを選択して、もう一度お試しください。

これは、リクエストがChat Completions経由で送信されている一方、サーバー側のモデルはResponses APIのみをサポートしていることを意味します。正しいインターフェースを使用するように設定する必要があります。

3.1 Responses APIが必要なモデル（代表例）

モデルID / シリーズ	説明
gpt-5.6-luna	GPT-5.6 Luna、Responses APIのみ
gpt-5.6-terra	GPT-5.6 Terra、Responses APIのみ
gpt-5.6-sol	GPT-5.6 Sol、Responses APIのみ

3.2 OpenWorkでの設定方法

設定ファイルに@ai-sdk/openaiを使って別のプロバイダーを追加し、OpenWorkがこれらのモデルにResponses APIを使用するようにします。具体的な設定については、ステップ2のResponses APIの節を参照してください。opencode.jsonファイルにmixroute-responsesプロバイダーを追加します。

3.3 まとめ

シナリオ	方法
gpt-5.6-luna / gpt-5.6-terra / gpt-5.6-sol（Responsesモデル）を使用	`opencode.json`に、Responses APIを使用する別のプロバイダーを追加します。
glm-5.3、claude-sonnet-5を使用（標準モデル）	通常どおり`@ai-sdk/openai-compatible`または`@ai-sdk/anthropic`を使用

4. 参考リンク

OpenWorkのウェブサイトとダウンロード: https://openworklabs.com/
OpenCodeの設定とモデル：モデル、プロバイダー
MixRouteコンソール: https://api.mixroute.ai/

対話型AI

プログラミング

エンジニアリング

翻訳

1. はじめに

2. クイックセットアップ（MixRoute）

2.1 APIキーの取得

2.2 OpenWorkでカスタムプロバイダーを設定する

2.3 モデルの切り替え

2.4 OpenWorkを起動して会話を開始

3. 一部のモデルにはResponses APIが必要（重要）

3.1 Responses APIが必要なモデル（代表例）

3.2 OpenWorkでの設定方法

3.3 まとめ

4. 参考リンク

​1. はじめに

​2. クイックセットアップ（MixRoute）

​2.1 APIキーの取得

​2.2 OpenWorkでカスタムプロバイダーを設定する

​2.3 モデルの切り替え

​2.4 OpenWorkを起動して会話を開始

​3. 一部のモデルにはResponses APIが必要（重要）

​3.1 Responses APIが必要なモデル（代表例）

​3.2 OpenWorkでの設定方法

​3.3 まとめ

​4. 参考リンク

1. はじめに

2. クイックセットアップ（MixRoute）

2.1 APIキーの取得

2.2 OpenWorkでカスタムプロバイダーを設定する

2.3 モデルの切り替え

2.4 OpenWorkを起動して会話を開始

3. 一部のモデルにはResponses APIが必要（重要）

3.1 Responses APIが必要なモデル（代表例）

3.2 OpenWorkでの設定方法

3.3 まとめ

4. 参考リンク