Agent Switchboard
ダウンロード
Agent Switchboard
ダウンロード

言語

選択した言語は Cookie に保存されます。

テーマ
ガイド文書

トラブルシューティング

最初に確認すること

  • アプリを最新バージョンにアップデートします。多くの問題は新しいバージョンで修正されています。スマートフォンや他の PC と一緒に使う機能では、接続する PC も最新バージョンである必要があります。
  • エラーメッセージをそのまま確認します。アプリは原因ごとに異なる案内を表示します。

インストールとアップデート

Windows で SmartScreen の警告が表示される

Windows 版のインストールファイルに、まだ Authenticode のコード署名がないために表示される警告です。公式ダウンロードページから入手したファイルであることを確認してから、詳細情報 → 実行 を押します。詳しくはインストール・初回起動を参照してください。

Portable 版が自動でアップデートされない

Windows Portable は、アプリ内での自動インストールに対応していません。ダウンロードページから新しいファイルを入手して置き換えます。自動アップデートが必要な場合は Setup 版を使ってください。

アップデートサーバーに接続できない

アプリがアップデート先のアドレスに到達できない場合は、既定のブラウザーでリリースページを開きます。そこからインストールファイルを直接ダウンロードできます。アップデートにはアカウントやアクセストークンは不要です。

アップデートの通知が来ない

  • 나중에（後で）を選んだ場合は、その実行中は 4 時間通知しません。
  • 이번 버전 건너뛰기（このバージョンをスキップ）を選んだ場合は、そのバージョンを自動では通知しません。
  • 上部のダウンロードアイコンから手動で確認すると、保留したバージョンやスキップしたバージョンも再び表示します。

アップデートのインストールに失敗する

失敗の理由は、アップデートウィンドウと再起動の確認ウィンドウに表示されます。

  • macOS: インストールの検証中にエラーや 120 秒のタイムアウトが発生した場合は、再試行できます。
  • Linux .deb: インストール時に管理者権限のダイアログが表示される必要があります。3 分以内に権限のダイアログが表示されない場合はインストールを中止し、ターミナルから直接インストールするコマンドを案内します。権限のダイアログでキャンセルした場合と、権限を得られなかった場合を区別して案内します。
  • Linux でサンドボックスのシェルからアプリを起動した場合: NoNewPrivs の制限により、権限昇格がブロックされることがあります。アプリはユーザーの systemd で認証ダイアログを表示し、それでもうまくいかない場合は、アプリ外のターミナルから sudo でインストールする方法を案内します。

スマートフォン連携と QR

「연결 QR 만들기」（接続用 QR を作成）を押せない

QR は、PC が中継サーバーに接続された後でのみ作成できます。환경 설정 › 휴대폰（環境設定 › スマートフォン）で 휴대폰 연결 켜기（スマートフォン連携をオンにする）がオンになっていて、状態が接続済みになっているかを確認してください。

スマートフォン連携をオンにできない

PC が OS のセキュアストレージを使えない場合、スマートフォン連携はオンにできません。代わりに平文で保存することはしません。Linux の場合は、Secret Service などの keyring を有効にしてからアプリを再起動してください。

QR が期限切れまたは使用済みと表示される

QR の有効期間は 5 分間で、1 回しか使えません。PC で新しい QR を作成して接続し直してください。

「연결 시도가 너무 잦습니다」（接続の試行回数が多すぎます）と表示される

認証に失敗した接続は、PC が中継サーバーを通じて一時的に（約 1 分）ブロックします。1 分ほど待ってから、新しい QR で再試行してください。

「연결이 해제되었습니다」（接続が解除されました）と表示される

PC でこのスマートフォンの接続を切断したか、デスクトップの ID を新しく作成した場合です。PC で新しい QR を作成して接続し直してください。Google アカウントで接続していた場合は、PC の承認ウィンドウで再度許可すれば接続できます。

PC の電源が切れていると表示される

PC の電源が入っていて、Agent Switchboard が起動しているかを確認してください。PC の電源が入ると自動で再接続されます。

Android アプリに「네트워크 연결을 확인하세요」（ネットワーク接続を確認してください）しか表示されない

配布用キーで署名された Android アプリ（0.6.0 以上）は、PC 0.65.2 以上でのみ Google アカウントによる接続を受け付けます。PC アプリをアップデートしてください。

「Google 계정을 확인하지 못했습니다」（Google アカウントを確認できませんでした）と表示される

PC の時計が遅れていると、Google ログインの証明の確認に失敗することがあります。PC 0.65.3 で、時計が少し遅れている場合の問題を修正しました。PC アプリをアップデートし、OS の時刻自動同期をオンにしておいてください。

PC に「Google에 다시 로그인해 주세요」（Google に再度ログインしてください）と表示される

PC の Google ログインの有効期限が切れた場合です。環境設定 › スマートフォン の Google 다시 로그인（Google に再ログイン）を押してください。再ログインするまでは、他のデバイスからの新しい接続を受け付けられません。

Android アプリを新たにインストールできない

以前に別の署名で作られた APK をインストールしていた場合、新しい APK を上書きインストールできません。既存のアプリを削除して新しい APK をインストールし、PC との接続と Google ログインをやり直してください。

ウェブアプリのアドレスが変わった後、PC の一覧が空になった

スマートフォンのウェブアプリは https://app.switchboard.twentyoz.kr で提供しています。以前のアドレスで使っていた接続情報は、新しいアドレスには移行されません。QR で接続し直すか、Google アカウントを使っていた場合は再ログインして PC の一覧を読み込んでください。

キーと認証

「저장 후 적용」（保存して適用）が無効になっている（Linux）

OS のセキュアストレージ（keyring）を使えない PC では、API キーを保存できません。ボタンの上に理由が表示されます。keyring を有効にしてからアプリを再起動してください。

選択したモデルで適用されない

接続テストと適用の際に、選んだモデルが実際に使えるかを確認します。使えない場合は適用を中止します。一覧から使えるモデルを選び直してください。

CLI が「credential is not configured」エラーを出す

フォルダーの接続が変わった後、古い実行プロファイルで CLI を起動したときに発生することがあります。該当する接続をツール設定で再度適用し、CLI を新たに起動してください。フォルダーに Codex の設定はあるのに、フォルダーの接続プロファイルが消えている場合は、アプリが保存済みの設定からプロファイルを作り直します。

「SECURE_STORAGE_BOOTSTRAP_FAILED」が繰り返し表示される

  1. Agent Switchboard と関連するプロセスがすべて終了していることを確認します。
  2. 初期化中の強制終了により .secure-storage-bootstrap.lock ロックファイルだけが残っている場合は、そのファイルを別の場所に保管してから削除し、再度起動します。
  3. Local State ファイルや credentials フォルダーは削除したり変更したりしないでください。元の状態を保ったままお問い合わせください。

推論強度に対応しているか確認できなかったと表示される

対応が確認できない推論強度は、ツールの既定値で送信し、その旨の案内を残します。以前のバージョンでこのメッセージが出て会話を始められなかった場合は、アプリをアップデートしてください。

Windows で OAuth のログインウィンドウが空のターミナルとしてしか開かない

ユーザーの PowerShell 起動プロファイルがログインコマンドを妨げていた問題です。0.61.2 以降、認証ウィンドウは起動プロファイルを読み込みません。アプリをアップデートしてください。

お問い合わせの際は

セキュリティに関する問題を報告する際は、API キー、OAuth トークン、認証ファイル、設定ファイル全体を添付しないでください。接続先のアドレス、OS、アプリのバージョン、再現手順、機密性の高い値を伏せたエラーメッセージだけをお送りください。お問い合わせは hello@twentyoz.kr で受け付けています。