Claude Code をターミナルで実行すると出会う対話型セッション (REPL) の入力方式とショートカット、権限モードを整理します。

背景リファレンス

このページは、MoAI-ADK が動作する基盤である Claude Code そのもの を解説する背景資料です。MoAI-ADK 自体の機能は、サイドバーの上位セクションで扱います。

情報

ひとことで言うと: 対話モードは Claude Code の コックピット であり、プロンプト 1 行から / コマンド、! の bash 実行、@ のファイル参照、画像の貼り付けまで、すべての入力が集まる場所です。

claude コマンドを実行すると対話型 REPL (Read-Eval-Print Loop) が開きます。ここでは自然言語でリクエストを送り、Claude がコードを読み、修正し、コマンドを実行しながら応答します。1 回のリクエストと応答を ターン (turn) と呼び、セッションが生きている間は会話のコンテキストが蓄積されます。

基本フローはシンプルです。

1. claude 実行 → 対話型セッション開始
2. プロンプト入力 → Enter で送信
3. Claude が応答 (ツール呼び出し + 結果)
4. 後続リクエストを繰り返す → コンテキスト蓄積
5. /clear で新しいセッション、Ctrl+D で終了

セッション中は作業ディレクトリごとに入力履歴が保存され、複雑な多段階作業では Claude がタスクリストを作って進捗を追跡します。

対話型セッションの入力欄は、単純なテキスト入力ではありません。最初の文字によって動作が変わります。

入力欄の先頭で / を打つと、使用可能なすべてのコマンドメニューが表示されます。組み込みコマンドだけでなく、バンドルスキル、ユーザー作成スキル、プラグインや MCP サーバーが提供するコマンドまでが 1 つのメニューに集まります。/ の後に文字を続けて入力すると、候補がリアルタイムで絞り込まれます。詳しい一覧は スラッシュコマンド を参照してください。

! で始めるとシェルモードに切り替わり、コマンドが Claude の解釈なしにそのまま実行されます。

! npm test
! git status
! ls -la

シェルモードはコマンドとその出力を会話コンテキストに追加するため、素早いシェル作業をしながらも Claude が結果を把握できます。長いコマンドは Ctrl+B でバックグラウンドへ送れ、空の入力で Escape か Backspace を押すとシェルモードを抜けます。

@ を入力するとファイルパスの補完が表示されます。目的のファイルを選択すると、そのファイルを Claude のコンテキストに取り込み、「このファイルを直して」のようなリクエストを正確に送れます。

スクリーンショットやデザイン案を Ctrl+V で貼り付けると、カーソル位置に [Image #N] チップが挿入されます。チップはプロンプト内で位置基準で参照できるため、テキストと画像を混ぜて説明できます。

対話型セッションの主要ショートカットです。プラットフォームやターミナルによって一部の動作が異なる場合があります。

入力欄が空のときに Esc を 2 回押すと 巻き戻しメニュー (rewind menu) が開きます。以前の時点へコードと会話を復元したり要約したりできる機能で、詳細は チェックポインティング で扱います。

Ctrl+R で過去のコマンドを対話的に検索します。検索語を入力すると一致部分がハイライトされ、Ctrl+R を再度押すとより古い一致項目へ移動します。Ctrl+S で検索範囲 (このセッション / このプロジェクト / すべてのプロジェクト) を切り替え、Tab や Esc で受け入れて編集、Enter で即実行します。

Alt+B、Alt+F、Alt+P のような Option キーの組み合わせは、macOS ではターミナルの Option を Meta に設定しないと動作しません。iTerm2 では Keys 設定で Option を「Esc+」に、Apple Terminal では「Use Option as Meta Key」を有効にする必要があります。

Claude Code は、ファイル修正とコマンド実行をどこまで自動で許可するかを 権限モード (permission mode) で調整します。Shift+Tab でモードを循環切り替えできます。

flowchart TD
    A[Shift+Tab で
モード循環] --> B[default
毎回承認を要求]
    B --> C[plan
計画のみ立案]
    C --> D[acceptEdits
編集を自動承認]
    D --> E[bypassPermissions
プロンプトをバイパス]
    E --> B

bypass モードは権限確認をスキップするため、信頼できる分離環境でのみ使うのが安全です。MoAI-ADK もワークフローの段階に合わせてこれらのモードを活用します。特に plan モードは、MoAI-ADK の「計画は深くレビューし、実装は承認後に始める」という実装着手承認ゲート (plan→run ヒューマンゲート) とまったく同じ哲学の上にあります — 高価な実装ターンに入る前に、安価な読み取り専用ターンで方向を確定するのが、トークンの観点でも最も経済的です。

1 つのプロンプトに複数行を入力する方法はターミナルごとに異なります。

VS Code、Cursor、Windsurf、Zed などで Shift+Enter バインディングが必要なら /terminal-setup を実行すれば設定されます。

/config の Editor mode で vim スタイルの編集を有効にできます。NORMAL モードと INSERT モードを Esc と i/a で行き来し、h/j/k/l の移動、dd/yy/p の編集、iw/a" のようなテキストオブジェクトまで、慣れ親しんだ vim の動作をそのまま使えます。ただし Ctrl+V の矩形ビジュアルモードには対応していません。

/config でテーマや表示オプション、セッション要約 (Session recap) といった設定を調整します。そのほかよく使う付加機能は次のとおりです。

• /btw: 会話履歴を汚さずに現在の作業について素早く質問します。回答は一時的なオーバーレイとしてのみ表示されます。
• /recap: セッションの要約 (session recap) を生成します。自動では 3 分以上または 3 ターン以上進行したセッションで有効になります。
• タスクリスト: 多段階作業で Claude が作ったタスクリストを Ctrl+T で展開・折りたたみします。タスクリストはコンテキスト圧縮の間も維持されます。
• 拡張思考トグル: Option+T (macOS) または Alt+T で拡張思考モードをオン/オフします。

• スラッシュコマンド
• チェックポインティング
• クイックスタート

• Claude Code Interactive mode (公式ドキュメント)

ヒント

最初は Shift+Tab で plan モードから始めて Claude のアプローチを確認し、信頼が積み上がったら acceptEdits へ切り替える流れが、最も安全かつ速い方法です。