チュートリアル
最初の Codex スキンを可逆的に適用するための詳しい手順。
始める前に
Skins style Codex at the visual layer only, over <code class="font-mono text-fg-2">127.0.0.1</code>. No app files are modified and your API key is never touched.
-
エンジンは 1 度だけ導入
Codex Dream Skin などのエンジン、または Codex Skin Manager のようなマネージャーをクローン/ダウンロード。これは 1 度限りのセットアップです。
-
インデックスでスキンを選ぶ
カテゴリ・ムード・色で検索。スキンページで説明 / 対応プラットフォーム / インストールプロンプトを確認。
-
コピーして適用
インストールプロンプトをコピーして Codex Desktop に貼り付けるか、CLI コマンドを実行。ワークスペースは即座に更新されます。
-
確認してソースを保存
新しい表示を確認したら、ソースリンクをブックマーク。Codex の更新で壊れた場合は復元手順で初期状態に戻せます。
ヒント
- Start with a featured skin — it is the most likely to apply cleanly through the engine's default preset.
- プロンプトは原文そのままコピーしましょう。小さな修正でエンジン適用結果が変わることがあります。
- Codex のアップデート後に復元/再適用できるよう、ソースリンクは手元に残しておきましょう。
- 100+ 種類から好みの数点まで、カテゴリとムードのフィルターで絞り込み。
エンジンの選び方
エンジンはスキンの適用方法と利用可能なフォーマットを決定します。すべて無料・オープンソース。
| エンジン | プラットフォーム | インストール方式 | 備考 |
|---|---|---|---|
| Codex Dream Skin | macOS, Windows | Agent prompt / preset | Core open-source engine; local CDP injection, no app modification. |
| Codex Skin Manager | macOS, Windows | Built-in manager | 14 built-in themes plus a theme creator and Codex Skill. |
| Codex Themes (desktop) | macOS | .codextheme import | Gallery and creator center at theme.codexguide.ai. |
| ReTheme | macOS, Windows | Signed themes | Tauri-based; signed, updatable, community themes. |
| Codex Themes CLI | Cross-platform | CLI /theme | Validate, preview, apply, rollback, export palettes. |
| Codepilot | Cross-platform | Built-in TUI /skin | Codex CLI distribution with 16 built-in TUI skins. |
トラブルシューティング
よくある 4 つの問題と解決法。
-
Prompt applies but nothing visibly changes
Confirm the engine is running and pointed at the right Codex window. Restart Codex Desktop, then re-apply.
-
Skin looks different from the preview
Previews approximate the source palette. Check the source link for the exact theme file and version.
-
Codex updated and the skin stopped working
Use the engine's restore-to-default option, then re-apply. Keeping the source link makes this a two-minute fix.
-
CLI /theme says no themes installed
Run the port install script first, then reopen the CLI prompt. Some ports cache colors at startup.
Need the short version? See the install guide, the FAQ, or the full install blog post.