ガイド文書
まず確認すること
- アプリを最新バージョンにアップデートしてください。新しいバージョンで修正済みの問題も多くあります。スマートフォンやほかの 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 以降)を Google アカウントで接続するには、PC アプリが 0.65.2 以降である必要があります。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」が何度も表示される
- Agent Switchboard と関連するプロセスがすべて終了しているかを確認します。
- 初期化の途中で強制終了したために
.secure-storage-bootstrap.lockロックファイルだけが残っている場合は、そのファイルを別の場所にコピーしてから削除し、もう一度起動します。 Local Stateファイルやcredentialsフォルダーは、削除も変更もしないでください。元の状態のまま、お問い合わせください。
推論強度に対応しているか確認できなかったと表示される
対応しているか確認できなかった推論強度は、ツールの既定値で送信し、その旨をお知らせします。以前のバージョンでこのメッセージのせいで会話を始められなかった場合は、アプリをアップデートしてください。
Windows で OAuth のログインウィンドウが空のターミナルとしてしか開かない
ユーザーの PowerShell の起動プロファイルがログインコマンドを妨げていたことによる問題です。0.61.2 以降、認証ウィンドウは起動プロファイルを読み込みません。アプリをアップデートしてください。
お問い合わせの際は
セキュリティの問題を報告するときは、API キー、OAuth トークン、認証ファイル、設定ファイル全体は添付しないでください。接続先のアドレス、OS、アプリのバージョン、再現手順、機密性の高い値を伏せたエラーメッセージだけをお送りいただければ十分です。お問い合わせは hello@twentyoz.kr で受け付けています。