トラブルシューティング: ターミナル
ターミナルのよくある問題の解決方法 — 出力が空白になる、入力できない、AI エージェントの不具合など。
ターミナルは開くが、入力しても何も表示されない
症状: キーを押してもターミナルに何も表示されない、またはターミナルが空白の画面のまま変わらない。
考えられる原因と対処法:
シェル初期化ファイルのエラー。 シェルの起動ファイル(.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 セッションに切り替えてください。
クイックリセット。 ターミナルタブ上の任意の場所を右クリックし、Restart Terminal を選択します。パネルを閉じずに、現在のシェルプロセスを終了して新しいシェルを起動します。
AI エージェントが入力に反応しない
症状: エージェントターミナルにプロンプトを入力しても何も起こらない — スピナーも、応答も、確認表示もない。
最も多い原因は、エージェントのインターフェースが入力を読み取らないサブモードになっていることです。たとえば、エージェントがターミナル内で vim や nano などのテキストエディタでファイルを開いた場合、キー入力はエージェントではなくそのエディタに送られます。
対処法:
- Ctrl+C を 1 〜 2 回押して、エージェントが行っている処理をキャンセルし、メインのプロンプトに戻します。その後、メッセージを入力し直してください。
- ターミナルに直接入力する代わりに Agent Input Overlay を使います。Cmd+I(Windows/Linux では Ctrl+I)を押すと専用の入力ボックスが開き、ターミナルの状態に左右されずにプロンプトをエージェントへ確実に送信できます。
- エージェントが完全にフリーズしているように見える場合は、ターミナルタブを右クリックして Restart Terminal を選択し、新しいエージェントセッションを開始してください。
エージェントの応答後にスクロールバックが途切れる
症状: エージェントが長い応答を出力した後、上にスクロールしても一定の位置までしか戻れず、それ以前の出力が消えている。
対処法:
- ターミナルヘッダー(ターミナルパネル右上の矢印アイコン)にある Expand scrollback ボタンをクリックします。より多くの履歴が一時的にビューに読み込まれます。
- 恒久的に対処するには、スクロールバックの上限を引き上げます。Settings → Terminal → Scrollback Lines を開いてください。デフォルトは 10,000 行で、最大 100,000 行まで増やせます。スクロールバックバッファが非常に大きいと、メモリ使用量が増える点にご注意ください。
スクロールバックの文字が乱れる、または重なって表示される
症状: ペインのサイズ変更後やターミナルを開き直した後に、古い履歴で行が混ざる、不要な文字が表示される、ブロックが重複するなどの現象が起きる。
対処法: ターミナル上に表示されるアンバー色の Repair view ピルを探してください。履歴の一部が現在のペイン幅とは異なる幅で描画されていた場合に表示されます。クリックすると、ターミナル自身が持つ幅に正確な行データからビューが再構築されます。
ターミナルに「[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 を押して、実行中のプロセスを中断します。
- または、ターミナルタブを右クリックして Kill Process を選択し、内部で実行中のものを強制終了します。
暴走した開発サーバーやビルドツールが原因の場合は、そのまま終了させて、通常の起動コマンドで再起動して問題ありません。