ghostty-config

Ghostty の設定

設定ファイルの場所

設定ファイルは任意です。ファイルがない場合、Ghostty はデフォルト設定で動作します。Ghostty 1.2.3 以降、ファイル名は config.ghostty です。拡張子のない config も後方互換性のため引き続き読み込まれます。

• XDG（すべてのプラットフォーム）：$XDG_CONFIG_HOME/ghostty/config.ghostty、次に $XDG_CONFIG_HOME/ghostty/config。XDG_CONFIG_HOME のデフォルトは ~/.config です。
• macOS の場合は、さらに ~/Library/Application Support/com.mitchellh.ghostty/config.ghostty、次に .../config。

一致するファイルはすべて読み込まれ、後から読み込まれたファイルが先のファイルの設定を上書きします。同じ場所では config.ghostty が config より先に読み込まれます。macOS では macOS のパスにあるファイルが XDG のファイルの後に読み込まれるため、競合した場合は macOS のパスの設定が優先されます。

構文

# Comments start with #
background = 282c34
font-family = "JetBrains Mono"
keybind = ctrl+z=close_surface
font-family =                     # Empty value resets to default

• キーでは大文字と小文字が区別されます。小文字を使用してください。
• 繰り返し指定できるキー（font-family、keybind、palette、env、link）は、複数行にわたって値が蓄積されます。
• すべての設定キーは CLI フラグとしても使用できます：ghostty --background=282c34 --font-size=14。

インクルード

config-file = themes/dark.conf
config-file = ?local.conf       # ? prefix = optional, no error if missing

config-file ディレクティブは、それを含むファイルの末尾で処理されるため、その後に書かれたキーもインクルード先の値に上書きされます。上書き設定はインクルード先のファイルに記述するか、インクルードを先に置き、親ファイルには競合するキーを記述しないでください。

変更の適用

• 再読み込み：ctrl+shift+,（Linux）、cmd+shift+,（macOS）。一部のオプションは再起動が必要です。また、新しく作成されたターミナルにのみ適用されるものもあります。
• 編集するたびに検証してください：ghostty +validate-config。

CLI アクション

ghostty +<action> を使用します。各アクションのヘルプを表示するには --help を追加します。

コマンド	用途
ghostty +validate-config	設定にエラーがないか確認します
ghostty +show-config	有効な設定を表示します
ghostty +show-config --default --docs	ドキュメント付きでデフォルト設定を表示します
ghostty +edit-config	デフォルトのエディターで設定を開きます
ghostty +list-fonts	使用可能な等幅フォント
ghostty +list-themes	使用可能なカラーテーマ
ghostty +list-colors	使用可能な X11 カラー名
ghostty +list-keybinds	現在のキー割り当て（デフォルトは --default）
ghostty +list-actions	すべてのキー割り当てアクション
ghostty +show-face	フォントフェイス情報
ghostty +ssh-cache	SSH terminfo キャッシュを管理します
ghostty +new-window	新しいウィンドウを開きます（Linux のみ）

macOS では、ghostty バイナリはヘルパーツールです。ターミナルを起動するには open -na Ghostty.app を使用し、フラグを渡す場合は open -na Ghostty.app --args --font-size=14 とします。新しいターミナルでコマンドを実行するには、ghostty -e <command> を使用します。

キーバインドの構文

形式：keybind = [prefix:]trigger=action[:param]

修飾キー：shift、ctrl／control、alt／opt／option、super／cmd／command。

keybind = ctrl+shift+t=new_tab
keybind = super+backquote=toggle_quick_terminal
keybind = ctrl+a>n=new_window          # Sequence: press ctrl+a, release, press n
keybind = clear                        # Remove ALL keybinds, including defaults
keybind = ctrl+a=unbind                # Remove one binding
keybind = ctrl+a=ignore                # Ghostty and the terminal both ignore the key

• 物理キーには W3C コード（KeyA、key_a、Digit1、BracketLeft）を使用します。物理キーは Unicode コードポイントより優先されます。米国以外のキーボードレイアウトでは、物理キーを使用してください。
• シーケンスでは、次のキー入力を無期限に待ちます。

Prefix	効果
global:	システム全体に適用されます（macOS：アクセシビリティ権限が必要です。Linux：XDG Desktop Portal が必要です）
all:	すべてのターミナルサーフェスに適用されます
unconsumed:	入力もそのまま通過させます
performable:	アクションが成功した場合にのみ入力を消費します

プレフィックスは組み合わせられます：global:unconsumed:ctrl+a=reload_config。シーケンスは unconsumed:／performable: と併用できますが、global: または all: とは併用できません。

Ghostty 1.3 以降では、モーダルキーテーブルとターミナル内検索アクションが追加されています。詳しくは references/keybindings.md を参照してください。

注意点

• オプションを推奨する前に、対応プラットフォームを確認してください。リファレンステーブルにはプラットフォームのマーカーがあり、別のプラットフォームでのみ有効なオプションは、何も通知せず無効になります。
• theme はモード切り替えを受け付けます：theme = light:catppuccin-latte,dark:catppuccin-mocha。
• 合字を無効にするには、font-feature = -calt と font-feature = -liga を設定します。
• 既知のテーマをユーザーが求めている場合は、手書きの色ではなく ghostty +list-themes に表示されるテーマ名を優先してください。

リファレンス

必要なタスクに応じて読み込んでください。それぞれは背景情報ではなく、検索用のカタログです。

• フォント、色、テーマ、カーソルの表示、選択範囲や検索一致箇所の色、透明度、背景画像、シェーダー、セルの寸法、スクロールバー、ウィンドウの位置とサイズ／パディング／装飾／起動時の状態、タブ、分割、クイックターミナルに関するオプションの名前を調べる、または確認する場合 -> references/options-appearance.md
• シェルとコマンドの起動、シェル統合、クリップボード、スクロールバック、マウス（カーソルクリックによる移動を含む）、key-remap による修飾キーの再割り当て、ベル、通知、リンク、アプリのライフサイクル、または macos-*、gtk-*、adw-*、linux-* のプレフィックス付きファミリーに関するオプションの名前を調べる、または確認する場合 -> references/options-behaviour.md
• キーバインドアクション、その :param 形式、キーテーブル、検索アクションの名前を調べる場合 -> references/keybindings.md

プラットフォーム限定のオプションは、プラットフォーム別ではなく、関連するカテゴリに含まれています。font-thicken（macOS）と window-vsync（macOS）は appearance ファイルにあります。プラットフォームセクションに含まれるのは、上記のプレフィックス付きファミリーのみです。

現在のスキーマ（先行リリースを含む）は https://raw.githubusercontent.com/sammcj/vscode-ghostty-config-syntax/refs/heads/main/schema/ghostty-config-syntax.schema.json にあります。サイズが大きいため、全体を読むのではなく、プログラムで検索してください。