AionUi 接続

難易度 🧩 中級　|　インターフェース形式 OpenAI 互換　|　base_url https://byesu.com/v1

接続情報 · これらを入力

API アドレスhttps://byesu.com/v1

API キーsk-xxxxxxxxコンソールで作成 →

モデルgpt-5.5

API 形式 OpenAI 互換 · モデル名はコンソールに準拠

AionUi は無料・ローカル・オープンソースの Cowork デスクトップアプリで、グラフィカルなインターフェースとリモート WebUI を備え、Gemini CLI、Claude Code、Codex など複数の AI エージェントを同時に実行できます。これに Byesu API のモデルを設定すれば、ひとつの画面で gpt-5.5、claude-opus-4-8、gemini-3.1-pro-high などのモデルを使って協調的に作業できます。

始める前に

まずコンソール → トークンで API トークン（sk-xxxx のような形式）を作成してください。

作成時には必ず正しいグループを選んでください——グループによって、呼び出せるモデルや課金される価格が決まります。どれを選べばよいか分からない場合はグループの選択をご覧ください。

ステップ 1：AionUi のダウンロードとインストール

GitHub Releases ページにアクセスし、お使いのシステムに対応したインストーラーをダウンロードしてください：

ダウンロード先：https://github.com/iOfficeAI/AionUi/releases
Windows は .exe、macOS は .dmg、Linux は .AppImage を選びます。

ダウンロード後、ダブルクリックしてインストールし、AionUi を開きます。

ステップ 2：Byesu API モデルの追加

AionUi は統一されたモデル設定で OpenAI 互換サービスに接続でき、Byesu API もこの種類に該当します。

AionUi を開き、設定（Settings） ページに入ります。
モデル設定（Model Configuration） タブに切り替えます。
モデルを追加（Add Model） をクリックします。
プロバイダーの種類として NewAPI（または OpenAI 互換 / Custom）を選びます。
下表のとおり入力します：

項目	入力内容
API アドレス（API Address / base_url）	`https://byesu.com/v1`
API キー（API Key）	あなたのトークン `sk-xxxx`
モデル（Model）	下記のおすすめを参照
リクエストプロトコル（Request Protocol）	OpenAI（互換）を選択。claude / gemini 系モデルを追加した後にプロトコルや形式のエラーが出る場合は、モデルに合わせて対応するプロトコルへ手動で切り替えてください

base_url の末尾には /v1 を付けること

OpenAI 互換形式では必ず https://byesu.com/v1 と入力してください。/v1 を省略したり、末尾にスラッシュや /chat/completions を余分に付けたりしないでください。

キーを入力したら、モデルのドロップダウンから使いたいモデルを選択します。リストが空の場合は、手動でモデル名を入力できます。よく使うモデル：

用途	モデル名
汎用対話 / 文章作成	`gpt-5.5`
コーディング / 長コンテキスト推論	`claude-opus-4-8`
マルチモーダル / 超大容量コンテキスト	`gemini-3.1-pro-high`

設定を保存します。

ステップ 3：（任意）Claude Code エージェントの設定

AionUi では各 AI エージェントを個別に設定できます。そのうち Claude Code エージェントは Anthropic ネイティブインターフェースを利用するため、base_url が OpenAI 互換とは異なります——/v1 を付けません：

Claude Code エージェント設定同等の環境変数

text

Base URL:  https://byesu.com
API Key:   sk-xxxx
Model:     claude-opus-4-8

bash

ANTHROPIC_BASE_URL=https://byesu.com
ANTHROPIC_AUTH_TOKEN=sk-xxxx
ANTHROPIC_MODEL=claude-opus-4-8

Gemini CLI、Codex などその他のエージェントも同様で、それぞれの設定に対応する base_url（OpenAI 互換は https://byesu.com/v1）、キー、モデルを入力すれば大丈夫です。

ステップ 4：動かして確認する

チャット画面に戻り、上部のモデル選択箇所で先ほど設定したモデル（例：gpt-5.5）を選び、「こんにちは、一言で自己紹介してください」と送信します。

正常に返信が受け取れれば、接続成功です。Claude Code エージェントを使った場合は、ファイルを 1 つ読ませたり、簡単なタスクを実行させたりして、エージェントが正しく動作することを確認できます。

うまくいかないときは？

401 / 無効なトークン：API キーが完全に貼り付けられているか、余分なスペースがないかを確認してください。Byesu コンソールで作成した sk-xxxx を使っていることを確認しましょう。詳しくはよくあるエラー #auth をご覧ください。
利用可能なチャンネルがない / モデルが存在しないと表示される：多くの場合、トークンのグループが正しく選ばれていないか、入力したモデル名を現在のグループがサポートしていません。別のグループに変えるか、モデル名を変えてみてください。グループの選択とよくあるエラー #no-channel を参照してください。
残高不足：アカウントの利用枠を使い切ると拒否されます。まずチャージするか、グループを変更してください。よくあるエラー #balance をご覧ください。
接続できない / 404：OpenAI 互換では https://byesu.com/v1、Claude Code エージェントでは https://byesu.com（/v1 を付けない）と入力していることを確認してください。

その他のトラブルシューティングはよくあるエラーをご覧ください。

AionUi 接続 ​

ステップ 1：AionUi のダウンロードとインストール ​

ステップ 2：Byesu API モデルの追加 ​

ステップ 3：（任意）Claude Code エージェントの設定 ​

ステップ 4：動かして確認する ​