# Ghostty 業務運用マニュアル

## 目次

**【基本操作】**
1. [システム概要](#1-システム概要)
2. [起動・終了手順](#2-起動終了手順)
3. [メインターミナル画面](#3-メインターミナル画面)

**【業務フローに沿った機能】**
4. [【STEP1】コマンド入力・実行（基本操作）](#4-step1コマンド入力実行基本操作)
5. [【STEP2-3】ウィンドウ・タブ・スプリット管理（作業環境構築）](#5-step2-3ウィンドウタブスプリット管理作業環境構築)
6. [【STEP3-4】テキスト操作・検索（情報の取得・共有）](#6-step3-4テキスト操作検索情報の取得共有)
7. [【STEP4-5】設定・カスタマイズ（環境最適化）](#7-step4-5設定カスタマイズ環境最適化)

**【サポート機能】**
8. [コマンドパレット](#8-コマンドパレット)
9. [クイックターミナル](#9-クイックターミナル)
10. [セキュリティ機能](#10-セキュリティ機能)

**【運用ガイド】**
11. [日常業務の流れ](#11-日常業務の流れ)
12. [よくある質問と対処法](#12-よくある質問と対処法)
13. [トラブルシューティング](#13-トラブルシューティング)

---

## 1. システム概要

### 1.1 Ghosttyとは

Ghosttyは、高速で機能豊富なネイティブターミナルエミュレータです。速度、機能、ネイティブUI体験の3つを同時に提供することを目指しており、開発者やシステム管理者がシェルコマンドを実行し、効率的な作業環境を実現するためのツールです。

Zigで書かれたコアライブラリと、各プラットフォーム向けのネイティブUI（macOS: SwiftUI、Linux: GTK）を組み合わせた、モダンなターミナルエミュレータです。

### 1.2 本システムで行う主要業務

本システムは、主に以下の業務を支援します：

| 業務カテゴリ | 具体的な業務内容 |
|------------|----------------|
| **コマンド実行** | シェルコマンドの入力・実行、スクリプトの実行、プログラムの起動 |
| **開発作業** | コードの編集、ビルド、テスト、デバッグ、バージョン管理 |
| **システム管理** | サーバー管理、ログ監視、ファイル操作、ネットワーク管理 |
| **テキスト処理** | ログ検索、テキスト編集、クリップボード操作 |
| **マルチタスク** | 複数タスクの並行実行、ウィンドウ分割による作業効率化 |

### 1.3 業務フロー概要

本システムにおける業務は、以下の流れで進行します：

```
+---------------------------------------------------------------------+
|                        業務フロー                                    |
+---------------------------------------------------------------------+
|                                                                     |
|  【STEP 1】アプリケーション起動・コマンド入力                        |
|      ↓                                                              |
|  【STEP 2】ウィンドウ・タブ・スプリットで作業環境を構築              |
|      ↓                                                              |
|  【STEP 3】コマンド実行・出力確認・テキスト検索                      |
|      ↓                                                              |
|  【STEP 4】結果の確認・テキストコピー・共有                          |
|      ↓                                                              |
|  【STEP 5】設定調整・環境最適化・作業完了                            |
|                                                                     |
+---------------------------------------------------------------------+
```

**役割別の業務概要：**

| 役割 | 主な業務 |
|------|---------|
| **開発者** | コード編集、ビルド・テスト実行、バージョン管理、デバッグ |
| **システム管理者** | サーバー監視、ログ確認、設定変更、トラブルシューティング |
| **一般ユーザー** | ファイル操作、アプリケーション起動、スクリプト実行 |

### 1.4 主な機能

| 機能 | 説明 | 業務フローでの位置 |
|------|------|------------------|
| ターミナルエミュレーション | コマンドの入力・実行、出力表示 | STEP 1-3 |
| マルチウィンドウ・タブ | 複数のターミナルセッションを同時管理 | STEP 2 |
| スプリット分割 | 画面を分割して複数作業を並行 | STEP 2 |
| テキスト検索 | 出力内容やログの検索 | STEP 3 |
| クリップボード操作 | テキストのコピー・ペースト | STEP 3-4 |
| コマンドパレット | コマンドの検索・実行 | 随時参照 |
| クイックターミナル | ホットキーで即座にアクセス | 随時利用 |
| 設定カスタマイズ | テーマ、フォント、キーバインド設定 | STEP 5 |

### 1.5 ユーザー種別

システムには以下のユーザー種別があります：

| ユーザー種別 | 説明 |
|-------------|------|
| 一般ユーザー | 基本的なターミナル操作を行うユーザー |
| 開発者 | 高度な機能（デバッグ、カスタムシェーダー等）を活用するユーザー |

### 1.6 対応プラットフォーム・ブラウザ

**対応プラットフォーム：**
- macOS（SwiftUI/AppKitベースのネイティブアプリ）
- Linux（GTK4ベースのネイティブアプリ）

**対応シェル：**
- Bash
- Zsh
- Fish
- Elvish
- Nushell

---

## 2. 起動・終了手順

### 2.1 アプリケーションの起動

**macOSの場合：**

1. Finderで「アプリケーション」フォルダを開きます
2. 「Ghostty」をダブルクリックします
3. メインターミナルウィンドウが表示されます

または、Spotlightで「Ghostty」を検索して起動することもできます。

**Linuxの場合：**

1. アプリケーションメニューから「Ghostty」を選択します
2. またはターミナルで `ghostty` コマンドを実行します

**起動時の初期化：**

| 状態 | 表示内容 |
|------|---------|
| 正常起動 | メインターミナルウィンドウ |
| 設定読み込みエラー | 設定エラーダイアログ（リロードまたは無視を選択可能） |
| 致命的エラー | エラービュー（ログ確認と再起動を案内） |

### 2.2 アプリケーションの終了

**メニューからの終了：**

1. メニューバーから「Ghostty」>「Quit Ghostty」を選択します
2. または、キーボードショートカット「Cmd+Q」（macOS）を押します

**注意事項：**
- 実行中のプロセスがある場合、確認ダイアログが表示されます
- 「Close」を選択するとウィンドウが閉じます
- 「Cancel」を選択すると操作がキャンセルされます

### 2.3 ウィンドウの管理

**新規ウィンドウを開く：**

| 操作 | 方法 |
|------|------|
| メニューから | 「File」>「New Window」 |
| キーボード | Cmd+N（macOS） |

**ウィンドウを閉じる：**

| 操作 | 方法 |
|------|------|
| メニューから | 「File」>「Close」 |
| キーボード | Cmd+W |
| ウィンドウの閉じるボタン | ウィンドウ左上の赤いボタンをクリック |

---

## 3. メインターミナル画面

### 3.1 画面構成

メインターミナルウィンドウは以下の要素で構成されています：

| 要素 | 位置 | 説明 |
|------|------|------|
| タイトルバー | 上部 | ウィンドウタイトル、現在の作業ディレクトリ |
| ターミナル表示領域 | 中央 | コマンド入力と出力が表示されるメインエリア |
| タブバー | 上部（複数タブ時） | 開いているタブの一覧 |
| スプリットディバイダー | 分割部分 | スプリット時の分割線（ドラッグでサイズ調整可能） |

### 3.2 基本操作

**コマンドの入力と実行：**

1. ターミナル表示領域にコマンドを入力します
2. Enterキーを押してコマンドを実行します
3. 実行結果が表示されます

**テキストの選択：**

| 操作 | 結果 |
|------|------|
| マウスドラッグ | 選択範囲を指定 |
| ダブルクリック | 単語を選択 |
| トリプルクリック | 行全体を選択 |

**コピー・ペースト：**

| 操作 | キーボードショートカット |
|------|-------------------------|
| コピー | Cmd+C（macOS）/ Ctrl+Shift+C（Linux） |
| ペースト | Cmd+V（macOS）/ Ctrl+Shift+V（Linux） |

### 3.3 画面のスクロール

| 操作 | 方法 |
|------|------|
| 上方向にスクロール | マウスホイールを上に回転 / Page Up |
| 下方向にスクロール | マウスホイールを下に回転 / Page Down |
| 先頭にジャンプ | Cmd+Home / scroll_to_top アクション |
| 末尾にジャンプ | Cmd+End / scroll_to_bottom アクション |

---

## 4. 【STEP1】コマンド入力・実行（基本操作）

> **業務フローでの位置**: ユーザーがGhosttyを起動し、シェルコマンドを入力・実行する最初のステップです。

### 4.1 コマンドの入力

1. Ghosttyを起動すると、デフォルトのシェル（Bash、Zsh、Fish等）が起動します
2. プロンプト（例：`$` や `%`）が表示されたら、コマンドを入力できます
3. コマンドを入力してEnterキーを押すと実行されます

**入力例：**
```
$ ls -la
$ cd /path/to/directory
$ git status
```

### 4.2 IME入力（日本語等）

Ghosttyは各プラットフォームのネイティブIME（入力メソッドエディタ）に対応しています。

1. 通常どおりIMEを起動します（例：Cmd+Space）
2. 日本語や他の言語を入力します
3. 確定後、テキストがターミナルに送信されます

### 4.3 キーボードショートカット

| 操作 | ショートカット（macOS） | ショートカット（Linux） |
|------|------------------------|------------------------|
| コマンド履歴（前） | 上矢印 / Ctrl+P | 上矢印 / Ctrl+P |
| コマンド履歴（次） | 下矢印 / Ctrl+N | 下矢印 / Ctrl+N |
| 行頭に移動 | Ctrl+A | Ctrl+A |
| 行末に移動 | Ctrl+E | Ctrl+E |
| 1文字削除（後方） | Delete / Ctrl+D | Delete / Ctrl+D |
| 1文字削除（前方） | Backspace / Ctrl+H | Backspace / Ctrl+H |
| 実行中のコマンドを中断 | Ctrl+C | Ctrl+C |

### 4.4 フォントサイズの変更

作業中にフォントサイズを調整できます：

| 操作 | キーボードショートカット |
|------|-------------------------|
| フォントサイズを拡大 | Cmd++ / Ctrl++ |
| フォントサイズを縮小 | Cmd+- / Ctrl+- |
| フォントサイズをリセット | Cmd+0 / Ctrl+0 |

---

## 5. 【STEP2-3】ウィンドウ・タブ・スプリット管理（作業環境構築）

> **業務フローでの位置**: コマンド実行の準備として、複数の作業を並行して行うための環境を構築するステップです。

### 5.1 タブの管理

1つのウィンドウ内で複数のターミナルセッションをタブで管理できます。

**新規タブを作成する：**

| 操作 | 方法 |
|------|------|
| メニューから | 「File」>「New Tab」 |
| キーボード | Cmd+T |

**タブを切り替える：**

| 操作 | 方法 |
|------|------|
| マウスクリック | 目的のタブをクリック |
| キーボード | Cmd+1〜9（タブ番号） |
| 次のタブ | Ctrl+Tab |
| 前のタブ | Ctrl+Shift+Tab |

**タブを閉じる：**

| 操作 | 方法 |
|------|------|
| タブの閉じるボタン | タブ上の「x」ボタンをクリック |
| キーボード | Cmd+W |

**タブのタイトルを変更する：**

1. タブを右クリックします
2. 「Change Title」を選択します
3. 新しいタイトルを入力してEnterを押します

### 5.2 スプリット分割

1つのタブ内で画面を分割して、複数のターミナルを同時に表示できます。

**水平分割（上下）：**

| 操作 | キーボードショートカット |
|------|-------------------------|
| 下に分割 | Cmd+Shift+D |

**垂直分割（左右）：**

| 操作 | キーボードショートカット |
|------|-------------------------|
| 右に分割 | Cmd+D |

**スプリット間の移動：**

| 操作 | キーボードショートカット |
|------|-------------------------|
| 次のスプリットに移動 | Cmd+] または方向キー |
| 前のスプリットに移動 | Cmd+[ または方向キー |

**スプリットのサイズ調整：**

1. スプリット間のディバイダー（分割線）にマウスを合わせます
2. ドラッグしてサイズを調整します

**スプリットのズーム：**

| 操作 | 説明 |
|------|------|
| スプリットズーム | 現在のスプリットを一時的にフルサイズで表示（toggle_split_zoom） |

**スプリットを閉じる：**

| 操作 | キーボードショートカット |
|------|-------------------------|
| 現在のスプリットを閉じる | Cmd+W |

### 5.3 フルスクリーン表示

画面全体をターミナルとして使用できます。

| 操作 | キーボードショートカット |
|------|-------------------------|
| フルスクリーン切り替え | Cmd+Enter（macOS）/ F11（Linux） |

### 5.4 ウィンドウ操作の取り消し（Undo/Redo）

誤ってウィンドウやタブを閉じた場合、取り消すことができます。

| 操作 | キーボードショートカット |
|------|-------------------------|
| 取り消し（Undo） | Cmd+Z |
| やり直し（Redo） | Cmd+Shift+Z |

**注意**: undo-timeout設定で取り消し可能な時間を設定できます。

---

## 6. 【STEP3-4】テキスト操作・検索（情報の取得・共有）

> **業務フローでの位置**: コマンド実行結果の確認、ログの検索、テキストのコピー・共有を行うステップです。

### 6.1 テキストの選択とコピー

**選択方法：**

| 操作 | 結果 |
|------|------|
| クリック＋ドラッグ | 任意の範囲を選択 |
| ダブルクリック | 単語を選択 |
| トリプルクリック | 行全体を選択 |
| Shift+クリック | 現在位置からクリック位置まで選択 |

**クリップボード操作：**

| 操作 | キーボードショートカット |
|------|-------------------------|
| コピー | Cmd+C |
| ペースト | Cmd+V |
| 全選択 | Cmd+A |

**URLのコピー：**

カーソル位置のURLをクリップボードにコピーできます（copy_url_to_clipboard）。

### 6.2 テキスト検索

スクロールバック内のテキストを検索できます。

**検索の開始：**

| 操作 | キーボードショートカット |
|------|-------------------------|
| 検索を開始 | Cmd+F（macOS）/ Ctrl+F（Linux） |

**検索オーバーレイの操作（Linux/GTK）：**

1. 検索フィールドに検索テキストを入力します
2. マッチ数が表示されます（例：「3/15」）
3. Enter または下矢印ボタンで次のマッチへ移動
4. Shift+Enter または上矢印ボタンで前のマッチへ移動
5. Escape または閉じるボタンで検索を終了

**正規表現検索：**

Oniguruma正規表現ライブラリを使用した高度なパターン検索に対応しています。

### 6.3 ハイパーリンク

ターミナル内のURLはクリック可能です。

1. リンクにマウスを合わせます（Cmdキーを押しながら）
2. クリックするとデフォルトブラウザで開きます

**OSC 8プロトコル：**
プログラムからのハイパーリンク出力にも対応しています。

### 6.4 スクロールバックの保存

スクロールバック内容をファイルに保存できます。

| 操作 | 機能 |
|------|------|
| スクロールバック書き出し | write_scrollback_file |
| 現在の画面書き出し | write_screen_file |
| 選択範囲書き出し | write_selection_file |

---

## 7. 【STEP4-5】設定・カスタマイズ（環境最適化）

> **業務フローでの位置**: 作業環境を最適化し、効率的な作業を継続するためのステップです。

### 7.1 設定ファイルについて

Ghosttyはテキストベースの設定ファイルでカスタマイズします。

**設定ファイルの場所：**
```
$HOME/.config/ghostty/config
```

**設定画面へのアクセス：**

| 操作 | 方法 |
|------|------|
| メニューから | 「Ghostty」>「Settings...」 |
| キーボード | Cmd+,（macOS） |

現在、GUI設定機能は「Coming Soon」の状態です。設定ファイルを直接編集してください。

### 7.2 設定のリロード

設定ファイルを編集後、実行中のGhosttyに適用できます。

| 操作 | 方法 |
|------|------|
| 設定リロード | reload_config アクション |

### 7.3 主要な設定項目

**フォント設定：**

| 設定項目 | 説明 |
|----------|------|
| font-family | フォントファミリーの指定 |
| font-size | フォントサイズの指定 |
| font-feature | OpenTypeフォント機能の有効/無効 |

**カラー設定：**

| 設定項目 | 説明 |
|----------|------|
| theme | カラーテーマの指定 |
| background | 背景色 |
| foreground | 前景色（テキスト色） |

**ウィンドウ設定：**

| 設定項目 | 説明 |
|----------|------|
| background-opacity | 背景の透過度 |
| background-blur | 背景のブラー効果 |
| window-decoration | ウィンドウ装飾の表示/非表示 |

**キーバインド設定：**

| 設定項目 | 説明 |
|----------|------|
| keybind | キーバインドのカスタマイズ |

### 7.4 テーマの変更

利用可能なテーマを確認するには、CLIコマンドを使用します：

```
ghostty +list-themes
```

テーマを適用するには、設定ファイルに以下を追加します：
```
theme = テーマ名
```

### 7.5 CLI ユーティリティ

Ghosttyは便利なCLIコマンドを提供しています：

| コマンド | 説明 |
|----------|------|
| ghostty +version | バージョン情報を表示 |
| ghostty +list-fonts | 利用可能なフォントを一覧表示 |
| ghostty +list-keybinds | 設定されたキーバインドを一覧表示 |
| ghostty +list-themes | 利用可能なテーマを一覧表示 |
| ghostty +list-actions | キーバインドアクションを一覧表示 |
| ghostty +validate-config | 設定ファイルの構文検証 |
| ghostty +show-config | 現在の設定を表示 |
| ghostty +edit-config | デフォルトエディタで設定ファイルを開く |

---

## 8. コマンドパレット

### 8.1 コマンドパレットとは

コマンドパレットは、VSCode風のコマンド検索・実行インターフェースです。キーボードだけで素早くコマンドを検索・実行できます。

### 8.2 コマンドパレットを開く

| 操作 | キーボードショートカット |
|------|-------------------------|
| コマンドパレットを開く | Cmd+Shift+P |

または、メニューバーから「View」>「Command Palette」を選択します。

### 8.3 コマンドの検索と実行

1. コマンドパレットが表示されます
2. 検索フィールドにコマンド名の一部を入力します
3. リアルタイムで候補がフィルタリングされます
4. 上下矢印キーまたはCtrl+P/Ctrl+Nで候補を選択します
5. Enterキーでコマンドを実行します

**コマンドパレットを閉じる：**

| 操作 | 方法 |
|------|------|
| Escapeキー | コマンドパレットを閉じる |
| フォーカス喪失 | 自動的に閉じる |

### 8.4 利用可能なコマンド例

| コマンド | 説明 |
|----------|------|
| New Window | 新規ウィンドウを開く |
| New Tab | 新規タブを開く |
| Split Right | 右にスプリット |
| Split Down | 下にスプリット |
| Toggle Fullscreen | フルスクリーン切り替え |
| Reload Config | 設定をリロード |
| Check for Updates | アップデート確認（macOS） |

---

## 9. クイックターミナル

### 9.1 クイックターミナルとは

クイックターミナルは、グローバルホットキーで画面の端からスライドイン/アウトするドロップダウン式のターミナルです。どのアプリケーションを使用中でも即座にアクセスできます。

**注意**: この機能はmacOS専用です。

### 9.2 クイックターミナルの呼び出し

| 操作 | 方法 |
|------|------|
| 表示/非表示の切り替え | グローバルホットキー（設定で指定） |

### 9.3 クイックターミナルの設定

設定ファイルで以下の項目をカスタマイズできます：

| 設定項目 | 説明 |
|----------|------|
| quick-terminal-position | 表示位置（top/bottom/left/right/center） |
| quick-terminal-animation-duration | アニメーション時間 |
| quick-terminal-autohide | フォーカス喪失時の自動非表示 |

### 9.4 クイックターミナルの制限事項

- タブ機能は使用できません（スプリットは対応）
- フルスクリーンは非ネイティブモードのみ
- 環境変数 `GHOSTTY_QUICK_TERMINAL=1` が設定されます

---

## 10. セキュリティ機能

### 10.1 クリップボード確認ダイアログ

危険なペースト操作やプログラムからのクリップボードアクセス要求時に、確認ダイアログが表示されます。

**確認が表示されるケース：**
- 改行を含むテキストのペースト
- OSC 52エスケープシーケンスを含むテキスト
- プログラムからのクリップボード読み取り/書き込み要求

**ダイアログの操作：**

| ボタン | 動作 |
|--------|------|
| Paste / Allow | 操作を許可して実行 |
| Cancel / Deny | 操作をキャンセル |

### 10.2 セキュア入力（macOS）

パスワード入力時にキーロガーを防止するセキュア入力モードがあります。

| 操作 | 方法 |
|------|------|
| セキュア入力の切り替え | toggle_secure_input アクション |

セキュア入力が有効な場合、画面に視覚的なインジケーターが表示されます。

### 10.3 終了確認

プロセス実行中のウィンドウを閉じようとすると、確認ダイアログが表示されます。

| ボタン | 動作 |
|--------|------|
| Close | ウィンドウを閉じる（プロセスは終了） |
| Cancel | 操作をキャンセル |

設定項目 `confirm-close-surface` で動作をカスタマイズできます。

---

## 11. 日常業務の流れ

本セクションでは、業務フローに沿った日常業務の流れを説明します。

```
業務フロー概要（再掲）
====================================================
【STEP 1】アプリケーション起動・コマンド入力 → 2章・4章参照
    ↓
【STEP 2】ウィンドウ・タブ・スプリットで作業環境を構築 → 5章参照
    ↓
【STEP 3】コマンド実行・出力確認・テキスト検索 → 4章・6章参照
    ↓
【STEP 4】結果の確認・テキストコピー・共有 → 6章参照
    ↓
【STEP 5】設定調整・環境最適化・作業完了 → 7章参照
====================================================
```

### 11.1 【STEP1】アプリケーション起動

業務開始時に、Ghosttyを起動します。

1. アプリケーションを起動します
2. メインターミナルウィンドウが表示されます
3. シェルプロンプトが表示されたら、作業を開始できます

### 11.2 【STEP2】作業環境の構築

複数の作業を並行して行う場合は、タブやスプリットを活用します。

1. 必要に応じて新規タブを作成します（Cmd+T）
2. 画面分割が必要な場合はスプリットを作成します（Cmd+D / Cmd+Shift+D）
3. 各ターミナルで異なる作業を行います

### 11.3 【STEP3】コマンド実行と出力確認

1. 各ターミナルでコマンドを入力・実行します
2. 出力を確認します
3. 必要に応じてスクロールバックで履歴を参照します
4. 検索機能（Cmd+F）でテキストを検索します

### 11.4 【STEP4】結果の確認と共有

1. 必要なテキストを選択してコピーします（Cmd+C）
2. 他のアプリケーションに貼り付けます
3. 必要に応じてファイルに保存します

### 11.5 【STEP5】作業完了と環境最適化

1. 不要なタブやウィンドウを閉じます
2. 必要に応じて設定を調整します
3. アプリケーションを終了します（Cmd+Q）

---

## 12. よくある質問と対処法

### 12.1 起動に関するQ&A

**Q: アプリケーションが起動しません**

A: 以下を確認してください：
- システム要件を満たしているか確認
- macOSの場合、Gatekeeper設定を確認
- ログファイルを確認（環境変数 `GHOSTTY_LOG=stderr` で標準エラー出力に出力）

**Q: 設定エラーダイアログが表示されます**

A: 設定ファイルに構文エラーがあります：
1. 「Reload」で設定を修正後に再読み込みを試みる
2. 「Ignore」で一時的にエラーを無視して起動
3. `ghostty +validate-config` で設定を検証

### 12.2 操作に関するQ&A

**Q: 日本語が入力できません**

A: IMEが正しく動作しているか確認してください：
- システムのIME設定を確認
- 他のアプリケーションで日本語入力ができるか確認

**Q: コピー・ペーストができません**

A: キーボードショートカットを確認してください：
- macOS: Cmd+C / Cmd+V
- Linux: Ctrl+Shift+C / Ctrl+Shift+V（設定依存）

**Q: タブが作成できません（クイックターミナル）**

A: クイックターミナルではタブ機能は非対応です。スプリット機能は利用できます。

### 12.3 表示に関するQ&A

**Q: フォントが正しく表示されません**

A: フォント設定を確認してください：
- `ghostty +list-fonts` で利用可能なフォントを確認
- 設定ファイルで正しいフォント名を指定
- `ghostty +show-face <codepoint>` で特定文字のフォントを確認

**Q: 文字化けが発生します**

A: 以下を確認してください：
- ターミナルのエンコーディング設定
- シェルのLANG/LC_ALL環境変数
- フォントが対象文字をサポートしているか

---

## 13. トラブルシューティング

### 13.1 エラーメッセージと対処法

| エラーメッセージ | 原因 | 対処法 |
|----------------|------|--------|
| "Oh, no. Something went fatally wrong." | 致命的エラー発生 | ログを確認し、アプリケーションを再起動 |
| "Debug builds of Ghostty are very slow..." | デバッグビルドの使用 | リリースビルドを使用（警告のみ、動作には問題なし） |
| "Close Terminal? The terminal still has a running process." | プロセス実行中のクローズ | プロセスを終了するか、キャンセルして継続 |
| "Cannot Create New Tab - Tabs aren't supported in the Quick Terminal." | クイックターミナルでのタブ作成 | クイックターミナルではタブは非対応。スプリットを使用 |

### 13.2 よくあるトラブルと解決方法

**問題: パフォーマンスが低下している**

解決方法：
1. 不要なタブ・ウィンドウを閉じる
2. スクロールバック量を減らす設定を検討
3. カスタムシェーダーを無効化
4. GPUドライバーを更新

**問題: キーバインドが動作しない**

解決方法：
1. `ghostty +list-keybinds` で現在の設定を確認
2. 設定ファイルのキーバインド定義を確認
3. 他のアプリケーションとの競合を確認

**問題: シェル統合機能が動作しない**

解決方法：
1. シェル統合スクリプトが正しく読み込まれているか確認
2. シェルの設定ファイル（.bashrc、.zshrc等）を確認
3. 環境変数 `GHOSTTY_RESOURCES_DIR` を確認

### 13.3 ログの確認方法

デバッグ情報を取得するには、環境変数を設定してGhosttyを起動します：

**標準エラー出力に出力（すべてのプラットフォーム）：**
```
GHOSTTY_LOG=stderr ghostty
```

**macOS統合ログに出力：**
```
GHOSTTY_LOG=macos ghostty
```

**両方に出力：**
```
GHOSTTY_LOG=stderr,macos ghostty
```

### 13.4 クラッシュレポート

クラッシュが発生した場合、クラッシュレポートを確認できます。

```
ghostty +crash-report
```

レポートはSentry形式で生成され、問題の診断に役立ちます。

### 13.5 サポートへの連絡方法

問題が解決しない場合は、以下の情報を添えてサポートにご連絡ください：

1. Ghosttyのバージョン（`ghostty +version`）
2. OS/プラットフォームの情報
3. 問題の再現手順
4. エラーメッセージやログ出力
5. 設定ファイルの内容（機密情報は除く）

---

## 改訂履歴

| 版数 | 改訂日 | 改訂内容 |
|-----|--------|---------|
| 1.0 | 2026-03-01 | 初版作成 |

---

*本マニュアルは、Ghosttyターミナルエミュレータのエンドユーザー向け業務運用マニュアルです。*
*システムの更新により、画面や操作方法が変更される場合があります。*
