cmuxのおすすめ設定・カスタマイズ完全ガイド

cmuxの設定はどこから始める？

こんにちは！今日は「cmuxのおすすめ設定とカスタマイズ」について学んでいきましょう。

cmux（シーマックス）はAIコーディングエージェント専用のターミナルです。インストールしてすぐに使い始められますが、設定を自分好みに整えると、毎日の開発がぐっと快適になります。

この記事では「設定ファイルの場所」「おすすめの初期設定」「キーバインド」「通知・内蔵ブラウザ」「Ghostty互換」「トラブル対処」の順に解説します。なお、ここで扱う具体的な設定キーやファイルパスは公開情報にもとづくものに絞り、確証のない値は断定しません。最新の正確な設定項目は必ず公式ドキュメントもあわせて確認してくださいね。

設定ファイルの場所と構造

cmuxの設定は、大きく分けて2つの場所で管理すると考えると整理しやすいです。

Ghostty configを読み込むしくみ

cmuxはGhosttyのレンダリングエンジン（libghostty）を搭載しているため、ターミナルの見た目や挙動に関する設定はGhosttyの設定ファイルをそのまま読み込みます。場所は次のとおりです。

# Ghostty（= cmuxが読み込む）設定ファイルの場所を確認
ls ~/.config/ghostty/config

このファイルが存在すれば、cmuxは起動時にその内容を反映します。すでにGhosttyを使っている方は、テーマ・フォント・カラースキームがそのまま引き継がれるので、追加設定は基本的に不要です。

設定ファイルがまだない場合

設定ファイルがまだ無い場合は、ディレクトリごと作成して空のファイルを用意します。

# 設定ディレクトリとファイルを作成
mkdir -p ~/.config/ghostty
touch ~/.config/ghostty/config

ファイルの中身は キー = 値 の形式で1行ずつ書いていきます。Ghosttyの設定記法に準拠しているので、Ghosttyのドキュメントがそのまま参考になります。

おすすめの初期設定

ここでは、インストール直後にまず整えておきたい設定を紹介します。いずれもGhostty configに記述する見た目・挙動まわりの項目です。実際のキー名はGhosttyの記法に準拠しているため、最新の項目は公式ドキュメントで確認しつつ、自分の環境に合わせて調整してください。

フォントとサイズ

エディタと同じフォントに揃えると、ターミナルとコードの見た目が統一されて視認性が上がります。

# Ghostty config（= cmuxが読み込む設定）の例
# font-family = JetBrains Mono
# font-size = 14

プログラミング向けフォント（合字対応のフォントなど）を選ぶと、記号の見やすさが向上します。

テーマ・カラースキーム

長時間の作業では、目に優しいダーク系テーマがおすすめです。

# テーマの設定例
# theme = catppuccin-mocha
# theme = tokyo-night
# theme = dracula

カーソルの見やすさ

カーソルが見つけやすいと、分割した複数ペインを行き来するときに迷いません。

# カーソルの設定例
# cursor-style = block
# cursor-style-blink = true

初期設定チェックリスト

最初に押さえておくと快適になるポイントをまとめます。

1. ①フォント: エディタと揃えて視認性を統一する
2. ②テーマ: ダーク系で目の負担を減らす
3. ③カーソル: 見やすいスタイルにしてペイン移動を楽にする
4. ④macOSの通知許可: cmuxの通知を受け取れるよう許可しておく（後述）

キーバインドのカスタマイズ

cmuxはMacネイティブなショートカット体系を採用しており、tmuxのようなプレフィックスキー（Ctrl+b）を覚える必要がありません。まずはデフォルトのショートカットを把握し、必要に応じてSettings画面で調整するのがおすすめです。

まず覚えたいデフォルトショートカット

tmux経験者向けの考え方

tmuxから移ってきた方は、プレフィックスキーを押す習慣をいったん忘れるのがコツです。

🔍 注目ポイント: cmuxはMacの一般的なアプリと同じ感覚で操作できます。まずデフォルトのまま使ってみて、手に馴染まないものだけをSettings画面で調整するのがおすすめです。

キーバインドを変えるときの考え方

cmux固有のショートカットの割り当てはSettings画面から行います。割り当てを変更するときは、次の点に気をつけると衝突を避けられます。

• macOSのシステムショートカットと重複しないようにする
• 普段使っているエディタやブラウザのショートカットと整合させる
• よく使う操作（分割・通知ジャンプ）ほど押しやすいキーに寄せる

通知・内蔵ブラウザの設定

cmuxの大きな魅力が、AIエージェント向けの通知システムと、スクリプタブルな内蔵ブラウザです。設定の観点で押さえておきたいポイントを整理します。

通知を受け取れるようにする

エージェントが入力待ち（ユーザーの確認や承認が必要な状態）になると、そのペインに青い通知リングが表示され、サイドバーのタブにもバッジが付きます。この通知をデスクトップ通知として受け取るには、macOS側の許可が必要です。

# macOSの通知設定を確認
# システム設定 > 通知 > cmux が許可されているか確認

cmuxは次のような方法で通知を検知します。

1. ①ターミナルエスケープシーケンス: OSC 9 / OSC 99 / OSC 777に対応
2. ②cmux CLIコマンド: cmux notify コマンドで手動通知
3. ③エージェントフック: Claude Codeのフック機能と連携

cmux notifyを使った通知設定

シェルスクリプトやエージェントのフックから cmux notify を呼び出すと、任意のタイミングで通知を送れます。長時間タスクの完了を知らせる用途に便利です。

# 基本的な通知の送信
cmux notify "ビルドが完了しました"

# 成否で通知を出し分ける例
npm run build && cmux notify "ビルド成功" || cmux notify "ビルド失敗"

内蔵ブラウザの活用設定

cmuxにはターミナルのペインと並べて表示できる内蔵ブラウザが搭載されています。設定というより使い方の整備に近いですが、次のショートカットを覚えておくと開発の行き来が減ります。

# ブラウザ関連のショートカット
# Cmd+Shift+L    ブラウザをスプリットで開く
# Cmd+L          アドレスバーにフォーカス
# Cmd+[          戻る
# Cmd+]          進む
# Option+Cmd+I   開発者ツールの表示/非表示

内蔵ブラウザはスクリプタブルAPIを備えており、要素スナップショットの取得やフォーム入力、JavaScript実行などをエージェントから操作することも可能です。開発サーバーの確認を内蔵ブラウザに寄せると、外部ブラウザとの切り替えが減って集中しやすくなります。

Ghostty configとの互換

ここまで触れてきたとおり、cmuxの見た目・挙動まわりの設定はGhosttyの設定ファイルを共有します。この互換性の恩恵と注意点を整理しておきましょう。

互換性のメリット

• すでにGhosttyを使っているなら、テーマ・フォント・カラースキームをそのまま引き継げる
• Ghosttyのドキュメントや配色テーマの資産がそのまま使える
• ターミナル設定をcmux専用に書き直す必要がない

設定の住み分け

🔄 使い分けのポイント: 「ターミナルとしての見た目はGhostty config、cmuxという製品としての挙動はSettings画面」と分けて考えると、どこをいじればいいか迷わなくなります。

設定が反映されない時の対処

設定を変更したのに反映されない、というときは次の順で切り分けると原因にたどり着きやすいです。

1. 設定ファイルの場所を確認する

# 設定ファイルが正しい場所にあるか確認
ls -la ~/.config/ghostty/config

パスが違っていたり、ファイル名がタイプミスしていたりすると読み込まれません。~/.config/ghostty/config に正しく置かれているかを最初に確認します。

2. cmuxを再起動する

# Cmd+Q で完全に終了してから、もう一度起動する

設定ファイルは起動時に読み込まれます。編集後はいったん完全に終了してから起動し直すと反映されることが多いです。

3. 通知が出ない場合

# macOSの通知設定を確認
# システム設定 > 通知 > cmux が許可されているか確認

# cmux CLIが使えるか確認
which cmux
cmux notify "テスト通知"

cmux notify を実行しても通知が見えない場合は、まずmacOS側でcmuxの通知が許可されているかを確認します。which cmux でCLIにパスが通っているかもチェックしておきましょう。

4. 権限まわりを確認する

# システム設定 > プライバシーとセキュリティ > アクセシビリティ
# cmux が許可リストに含まれているか確認

機能によってはmacOSのアクセシビリティ許可が必要になる場合があります。初回起動時に「開発元が未確認」と表示されたときは、右クリック > 開く で起動できます。

よくある質問

📝 まとめ

今回はcmuxのおすすめ設定とカスタマイズについて学びました！

設定の全体像は、次の二段構えで覚えておくとスッキリ整理できます。

• 見た目・ターミナル挙動: Ghostty config（~/.config/ghostty/config）に キー = 値 形式で記述
• cmux固有の挙動: cmuxのSettings画面（ショートカット・通知・内蔵ブラウザなど）

押さえておきたいポイントをまとめます。

• 設定ファイルの場所: ~/.config/ghostty/config。無ければ mkdir -p と touch で作成
• おすすめ初期設定: フォント・テーマ・カーソルを整え、macOSの通知を許可しておく
• キーバインド: まずデフォルト（Cmd+D / Cmd+Shift+D など）に慣れ、必要なものだけSettings画面で調整
• 通知: macOSの許可 + cmux notify でエージェントの状態を見逃さない
• 反映されないとき: ファイルの場所 → 再起動 → 通知/権限許可、の順に切り分ける

自分に合った設定を整えれば、AIエージェントとの開発はさらに快適になります。具体的なキー名や最新の項目は公式ドキュメントもあわせて確認しつつ、少しずつ自分仕様にカスタマイズしていきましょう。

cmux全体の使い方をおさらいしたい方は、cmuxでAIコーディングを加速するの記事もぜひチェックしてみてください！