HELP & SUPPORT

スムーズに導入して、
手元で使う。

Codex Quota Key の導入、使い方、トラブル対処ガイド。

01 / 導入前の確認

Marketplace への申請を準備中です。正式なダウンロード先はまだありません。このページは Logitech の審査通過を示すものではありません。

機器と環境を確認
現在の対象は Windows と MX Creative Keypad です。Logi Options+ のインストールと起動が必要です。未検証の機器や Mac は対象外です。
Codex CLI を準備
こちらの OpenAI 公式ガイドに従って Codex CLI をインストールし、ログインしてください。プラグインは CLI 経由で利用枠を取得します。作者へのパスワードや API キーの提供は不要です。
プラグインを導入
正式公開後は Marketplace の導入リンクを利用してください。作者からテスト用 .lplug4 パッケージを受け取った場合は Logi のインストーラーで開けます。テスト版のインストールは審査通過を意味しません。
キーに配置
Options+ の「すべての操作 → Codex Quota Key → CODEX ツール」から、必要な操作を空いているキーへドラッグします。既存の設定を上書きする必要はありません。

外側のキーには残量と全体の状態を表示します。押すと展開し、左上はロジクール標準の戻るキーです。右列は会話一覧、固定会話、独立したペットページ。残量関連の4キーは従来の配置です。

一覧から会話を選んで詳細を表示し、固定を切り替えます。詳細の「Codex を開く」はその会話へ移動します。アプリ起動中の移動は確認済みですが、コールドスタートは未検証です。言語はプラグイン設定で中国語・英語・日本語から選べます。

独立した残量概要キーではダブルクリック起動を設定できます。総合パネルの入口は Logi が管理するため、同じダブルクリック動作には対応していません。

デスクトップの表示と残量が違うのは？

プラグインは Codex CLI のログインアカウントを使用します。デスクトップが別のアカウントなら残量が異なる場合があります。アカウントを確認し、残量キーで再取得してください。

「不明」や中抜きの点が表示されるのは？

リアルタイム状態には起動中の Codex デスクトップアプリと互換性のあるローカル通信が必要です。未接続、非互換、会話スナップショットがない場合は不明とし、無通信時間から待機中とは判断しません。CLI の残量取得は独立して動作します。

通常の ChatGPT チャットが出ないのは？

対象はローカルの Codex 会話のみです。通常の ChatGPT クラウドチャットやリモート会話は含みません。未アーカイブのローカル会話を最大32件監視し、固定会話を優先します。

エディター内の数値が変わらないのは？

Options+ がプレビューをキャッシュしている場合があります。物理キーを見て、パネルを開く前後の数値を比較してください。機器側も更新されない場合は CLI のログイン、ネットワーク、Logi サービスを確認します。

色の意味は？

外側の残量表示と上部バーは30%超が緑、10〜30%が黄、10%未満が赤。週の残量切れも赤です。状態の点は青が実行中、黄が入力・承認待ち、赤が失敗、緑が完了・未確認、灰色が待機・停止、枠のみが不明です。

アンインストール後に残るものは？

Logi のプラグイン管理からアンインストールします。CodexQuotaKey のローカルデータには残量キャッシュ、固定会話ID、ペット設定・素材、状態診断が残る場合があります。必要に応じて削除できますが、Codex 自身の .codex フォルダーは削除しないでください。

プラグインを見つけた作者の公開投稿に、以下の情報を添えてご報告ください。GitHub アカウントは fuxiyc（七月七夕）↗ です。専用の Issue リポジトリはまだ公開していません。

プラグインのバージョン：
Windows / Logi Options+ のバージョン：
機器の型番：
再現手順：
期待する結果：
実際の結果：
物理キーでも再現するか（エディターのプレビューのみか）：

認証情報、auth.json、チャットログ全体、私的な会話のスクリーンショットは添付しないでください。問題の説明に必要な最小限の情報のみをご提供ください。