Codex デスクトップアプリでカスタムテーマをインポートする方法

要約

Codex の設定を開き、外観に進み、カスタムテーマのインポートコントロールを使って、完全な codex-theme-v1: 共有文字列を貼り付け、プレビューを確認して適用します。コントロールの正確なラベルはアプリのビルドによって変わる場合があります。

これらの手順は 2026年7月17日に macOS 上の Codex App 26.707.72221 でレビューされました。

インポートする前に

対象が外部の Skin インストーラーではなく、ネイティブテーマであることを確認してください。ネイティブのテーマ文字列はプレーンな外観データです。シェルコマンドの実行、デバッグポートの有効化、実行ファイルのダウンロードを求められることはありません。

テーマページで、ソース、検証日、テスト済みプラットフォーム、Codex ビルドを確認してください。現在使っている組み込みテーマの名前を控えておけば、簡単に戻れる拠点になります。

インポートと確認

テーマカタログで公開されているテーマページを開きます。
テーマページの テーマをコピー を使って共有文字列をコピーします。
Codex で Settings > Appearance を開きます。
完全な共有文字列をインポートフィールドに貼り付けます。
プレフィックスや JSON ペイロードを切り詰めたり編集したりしないでください。
適用する前にライトまたはダークのバリアントを確認します。

適用後は、見出し、本文テキスト、薄いラベル、ボタン、選択状態、diff の追加、diff の削除、スキル、フェンス付きコードを確認します。アプリを再起動し、テーマが保持されることを確認してください。

よくある失敗

文字列が無効というエラーは、通常、プレフィックスや JSON が変更されたことを意味します。バリアントの不一致は、共有文字列とインポート先のライト/ダーク設定が異なることを意味します。コードテーマの不一致は、参照されているハイライト系がそのアプリバージョンで利用できないことを意味します。クリップボードの失敗は、返された文字列を選択して手動でコピーすることで回避できます。

結果が読めない場合は、すぐに組み込みの Codex テーマを選んでください。ネイティブの外観変更に外部のクリーンアップスクリプトは必要ありません。さらに広いトラブルシューティングについては、テーマのリセット・削除方法を読んでください。