macOS · 手動と Codex 支援の手順

macOS に Codex Dream Skin をインストール

公式リポジトリ

始める前に

ローカルの前提条件を確認

公式の Codex Desktop をインストールし、少なくとも一度起動済みであること。
デスクトップとローカルのアプリケーションサポートファイルにアクセスできる通常の macOS ユーザーであること。
公式リポジトリをクローンできる Git が利用可能であること。

おすすめCodex でインストール

安全範囲を限定した macOS 用プロンプトをコピー

公式リポジトリのみを使用し、無関係な設定を保護し、検証を任意としたうえで、最後に復元方法を案内するプロンプトです。

コピー前にプロンプト全文を確認

Help me install Codex Dream Skin from the official repository https://github.com/Fei-Away/Codex-Dream-Skin.

No specific theme was selected. After installation, show me the bundled themes and ask before applying one.

Safety requirements:
- Explain each action before running it.
- Use only the official repository scripts and current repository documentation. Do not modify the official app bundle, app.asar, WindowsApps, code signatures, or system security settings.
- Do not read, print, replace, or upload API keys, Base URLs, authentication data, private project paths, images, or unrelated configuration.
- If config.toml is complex or multiline, changes during the operation, or a script refuses it, stop and explain. Never delete or rebuild it.
- If a command no longer matches the current repository documentation, stop and report the mismatch instead of improvising.
- Verification is optional, but offer it after launch and explain what evidence it creates.
- Finish by giving me the exact restore command and log/state location.

macOS workflow:
1. Confirm this is macOS and read README.md, macos/README.md, and the relevant scripts.
2. Confirm official Codex Desktop has launched at least once and ~/.codex/config.toml exists. No global Node.js install is required.
3. Clone the repository using:
git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin
4. Install using:
cd macos
./scripts/install-dream-skin-macos.sh --no-launch
5. After installation, list the bundled presets and ask which one to apply.
6. Start or customize only through the installed Dream Skin launchers/scripts.
7. Offer the optional verification command:
~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh --reload --screenshot ~/Desktop/dream-skin-verify.png
8. Explain engine path ~/.codex/codex-dream-skin-studio, state/log path ~/Library/Application Support/CodexDreamSkinStudio, and restore with:
~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh --restore-base-theme --restart-codex

承認する前に、Codex が提案する操作を一つずつ確認してください。

代替手段 · 手動ターミナル手順

クローンから復元まで、明確な 6 ステップ

通常のユーザーとしてコマンドを実行してください。チェックアウトはインストールにのみ使用し、エンジンはアカウント配下の安定したパスへコピーされます。

公式リポジトリをクローン

公式 GitHub プロジェクトをクローンし、リポジトリに入ります。下のインストーラー手順で macOS ディレクトリへ移動します。

macOS

エンジンのソースをクローン

公式プロジェクト URL を使用し、インストールが完了するまでチェックアウトを残してください。

git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin

プラットフォーム別ガイドを読んでから実行してください。

インストーラーを実行

インストーラーは Codex の署名済み同梱 Node を検証し、エンジンを ~/.codex/codex-dream-skin-studio にインストールして、デスクトップ用ランチャーを作成します。--no-launch により起動は別途、目に見える判断として残されます。

macOS

起動せずにインストール

クローンしたリポジトリのルートで実行します。Codex を起動せずに既定テーマをインストールします。

cd macos
./scripts/install-dream-skin-macos.sh --no-launch

プラットフォーム別ガイドを読んでから実行してください。

別の同梱テーマを使いますか？

インストーラーは既定テーマから開始します。下から同梱プリセットを選び、インストール後に切り替えコマンドをコピーしてください。

同梱テーマ

macOS

Midnight Aurora に切り替える

インストール完了後に、このインストール済みスクリプトを実行します。別のプリセットのコマンドも、いつでもここに戻ってコピーできます。

~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-midnight-aurora

プラットフォーム別ガイドを読んでから実行してください。

プリセットまたは自分の画像を選択

新規インストールでは同梱プリセットが追加されます。画像を取り込む場合は、UI を含まない 16:9 の JPG、PNG、HEIC、TIFF、WebP を使用してください。推奨する元画像は 2560 × 1440 で、上流の制限内に収めてください。

macOS

ローカルのカスタマイズを開く

画像解析はローカルの Codex レンダラー内で行われ、画像をアップロードせずに焦点、安全領域、パレットを調整します。

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh

プラットフォーム別ガイドを読んでから実行してください。

テーマ適用済み Codex を起動

デスクトップから Codex Dream Skin を開きます。インストーラーは Customize、Verify、Restore のランチャーも作成します。SwiftBar の操作は任意で、完全なインストールには必要ありません。

ネイティブのサイドバー、コンポーザー、コントロールは操作可能なままである必要があります。

Codex UI を含むスクリーンショットではなく、純粋な背景だけを使用してください。

検証して証拠を残す

任意

Dream Skin の利用に検証は必須ではありません。注入状態を確認したい場合や、トラブルシューティングまたは検証記録のためにスクリーンショットを保存したい場合に実行してください。

macOS

任意

任意の検証

注入を再読み込みしてデスクトップにスクリーンショットを保存します。共有前に確認し、機密情報を取り除いてください。

~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh --reload --screenshot ~/Desktop/dream-skin-verify.png

任意：検証結果を保存したい場合に使用します。

元の表示に戻す

デスクトップの Restore ランチャーを使うか、復元コマンドを実行してください。復元すると現在のスキン処理が終了し、保存済みの基本表示へ戻ります。

macOS

Codex を復元して再起動

インストールを始める前に、このコマンドを使える状態にしておいてください。

~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh --restore-base-theme --restart-codex

プラットフォーム別ガイドを読んでから実行してください。

トラブルシューティング安全性の範囲を確認