トラブルシューティング：ターミナル

ターミナルは開くが入力時に出力がない

症状： キーを押すがターミナルに何も表示されない、またはターミナルが空白の画面で開き、そのまま。

考えられる原因と修正：

シェル初期化ファイルのエラー。 シェル起動ファイル（.zshrc、.bashrc、または.bash_profile）に構文エラーまたはハングするコマンドがある可能性があります。1DevToolでプレーンなBashターミナルを開き、実行：

cat ~/.zshrc

明らかなエラーを探す — 閉じ引用符の欠落、未定義の変数、存在しないファイルを指すsourceコマンド。Env Managerまたはテキストエディタでエラーを修正し、ターミナルを再度開く。

間違ったターミナルタイプ。 「Claude Code」ターミナルを選択したがclaude CLIがインストールされていない場合、ターミナルは開くがシェルがエージェントを起動できない。まずClaude Codeをインストール（npm install -g @anthropic-ai/claude-code）、またはターミナルタイプをプレーンなBashまたはZshセッションに切り替え。

クイックリセット。 ターミナルタブ内を任意の場所で右クリックし、ターミナルを再起動を選択。現在実行中のシェルプロセスをキルし、パネルを閉じずに新しいシェルを開始。

AIエージェントが入力に応答しない

症状： エージェントターミナルにプロンプトを入力するが何も起こらない — スピナーも、レスポンスも、応答もない。

最も一般的な原因は、エージェントのインターフェースが入力を読んでいないサブモードにあること。例えば、エージェントがターミナル内でvimやnanoのようなテキストエディタでファイルを開いた場合、キー入力はエージェントではなくそのエディタに行く。

修正：

• Ctrl+Cを1回または2回押して、エージェントが行っていることをキャンセルし、メインプロンプトに戻す。その後メッセージを再入力。
• ターミナルに直接入力する代わりにエージェント入力オーバーレイを使用。Cmd+I（またはWindows/LinuxでCtrl+I）を押して専用入力ボックスを開き、ターミナルの状態の問題をバイパスしてエージェントにクリーンにプロンプトを送信。
• エージェントが完全にフリーズしているように見える場合、ターミナルタブを右クリックし、ターミナルを再起動を選択して新しいエージェントセッションを開始。

エージェント応答後にスクロールバックが切り捨て

症状： エージェントが長い応答を生成した後、上にスクロールするが特定の距離までしか戻れない。以前の出力が消えている。

修正：

• ターミナルヘッダーのスクロールバックを展開ボタン（ターミナルパネル右上の矢印アイコン）をクリック。これにより一時的により多くの履歴がビューにロード。
• 恒久的な修正の場合、スクロールバック制限を増加：設定 → ターミナル → スクロールバック行数。デフォルトは10,000行。100,000まで上げられる。非常に大きなスクロールバックバッファはより多くのメモリを使用することに注意。

ターミナルに「[detached]」メッセージが表示

ターミナルの上部に[detached (from session main)]のような行が表示されることがあります。これは、1DevToolがバックグラウンドでセッションを存続させるために使用するターミナルマルチプレクサtmuxからのメッセージです。

これは表示が一時的に実行中のセッションから切断され、再接続されたことを意味します。これは完全に正常 — プロジェクトの切り替え、ターミナルの非表示と再表示、またはアプリが最小化状態から復元されたときに典型的に発生。セッションと実行中のプロセスは影響を受けません。

非表示のターミナルが再開せずに新しいセッションを開始

症状： ターミナルをクリックして離れたりパネルを閉じたりして非表示にし、再度開くと、ターミナルが新しく開始 — 以前のコマンドと実行中のプロセスが消えている。

原因： 1DevToolはtmuxを使用してターミナルセッションをバックグラウンドで存続させる。tmuxがインストールされていないか、シェルのPATHにない場合、セッションは永続化できず、毎回最初から再開。

修正： tmuxをインストールし、1DevToolを再起動。

• macOS： brew install tmux
• Linux（Debian/Ubuntu）： sudo apt install tmux
• Linux（Fedora/RHEL）： sudo dnf install tmux

インストール後、1DevToolを完全に終了し、再起動。新しいターミナルセッションは非表示時に永続化される。

ターミナルからの高いCPU使用率

マシンが熱くなったりファンが大きな音で回転したりしている場合、ターミナルプロセスが過剰なCPUを消費している可能性がある。

ソースを特定： 各ターミナルタブにホバー。アクティブなタブはスピニングインジケーターを表示。ターミナルを開き、topまたはhtopを実行してどのプロセスが原因か確認。

停止：

• ターミナルでCtrl+Cを押して実行中のプロセスを中断。
• またはターミナルタブを右クリックし、プロセスをキルを選択して内部で実行しているものを強制終了。

プロセスが暴走したdevサーバーまたはビルドツールである場合、それをキルして通常の開始コマンドで再起動しても安全。