1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

AIHubMix Desktop 1.0 で 11本のコーディングエージェントの設定と API キーを 1か所にまとめる

1
Last updated at Posted at 2026-10-29

本記事は AIHubMix が作成しました。公開日は 2026年10月29日で、価格とプロモーションの情報は同日時点のものです。DeepSeek V4.1 Flash 1017 の半額プロモーションは 2026年11月12日まで続きます。

TL;DR

  • AIHubMix Desktop 1.0.0 は、macOS 12 以降と Windows 向けの「設定レイヤー」です。会話用のチャット画面はありません。
  • すでにインストール済みのコーディングエージェントを検出し、必要な設定を書き込みます。認証情報は macOS のキーチェーンか Windows の資格情報マネージャーに置かれます。
  • 1つのキーで 700 以上のモデルをカバーします。
  • 起動時点で 11本のエージェントを検出します。その中には Claude Code、Claude Desktop、Codex(CLI とデスクトップアプリはまとめて管理)、Gemini CLI、OpenCode、MiniMax Code、OpenClaw、Hermes、Pi などが含まれます。
  • 起動プロモーションとして、DeepSeek V4.1 Flash 1017 が 2週間 50% オフです。オフピークの入力が 100万トークンあたり $0.0775、出力が $0.31 になります。
  • つまずきやすいのは接続そのものより、設定を読み直させる再起動と、シェルプロファイルに残った export です。

なぜ「設定レイヤー」が必要になるのか

1本のコーディングエージェントをゲートウェイに向けるのは、10分ほどの編集作業です。ところが 4本を同じゲートウェイに向け、2回のバージョンアップをまたいでその状態を保つのは、誰も予定に組み込まない保守作業になります。しかも失敗は静かに起きます。エージェントは答え続けますが、意図していないプロバイダーから返し、意図していないアカウントに課金されます。あるいはキーが、あとからコミットされるファイルに貼り付けられたままになります。

AIHubMix Desktop 1.0.0 は、その隙間を埋めるために macOS 12 以降と Windows 向けに公開されました。マシン上にあるコーディングエージェントをスキャンし、それぞれに必要な設定を書き、反映前にすべての変更を見せ、認証情報を OS のキーチェーンに保管し、切断時には自分が書いたものだけを消します。チャットクライアントではありません。すでに動かしているエージェントのための設定レイヤーで、1つのキーが 700 以上のモデルをカバーします。

動作環境と前提

  • macOS 12 以降、または Windows。Mac 向けの 2つのビルドは署名と公証が済んでいます。Windows のインストーラはまだ Authenticode 署名がないため、SmartScreen が発行元の確認を求めることがあり、セットアップ中に WebView2 ランタイムがインターネット接続を必要とする場合があります。
  • AIHubMix アカウント。アプリは設定対象のエージェント用にクライアントキーを保持します。キーが失効したり漏れたりした場合は、再発行してアプリから接続済みのエージェントに書き直せます。
  • 接続したいエージェントがインストール済みであること。ディスク上にないものは設定できません。また Codex CLI と Codex Desktop 内の CLI は、モデルリストを共有できる程度にバージョンが近い必要があります。

導入手順

  1. 最新リリースから、利用するプラットフォームのインストーラをダウンロードします。
  2. AIHubMix アカウントでサインインします。
  3. 接続するエージェントを選び、接続を実行します。書き込まれるのは接続に必要な項目だけです。
  4. 確定します。アプリはゲートウェイに必要な項目(エンドポイント、モデルリスト、認証情報)だけを書き、各ファイルの残りはそのままにします。
  5. 設定をキャッシュしているプロセスを再起動します。次の節で触れますが、「アプリを再起動すれば十分」とは限りません。

手作業での設定も引き続き可能で、アプリはまさにその設定のショートカットです。Claude Code、Codex、Gemini CLI には、同じ編集内容を書き下したドキュメントページがあります。

アプリはマシンに何をするのか

スキャン。 起動すると、対応しているエージェントを探し、それぞれのバージョンとインストールパスを表示し、そのインストールが使用可能かどうかを示します。提示されるのは見つかったものだけです。インストールされていないエージェントは一覧に出てきません。

接続。 エージェントに必要なエンドポイント、モデルリスト、認証情報を書きます。設定したモデルごとに小さなテストリクエストを1回ずつ送り(課金されます)、リクエストが本当にゲートウェイに届いたかを確認します。HTTP 200 でも、相手が別のプロバイダーなら検証済みとはみなしません。

切り替え。 モデル、デフォルトモデル、reasoning effort、承認モードは、ファイルではなくアプリから設定します。reasoning のレベルはモデルごとに絞り込まれ、そのモデルが宣言しているレベルのみが提示されます。全モデルの一覧はモデルページにあります。Codex CLI と Codex Desktop は別々のファイルを読みますが、一覧ではまとめて扱われるため、片方を他方と同じモデルに向けられます。

切断。 消えるのはアプリ自身が書いたものだけです。ファイルへのあなたの編集は残り、以前の設定が戻ります。置き換えた内容を記録しているので、記憶からの復元手順はありません。

内部では、2つの接続方式が動いています。プロバイダーエントリを丸ごと受け取るタイプは、モデルリストとデフォルトを 1か所に置きます。単一のエンドポイントとキーを受け取るタイプは、モデルをツール側で選びます。アプリはエージェントごとにこの 2つを分けて扱うので、1本を接続しても他の設定は書き換わりません。2つのツールが同じファイルを共有している場合は、変更は 1回だけ表示され、両方に適用されます。

キーはホームディレクトリの平文ファイルではなく、macOS のキーチェーンか Windows の資格情報マネージャーに入ります。手作業の設定が最も間違えやすいのがここで、一番楽な道はシェルプロファイルの export ANTHROPIC_AUTH_TOKEN=... だからです。

接続チェックが証明すること、しないこと

検証はテストリクエストで、リクエストがゲートウェイに届いたこと、つまりプロバイダーの同一性を確かめるものです。レイテンシ、スループット、負荷時の挙動は報告しませんし、本記事もその 3つについて実測値を出しません。緑のチェックは「配線が正しい」と読むもので、「エージェントが速い」ではありません。

アプリの制御外に残ることも 2つあります。すでに設定を読み込んだ稼働中のエージェントがその設定で何をするかと、ロックダウンされたマシンがそもそもファイル書き込みを許すかどうかです。

ハマりどころ

多くのツールは起動時に設定を読むため、接続の成功は、読み手が再起動するまで切り替えの成功ではありません。症状別に分けます。

接続したのにエージェントが古いモデルを使い続ける

設定は起動時に読まれます。ツールを完全に終了して開き直してください。Claude Desktop はウィンドウを閉じるだけでは足りず、完全に終了する必要があります。

新しいターミナルで Codex が新しいエンドポイントを無視する

Codex のバックグラウンドサービスが独自に設定のコピーを保持しています。新しいターミナルセッションを開く前に、サービスを再起動します。

terminal
# Codex のバックグラウンドサービスは独自のコピーを持つ。新しいターミナルセッションの前に再起動する
codex app-server daemon restart

接続は成功したのに通信が想定外の宛先へ流れる

原因は、このセッションで書いた覚えのないコマンドです。シェルプロファイルの export が、アプリが書いた設定ファイルより優先されます。ターミナルが勝ちます。

terminal
# ~/.zshrc か ~/.bashrc に書かれている場合、アプリが書く設定ファイルより優先される
export ANTHROPIC_AUTH_TOKEN=...

アプリは黙って負けるのではなく、競合として警告します。対処はプロファイルから export を消すことです。

Windows のインストーラが SmartScreen で止まる

Windows のインストーラはまだ Authenticode 署名がありません。発行元を確認して続行してください。macOS のビルドは公証済みなので、この問題は起きません。

セットアップが WebView2 ランタイムで止まる

セットアップ中に WebView2 ランタイムがインターネット接続を必要とする場合があります。セットアップにネットワーク接続を与えてください。

開いているセッションだけが新しいデフォルトを無視する

モデルや reasoning レベルは、それを選んだセッションに残ります。新しいセッションを開始してください。新しいセッションが新しいデフォルトを引き継ぎます。

Reasoning のメニューに、モデルが持たないレベルが並ぶ

Hermes 自身のメニューはモデルごとに reasoning レベルを絞り込めません。アプリが提示するレベルを使ってください。

Codex CLI と Codex Desktop が接続を拒否する

両者の CLI のバージョンが離れすぎていて、モデルリストを共有できません。バージョンを近づけてください。アプリは、古い側が読めないリストを書くのではなく、書き込み自体をブロックします。

管理されたマシンで何も書き込まれない

設定ファイルが読み取り専用か、管理者所有です。アプリはその旨を報告し、ファイルには手を付けません。所有権は自分で直してください。

起動プロモーション:DeepSeek V4.1 Flash 1017 が 2週間半額

公開を記念して、DeepSeek V4.1 Flash 1017 が 2週間 50% オフです。2026年11月12日まで続きます。キャッシュ読み取りを含め、両方の価格帯が半額になります。

100万トークンあたり 通常価格 起動プロモーション
入力(オフピーク) $0.155 $0.0775
出力(オフピーク) $0.62 $0.31
キャッシュ入力(オフピーク) $0.0031 $0.00155
入力(ピーク) $0.3098 $0.1549
出力(ピーク) $1.2392 $0.6196

ピーク時間は UTC の 01:00–04:00 と 06:00–10:00 で、それ以外はオフピークです。同じモデル、同じエンドポイントで、deepseek-v4.1-flash-1017 は 100万トークンのコンテキスト、最大 393K の出力トークン、画像入力、ツール呼び出し、プロンプトキャッシュに対応します。

参考までに、DeepSeek 自身の通常価格はオフピークで入力が 100万トークンあたり $0.15、出力が $0.60 で、ピーク時は倍になります。プロモーション期間中、ゲートウェイの入力単価は DeepSeek のオフピーク単価のおよそ半分です。

たくさん読み込むエージェントを向ける先として、このプロモーションは妥当です。そこで、キャッシュを多く使う例を出します。コーディングエージェントを集中的に使う 1日で、入力が 2000万トークン、うち 1800万トークンがキャッシュから供給され、出力が 200万トークンという想定です。

項目 通常価格で プロモーション価格で
未キャッシュ入力 200万 $0.31 $0.155
キャッシュ入力 1800万 $0.0558 $0.0279
出力 200万 $1.24 $0.62
合計 約 $1.61 約 $0.80

これは上の単価に、先ほどのトークン数を掛けたものです。実際の内訳は変わります。プロモーション単価は、2026年11月12日までそのモデル ID へのリクエストに自動で適用されます。コードもクーポンも不要で、期間が終われば通常価格に戻ります。

まとめ

  • AIHubMix Desktop 1.0.0 は、チャットクライアントではなく、インストール済みエージェントの設定をまとめるレイヤーです。
  • 検出、接続、切り替え、切断がアプリ内で完結し、切断時に消えるのはアプリが書いたものだけです。
  • 認証情報は OS のキーチェーンに入るため、平文ファイルやシェルプロファイルの export に頼らずに済みます。
  • つまずきやすいのは、再起動の不足とシェルプロファイルの export です。症状から原因を引けるようにしておくと切り分けが速くなります。
  • アプリ自体は無料で、エージェントのリクエストは通常のトークン単価で AIHubMix の残高に課金されます。残高と当日の利用額はアプリ内で確認できます。
  • DeepSeek V4.1 Flash 1017 は 2026年11月12日まで半額で、リクエストに自動適用されます。

AIHubMix Desktop をダウンロードして、すでに動かしているエージェントを接続し、半額の期間中に最も多く読み込むエージェントを DeepSeek V4.1 Flash 1017 に向けてください。

参考

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?