> ## 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.

# よくある質問とトラブルシューティング

> サインイン、支払い、セッションのエラー、あなたのデバイス上での実行、クラウドサーバー、モデルソース、プロジェクト、通知、アップデートに関するよくある問題と、その原因と対処法をまとめています。

このページでは、よくある質問とエラーをトピックごとにまとめています。基本的に、入力した内容、完了した手順、ファイルは失われず、自動で復旧できるものは自動で復旧します。問題が起きると、通常は入力欄の上にエラーが表示されます。**Details** をクリックすると元のエラーを確認でき、**Copy details** をクリックするとサポートへの問い合わせ時に添付できます。

## サインインとアカウント

### サインインがキャンセルされた、タイムアウトした、またはサインインのリクエストの有効期限が切れたと表示される

ブラウザーで認可をキャンセルしたか、待ち時間が長すぎたか、サインインのリンクがすでに使用済みです。もう一度 **Continue with AIHubMix** をクリックしてください。

### サインインサービスを利用できない、またはサインインに失敗したと表示される

AIHubMix のサインインサービスに一時的な問題が発生しています。しばらくしてからもう一度お試しください。

### アカウントが停止されていると表示される

この AIHubMix アカウントでは Cloud Agent にサインインできません。アカウントの問題は AIHubMix で解決してください。

### デスクトップアプリで、このデバイスが削除されたと表示される

このコンピューターはマシン一覧から削除されています。もう一度サインインすると再び追加されます。

### アプリの使用中にサインインの有効期限が切れたと表示される

**Sign in** をクリックしてください。チャットと下書きは保持されます。

### パスワードを変更またはリセットするには?

パスワードは AIHubMix アカウントに属します。Cloud Agent にはパスワードを変更またはリセットする項目はありません。AIHubMix のアカウント設定またはサインインページで行ってください。

### デスクトップアプリと Web アプリで別々のアカウントが必要ですか?

いいえ。どちらも同じ AIHubMix アカウントを使い、同じプロジェクト、セッション、Plus のサブスクリプションが表示されます。

## Plus と支払い

### 支払いが完了しなかった、または途中でやめた

料金は請求されません。サブスクリプションのウィンドウに戻り、**Resubscribe** をクリックしてください。

### 支払ったのに、Plus がまだ有効になっていない

支払い結果がまだ届いていない可能性があります。結果が届くと Plus は自動的に有効になるため、**再度支払わないでください**。**Refresh** または **Retry** をクリックすると最新の状態を確認できます。Setting up と表示されている場合は、クラウドサーバーを準備中です。通常は数分かかります。

### このリージョンは売り切れと表示される

別のエグレスリージョンを選んでサブスクリプションを開始してください。すべてのリージョンが売り切れの場合は、現時点ではサブスクリプションを開始できません。しばらくしてからもう一度お試しください。

### 支払いに失敗したと表示される

自動更新の請求が通りませんでした。Cloud server ページで **Update payment method** をクリックし、表示されている日付までに修正してください。修正しないとクラウドサーバーは停止します。猶予期間中は引き続き使用できます。オンライン以外で支払ったサブスクリプションについては、サポートにお問い合わせください。

### 初月割引の後、毎月いくら支払いますか?

サブスクリプションのウィンドウに表示される更新価格が、2 か月目以降に毎月請求される金額です。更新はその価格のまま続きます。

### 更新をキャンセルした後も Plus を使えますか?

終了日まではすべて通常どおり使えます。終了日を過ぎると、クラウドサーバーはセッションとスケジュールタスクの実行を停止します。終了日より前であれば、Cloud server ページで **Resume renewal** をクリックできます。

### Plus なしで、自分のサブスクリプションや API キーでセッションを実行できますか?

いいえ。モデルソースにかかわらず、すべてのセッションの実行には Plus が必要です。

### Plus なしで送信したメッセージは失われますか?

いいえ。サブスクリプションを開始すると自動的に処理が始まります。Home で保留中の未送信メッセージが消えるのは、サインアウトした場合のみです。Web アプリでは、保留中のメッセージの添付ファイルを支払い後に復元できない場合、そのメッセージは自動では送信されないため、セッションから手動で送信する必要があります。

### カードを変更したり、請求書をダウンロードしたりするには?

Cloud server ページで **Payment & invoices** をクリックします。請求履歴とエクスポートした CSV ファイルは正式な請求書ではありません。[Plus プランと使用量](https://docs.aihubmix.com/jp/cloud/account/plus.md)を参照してください。

### Usage ページの支出と請求額が一致しないのはなぜですか? また、時刻が数時間ずれているのはなぜですか?

請求には Plus の注文のみが記録されます。Usage ページの支出はモデル呼び出しの推定値で、自分の API キーの料金はプロバイダーから別に請求されます。請求の日付は Asia/Shanghai タイムゾーン、使用量はお使いのコンピューターのローカルタイムゾーンを使います。

## セッションを開始する

### 新しいチャットのページが常にプロジェクトなしで始まるのはなぜですか?

新しいチャットのページは、前回選んだプロジェクトを記憶しません。サイドバーのプロジェクト行の **+**、またはプロジェクトページの **New task in this project** から始めると、そのプロジェクトが自動的に選択されます。

### 送信ボタンが使えない

通常は、添付ファイルがまだアップロード中または変換中であるか、アップロードに失敗しています。完了するまで待つか、失敗した添付ファイルを再試行または削除してください。

### 添付ファイルのアップロードが何度も失敗する

添付ファイルの再試行ボタンをクリックしてください。繰り返し失敗する場合は、ネットワークを確認するか、削除してからもう一度追加してください。ファイルが大きすぎると表示される場合は、圧縮または分割してから追加してください。

### スラッシュコマンドを選択できない

理由はコマンドの下に表示されます。多くの場合、そのコマンドは 1 台のデバイスにのみインストールされていて、現在のセッションはそのデバイスで実行されていません。

### 自分のコンピューターを選ぶと、Full access を選択できない

そのコンピューターの権限の上限が低く設定されています。そのコンピューターのデスクトップアプリで **Settings › Machines** を開き、権限の上限を引き上げてください。

### セッションの開始後に、モデル、実行場所、Harness を変更できますか?

モデル、ソース、推論レベルは、現在のタスクが終わった後に変更できます。実行場所と Harness はセッションの開始時に決まります。変更するには、新しいセッションを開始してください。[セッションを開始する](https://docs.aihubmix.com/jp/cloud/sessions/start-a-session.md)を参照してください。

### 新しいセッションがキューに入ったままになる

各プロジェクトで同時に実行できるセッションは最大 5 つです。それを超える場合や、クラウドサーバーの復旧中は、セッションはキューに入り、空きができると順番に自動で開始されます。キューに入っている間に送信したメッセージは、セッションの開始後に処理されます。

## 実行中のエラー

### メッセージが送信されなかった

メッセージには、内容が保持されていることが表示されます。**Retry** をクリックしてください。二重に送信されることはありません。

### 接続が切れて再接続中と表示される

サーバーとの接続が一時的に切れています。復旧すると、その間のメッセージは自動的に補完されるため、そのままお待ちください。接続が切れたためページの再読み込みを求められた場合は、ページを再読み込みしてください。

### ネットワークの切断、リクエストのタイムアウト、リクエストの過多、またはサービスを利用できないと表示される

**Retry** をクリックするか、しばらくお待ちください。アプリは自動的に再試行します。失敗が続く場合は、詳細をコピーしてサポートにお問い合わせください。

### 権限がないと表示される

現在のワークスペースで、この操作を行う権限がありません。ワークスペースの管理者にお問い合わせください。

### 「This chat is asleep and wakes when you send a message」と表示される

しばらくアクティビティのないセッションはスリープ状態になります。メッセージを送信すると再開します。

### セッションが一時停止していると表示される

サイドバーでは、そのセッションに対応が必要であることが示されます。表示された理由に応じて対処してください。

* モデルの利用上限に達した: このページのモデルとソースのセクションにある「サブスクリプションの利用上限に達した」を参照してください。
* サブスクリプションのアカウントの接続が切れた、または無効になった、あるいはキーが無効: 別のソースまたはモデルで続行してください。
* 回答待ちがタイムアウトした: メッセージを送信すると続行します。
* 設定待ち: 表示される案内に従って設定を完了してください。
* アカウントが無効化された: サポートにお問い合わせください。

### セッションが中断されました。すでに変更されたファイルは残っていますか?

はい。自分で停止した場合も、クラウドサーバーのアップグレードや停止の場合も、実行中のデバイスの接続が切れた場合も、完了した手順とファイルは保持されます。メッセージを送信すると続行します。

### Steer を選んだのに、メッセージがキューに入った

このセッションの Agent はタスクの途中でメッセージを受け取れないため、メッセージは自動的に Queue に切り替わり、現在のタスクの終了後に送信されます。Steer に対応しているのは Claude Code と Codex のみです。

### Stop をクリックすると、キューのメッセージはどうなりますか?

現在のウィンドウで Stop をクリックした場合、キューのメッセージは順番に送信され続けます。別のウィンドウやデバイスから停止した場合、キューは一時停止するため、**Send all** をクリックするか、各メッセージの **Send** をクリックする必要があります。

### Esc を押してもセッションが停止しない

メニューまたはダイアログが開いている場合、`Esc` はまずそれを閉じます。検索ボックスなど別の入力欄にフォーカスがある場合も、セッションは停止しません。メインの入力欄またはチャット領域にフォーカスを置いて、もう一度 `Esc` を押してください。

### 1 を押してもリクエストが承認されない

承認のショートカットは、フォーカスがテキスト入力欄やボタンにないときにのみ機能します。先にチャット領域の空いている場所をクリックしてから、キーを押してください。

### Agent のリクエストを折りたたんだら見つからなくなった

入力欄の上の **Needs your input** をクリックするか、セッション履歴のその項目にある **Respond** をクリックしてください。

### リクエストを拒否すると、セッションは失敗しますか?

必ずしもそうではありません。Agent は別の方法で完了しようとし、どうしても続行できない場合は返信で説明します。どうするかを指示するには、**Something else…** を選んで指示を書いてください。

### メッセージに編集ボタンがない

セッションの Agent が巻き戻しに対応していない場合、編集ボタンは表示されません。アーカイブ済み、閲覧のみ、またはキューに入っているセッションも編集できません。メッセージを編集しても、すでに書き込まれたファイルの変更は元に戻りません。

## あなたのデバイス上での実行

### セッションを実行しているデバイスの接続が切れ、セッションが一時停止した

そのコンピューターがシャットダウンした、スリープした、ネットワーク接続を失った、またはアプリを終了しました。再接続すると、セッションは停止した場所から自動的に続行し、完了した操作は繰り返されません。一時停止中にメッセージを送信したり Stop をクリックしたりした場合は、自動では続行しません。もう一度メッセージを送信してください。そのコンピューターのアプリには、接続が切れた理由が表示されます。

* サインインの有効期限切れ: もう一度サインインすると自動的に再接続します。
* このコンピューターで実行が許可されていない: **Settings › Machines** で **Allow execution** をオンにしてください。
* プロジェクトのフォルダーがまだリンクされていない: **Link folder** をクリックしてください。
* ローカルサービスが何度も予期せず終了した: **Restart** をクリックしてください。

### 実行場所のメニューで自分のコンピューターを選択できない

メニューに理由が表示されます。デバイスがオフライン、実行を許可していない、削除された、現在のプロジェクトがない、または現在の Agent が Claude Code ではない(デバイス上での実行は現在 Claude Code のみに対応)のいずれかです。原因を解消するか、代わりにクラウドサーバーを選んでください。[あなたのデバイス上で実行する](https://docs.aihubmix.com/jp/cloud/environments/your-device.md)を参照してください。

### あなたのデバイス上で実行する場合、コンピューターの電源を入れたままにする必要がありますか?

はい。コンピューターの接続が切れるとセッションは一時停止し、再接続すると自動的に続行します。ノートパソコンを閉じてもセッションを実行し続けたい場合は、クラウドサーバーを選んでください。

### Web アプリでコンピューターの実行権限を変更できない

実行権限は、そのコンピューターのデスクトップアプリでのみ変更できます。Web アプリや他のデバイスでは表示のみです。

### 新しいコンピューターを追加するには?

そのコンピューターにデスクトップアプリをインストールし、同じアカウントでサインインします。マシン一覧に自動的に表示されます。その後、そのコンピューターのアプリで **Allow execution** をオンにしてください。

### アプリにアクセスリクエストが表示される

Agent が SSH の設定などの機密の場所にアクセスしようとしており、このコンピューターは毎回確認するように設定されています。今回だけ許可するには **Allow once** を、拒否するには **Deny** をクリックしてください。しばらく応答しないと、リクエストは拒否として扱われます。

## クラウドサーバー

### アプリやノートパソコンを閉じても、セッションとスケジュールタスクは実行され続けますか?

はい。クラウドサーバー上のセッションとスケジュールタスクは、デバイスがオンラインかどうかにかかわらず実行されます。

### クラウドサーバーを更新中と表示される

しばらくお待ちください。更新が完了すると自動的に再試行します。

### クラウドサーバーがアップグレードまたは停止され、タスクが中断された

完了した手順とファイルは保持されます。アップグレードで中断された場合は、**Resend** をクリックすると最後のメッセージが再送信されます。サーバーが停止または交換された場合は、環境の準備ができてからメッセージを送信すると、Agent は既存の進捗から続行します。

### プライベートネットワークのアドレスへのアクセスがブロックされたと表示される

セキュリティのため、クラウドサーバーはパブリックなインターネットにのみアクセスでき、あなたのプライベートネットワークにはアクセスできません。BYOK で設定したカスタムモデルの URL がプライベートネットワークを指している場合は、公開されたアドレスに変更してください。

### 管理者権限をオフにしたのに、まだ適用済みと表示される

この設定がクラウドサーバーに反映されるまで少し時間がかかります。その間は適用中と表示され、通常は 1 分未満です。適用に失敗したと表示された場合は、**Retry** をクリックしてください。

### クラウドサーバーのデスクトップを表示できるだけで、操作できない

別のウィンドウまたは別のデバイスでクラウドサーバーの操作を引き継いだため、この表示は閲覧のみに戻りました。**Take control** をクリックすると、操作をここに戻せます。

### デスクトップの操作を引き継いだり、デスクトップの表示が切断されたりすると、Agent は停止しますか?

いいえ。操作を引き継ぐと、キーボードとマウスがあなたに渡されるだけで、Agent は実行を続けます。表示の接続とセッションの実行は別々に動作します。

### Web プレビューが開けない

開発サーバーがまだ実行中で、`0.0.0.0` でリッスンしていることを確認してから、**Retry** をクリックしてください。一部の Web サイトは他のページへの埋め込みをブロックしています。その場合は **Open in browser** をクリックしてください。

### スケジュールタスクが一時停止している

自分で一時停止したか、3 回連続で失敗して自動的に一時停止したか、セッションタイマーの期限が切れた可能性があります。実行履歴で理由を確認して修正し、**Resume** をクリックしてください(期限切れの場合は、先に **Renew** をクリックします)。[スケジュールタスク](https://docs.aihubmix.com/jp/cloud/automation/scheduled-tasks.md)を参照してください。

## モデルとソース

### Plus モデルを選択できない

まだ Plus を利用していません。モデルピッカーで **Get Plus** をクリックしてください。

### 自分のアカウントまたはキーのモデルを選択できない

現在の Harness と互換性がなく、理由がその下に表示されます。新しいセッションでは、クリックすると互換性のある Harness に自動的に切り替わります。セッションの開始後は選択できません。

### サブスクリプションを接続したのに、サブスクリプションのタブにモデルがない

理由はアカウントの下に表示されます。たとえば、現在の Harness がこのサブスクリプションに対応していない場合です。別の Harness に切り替えるか、しばらくしてからもう一度お試しください。

### Codex CLI で Anthropic のキーを使えないのはなぜですか?

Codex CLI には OpenAI 互換の API が、Claude Code には Anthropic 互換の API が必要です。Harness に合った形式のキーを追加してください。

### サブスクリプションを追加すると、クラウドサーバーが実行されていないと表示される

サブスクリプションのサインインはクラウドサーバー上で行われるため、クラウドサーバーが実行中である必要があります。クラウドサーバーの準備ができてからサブスクリプションを追加してください。

### サブスクリプションのアカウントに、認可の有効期限が切れたと表示される

アカウントの行で **Reconnect** をクリックしてください。

### サブスクリプションの利用上限に達した

セッションは停止し、変更と環境は保持されます。アプリが自動でアカウントを切り替えることはありません。表示されるダイアログで、同じプロバイダーの別のアカウントを選んで続行するか、**Add account** または **Use another model** をクリックしてください。**Later** をクリックして、利用上限がリセットされるのを待つこともできます。

### Plus モデルの利用上限に達した

**Settings › Account** の Plus モデルの行に、リセットされる時刻が表示されます。リセットを待つか、代わりに自分のサブスクリプションまたは API キーを使ってください。

### 自分の API キーでの呼び出しが失敗する

既定では、エラーがそのまま表示されます。**Settings › Account** で **Fall back to Plus models** をオンにすると、キーのクォータ切れ、レート制限、無効化の際に、セッションは Plus モデルで続行します。

### このソースは現在利用できないと表示される

別のソースまたはモデルをお試しください。

### セッション中にモデルを変更すると、コンテキストは失われますか?

通常は失われません。それまでの履歴はすべて保持されます。コンテキストが新しいモデルに収まらない場合にのみ、圧縮の確認を求められ、それまでの詳細の一部が保持されないことがあります。

### モデルを切り替えたら推論レベルが変わった

選んでいたレベルが新しいモデルにない場合、推論レベルは新しいモデルの推奨レベルに戻ります。[モデルを選ぶ](https://docs.aihubmix.com/jp/cloud/models/choose-a-model.md)を参照してください。

### Ultracode のスイッチをオンにできない

理由はスイッチの横に表示されます。たとえば、Harness が Claude Code ではない場合や、クラウドサーバーの準備がまだできていない場合です。

## プロジェクトと環境

### プロジェクトとワークスペースに同じ名前の変数がある場合、どちらの値が使われますか?

プロジェクトの値です。すべてのプロジェクトで共有される値は、プロジェクトに同じ名前の項目がない場合にのみ適用されます。

### 入力したシークレットを AI は見られますか?

いいえ。シークレットは暗号化して保存されます。アプリとチャットには名前のみが表示され、値は実行時にのみ環境に渡されます。セッション内で提供したシークレットも名前のみが記録され、値がチャットに入ることはありません。

### 環境チェックをスキップしました。後でシークレットを追加できますか?

はい。**Settings › Secrets & variables** で追加するか、環境構築のページに戻って **Edit environment** をクリックしてください。[プロジェクトと環境構築](https://docs.aihubmix.com/jp/cloud/environments/projects.md)を参照してください。

### プロジェクトを作成した後、環境構築が自動で始まらなかった

環境構築は任意で、プロジェクトを作成したらすぐにセッションを開始できます。必要になったら **Project settings › Environment** を開いてください。

### ローカルプロジェクトのアップロードに失敗した

すでにアップロードされた部分は保持されません。**Retry** をクリックすると、最初からやり直します。

### プロジェクトを削除すると、コンピューター上のファイルも削除されますか?

いいえ。ローカルプロジェクトのフォルダーには影響しません。プロジェクトのセッションはアーカイブされます。**Settings › Archived chats** では、それらを開いて表示するか、完全に削除することのみができます。サイドバーに戻すことはできません。

### 以前のセッションが見つからない

サイドバーの Recents には、プロジェクトに属していないセッションのみが表示されます。プロジェクトのセッションはそのプロジェクトの下にあり、ピン留めしたセッションは Pinned の下にのみ表示されます。`⌘K` を押して検索するか、Activity で期間を All time に変更するか、**Settings › Archived chats** を確認してください。[セッションの管理](https://docs.aihubmix.com/jp/cloud/sessions/manage-sessions.md)を参照してください。

### GitHub または Gmail に、認可の有効期限が切れたと表示される

通常は、そのサービス側で認可を取り消しています。**Settings › Connectors** で **Reconnect** をクリックしてください。GitHub の接続を解除してもプロジェクトは削除されません。コードの取得、ブランチのプッシュ、PR の作成ができなくなるだけです。

### インポートした MCP サーバーが機能しない

インポートした MCP サーバーは既定でオフになっています。一覧でスイッチをオンにすると、次のセッションで読み込まれます。[プラグイン、MCP、Skills](https://docs.aihubmix.com/jp/cloud/integrations/plugins-mcp-skills.md)を参照してください。

### MCP サーバーをクラウドに同期できない

デバイス上のローカルパスまたは localhost に依存しているか、設定に平文のシークレットが含まれています。前者の場合は、リモートからアクセスできる設定に変更してください。後者の場合は、**Use secret reference** を選んでデバイス上の変数参照に変更し、もう一度同期してください。

## 通知とアップデート

### セッションが終了したのに通知が表示されなかった

次の項目を順に確認してください。**Settings › General** で System notifications がオン、System permission が許可済み、Task completed カテゴリーがオンになっていること。スケジュールタスクの場合は、タスク自体の通知設定が All updates になっていること(既定では失敗時のみ通知します)。そして、その時点でそのセッションを表示していなかったかどうか。[設定](https://docs.aihubmix.com/jp/cloud/reference/settings.md)を参照してください。

### システムで通知を許可したのに、まだ Not allowed と表示される

状態は Cloud Agent のウィンドウに戻ったときに更新されます。macOS では、次の通知が届いてから Allowed と表示される場合があります。

### 承認の通知を既読にすると、セッションは続行しますか?

いいえ。既読は確認したことを示すだけです。セッションを開いて承認を完了してください。

### アップデートのダウンロードに失敗した

ネットワークを確認してから、**Download failed · retry** をクリックしてください。

### ダウンロード後に、アップデートを準備できなかったと表示される

**Retry** をクリックしてもう一度ダウンロードするか、**Download manually** をクリックしてインストーラーをダウンロードし、自分でインストールしてください。

### アップデートのために再起動しようとすると、Restart after tasks しか選べない

このコンピューターでローカルのタスクがまだ実行中です。アプリはタスクの終了を待ってから自動的に再起動します。**Cancel restart** をクリックして、後で再起動することもできます。クラウドのセッションには影響しません。

### バージョンが古いためアップデートが必要と表示される

アプリは引き続き使えますが、早めに新しいバージョンをダウンロードしてインストールしてください。

### 再起動に失敗した

もう一度再起動をクリックするか、アプリを手動で終了してから再度開いてください。

### Web アプリをアップデートするには?

手動でアップデートする必要はありません。ページを再読み込みすると最新バージョンになります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.