Claude Codeのターミナルとは？開き方と基本操作・設定の直し方

Claude Codeのターミナルとは、コマンドラインで文字を打って指示を出し、結果も文字で返ってくる「CLI版」のClaude Codeを動かす画面のことです。Macの「ターミナル」やWindowsの「PowerShell」で、インストール後に claude と打つと起動し（初回はログインします）、やりたいことを普段の言葉で書けばファイルの読み書きやコマンドの実行まで進めてくれます。公式ドキュメントは、Claude Codeがターミナル、IDE、デスクトップアプリ、ブラウザで使えるとし、どの画面でも同じエンジンが動くと説明しています。この記事では、ターミナル版を選ぶ理由、開き方、ターミナル版で使うキー操作、そして改行や通知が効かないときの設定の直し方を、公式資料の記述に沿って整理します。

Claude Codeのターミナル版と、デスクトップ版・IDE拡張は何が違う？

中身のエンジンは共通で、違うのは「どの画面から操作するか」と「使える機能の範囲」です。公式の比較表では、CLI（ターミナル版）はターミナル中心の作業、スクリプト実行、リモートサーバーでの利用に向き、機能が最も揃っているとされています。スクリプトからの実行とAgent SDKはCLIだけの機能です。

画面	公式が挙げる向いている用途
CLI（ターミナル版）	ターミナル中心の作業、スクリプト、リモートサーバー
デスクトップアプリ	差分の目視確認、複数セッションの並行
VS Code / JetBrains	VS CodeやIntelliJ、PyCharmなどのエディタから離れずに使う
Web	指示が少なくて済む長い作業（接続を切っても続く）

デスクトップアプリとIDE拡張は、CLI専用の機能の一部と引き換えに、差分を目で確認しやすい画面やエディタとの連携を得る位置づけです。設定、プロジェクトのメモリ、MCPサーバーはローカルの各画面で共有されるため、同じプロジェクトでターミナル版とデスクトップ版を併用しても設定を二重に持つ必要はありません。

どれから始めるか迷う場合、公式は「CLIを入れてプロジェクトのフォルダで実行する」ことを入口に挙げ、ターミナルを使いたくなければデスクトップアプリで同じエンジンをGUIで使えるとしています。デスクトップ版の詳細はデスクトップアプリの記事、エディタ内で使う場合はVS Code拡張の記事にまとめています。

ターミナルはどうやって開く？OS別の手順

公式の初心者向けガイドが示す、各OSでのターミナルの開き方は次のとおりです。WindowsのPowerShellは、どのWindowsにも最初から入っていると公式に書かれています。

macOS: Cmd + Space でSpotlight検索を開き、「Terminal」と入力して Enter
Linux: 多くのディストリビューションで Ctrl + Alt + T、またはアプリ一覧で「Terminal」を検索
Windows: Win + X を押し、メニューから「Windows PowerShell」（または「Terminal」）を選ぶ

カーソルが点滅しているウィンドウが出れば、そこが命令を打ち込む場所です。

Windowsには見た目の似た「PowerShell」と「CMD（コマンドプロンプト）」の2つがあり、インストール用のコマンドが異なります。行の先頭が PS C:\Users\...> ならPowerShell、PS が付かず C:\Users\...> ならCMDです。動作環境は、macOSは13.0以降、Windowsは10のバージョン1809以降が必要と公式に書かれています。

インストールコマンドの実行から先はインストール方法の記事で扱っています。Windowsで実行環境（PowerShellかWSLか）を選ぶ段階ならWindowsでの導入ルートの記事を先に読むと迷いません。

ターミナルでClaude Codeを起動して最初に何を打てばいい？

インストールが済んだら、起動手順として新しいターミナルのウィンドウでまず次のコマンドを打ち、バージョン番号が表示されるかを確認します。

claude --version

番号が出たら、作業したいプロジェクトのフォルダへ移動してから起動します。/path/to/your/project の部分は自分のフォルダのパスに置き換えます。

cd /path/to/your/project
claude

初回はログインを求められ、Claudeの契約かClaude Consoleのアカウントならブラウザで認証します。使えるのはClaudeのPro・Max・Team・Enterpriseの契約、Claude Consoleのアカウント、または対応するクラウド事業者経由のアクセスです。一度ログインすると認証情報が保存され、次回からは入力不要です。

起動すると、入力欄の上にバージョン、使用中のモデル、作業フォルダが表示されます。最初の一言は、公式のクイックスタートでも例に挙がっている次のような質問が向いています。

what does this project do?

公式は、やりたいことを普段の言葉（natural language）で説明するよう案内しています。Claude Codeは必要なファイルを自分で読みにいくため、こちらからファイルの中身を貼り付けて文脈を足す必要はありません。同じフォルダで直前の会話を続ける claude -c などの起動方法は起動方法の記事、日常の対話操作はCLIの使い方の記事で扱っています。

ターミナル版で最初に覚えるキー操作は？

公式の初心者向けガイドは、ターミナルではクリックではなく矢印キーで移動するよう案内しています。まず覚えたい基本のキー入力は次のとおりです。

やりたいこと	操作
送信する	`Enter`
送信せずに改行する	`Ctrl+J`、または `\` を打ってから `Enter`（どのターミナルでも設定不要）
実行中のClaudeを止める	`Esc`（それまでの作業内容は保持される）
入力を消す・終了する	何も実行していないとき `Ctrl+C` を1回で入力を消去、2回で終了
Claude Codeを終える	`exit`、または空の入力欄で `Ctrl+D` を2回
コマンド一覧を見る	`/help`、または `/` を打つと使えるコマンドとスキルが出る
前に打った内容を呼び出す	`↑`
画面が崩れたとき	`Ctrl+L` で再描画（入力と会話は残る）

長い依頼を書いている途中で Enter を押すと途中で誤送信されてしまうので、改行には Ctrl+J を使う、と覚えておくと事故が減ります。

ターミナルで使える便利な操作が、入力の先頭に ! を付ける「シェルモード」です。Claudeを介さずにコマンドをそのまま実行し、その出力を会話に取り込みます。

! git status

公式のインタラクティブモードのページによると、取り込んだ出力にはClaudeが自動で応答するので、! npm test のように打てば、もう一度頼まなくても失敗についての説明を受けられます。この自動応答には、通常の依頼を送ったときと同じコストがかかると公式に書かれています。

勝手にファイルを書き換えたりしない？確認の仕組み

ファイルの編集やコマンドの実行をどこまで確認なしで進めるかは、「権限モード」で決まります。Shift+Tab を押すと、実行中のセッションの権限モードをいつでも切り替えられます。

ここで押さえておきたいのは、最初にどのモードで始まるかです。公式の権限モードのページによると、v2.1.283以降は対話型のターミナルとVS Codeのセッションで「auto」モードが既定の開始モードになっています。autoモードでは、利用者の代わりに別のモデル（分類器）が操作を審査します。autoが使えない環境（設定で無効化されている、対応しないモデルなど）ではManualモードで始まります。

Manualモード（設定ファイル上の値は default、CLIでは manual も別名として使える）では、ファイルの編集、シェルコマンドの実行、ネットワークへのアクセスの多くで、実行前に確認を求められます。一つずつ自分の目で承認したい場合は、Shift+Tab でManualに切り替えるか、claude --permission-mode manual のように起動時に指定します。確認画面が出たら内容を読み、承認する場合は「Yes」を選びます。

各モードの違いと選び方は権限モードの記事で詳しく扱っています。

改行・Optionキー・通知が効かないときはどう直す？

公式は「Claude Codeはどのターミナルでも設定なしで動く」としたうえで、期待どおりに動かない症状があるときのためのターミナル設定ページを用意しています。ターミナルの種類によって差が出るのは主に次の4点です。

Shift+Enterで改行できない。 Ghostty、Kitty、iTerm2、WezTerm、Warp、Macの標準ターミナル、Windows Terminalでは設定なしで使えます。VS Code、Cursor、Alacritty 0.16未満、Zedのターミナルでは、Claude Codeの中で /terminal-setup を1回実行するとキー設定が書き込まれます。gnome-terminalとJetBrains系IDEのターミナルではShift+Enterは使えないので、Ctrl+J を使います。/terminal-setup はtmuxやscreenの中ではなく、外側のターミナルで実行します。

MacでOptionキーのショートカットが反応しない。 Macの多くのターミナルは、初期状態ではOptionキーを修飾キーとして送りません。Macの標準ターミナル（Apple Terminal）なら、公式の案内では「Settings → Profiles → Keyboard」で「Use Option as Meta Key」にチェックを入れます。公式はApple Terminalについて、Claude Codeの初回起動時に出るターミナル設定の案内を受け入れていれば、この設定は済んでいるとしています。iTerm2では「Settings → Profiles → Keys → General」で左右のOptionキーを「Esc+」にします。

作業が終わっても通知が来ない。 公式によると、デスクトップ通知が既定で出るのはGhostty、Kitty、iTerm2だけです。それ以外のターミナルでは、~/.claude/settings.json に次の項目を加えると、通知の代わりにターミナルの通知ベルが鳴ります。すでに設定ファイルがある場合は、中身を置き換えずにこのキーを追加します。

{
  "preferredNotifChannel": "terminal_bell"
}

tmuxの中で改行や通知が効かない。 tmux内では既定でShift+Enterが送信扱いになり、通知も外側のターミナルに届きません。~/.tmux.conf に次の3行を追加し、tmux source-file ~/.tmux.conf で反映します。

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

このほか、画面がちらつく、スクロール位置が飛ぶ場合は /tui fullscreen で全画面表示モードに切り替えられます。Windowsで Backspace を押すたびに単語ごと消える場合は、環境変数 CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0 を設定すると1文字ずつ消えるようになります。配色は /theme でClaude Code側を合わせます。ターミナル自体の配色はClaude Codeからは変えられません。

長いログやファイルを貼り付けると、800文字か3行を超えた時点で [Pasted text #1 +120 lines] のような表示に折りたたまれますが、送信時には全文が送られます。大きな内容は、ファイルに保存して「このファイルを読んで」と頼む方が会話を読みやすく保てる、と公式は案内しています。

ターミナルで起動できないときは？表示されたエラー別の確認方法

ここでは、PATHやシェルの取り違えなど、コマンドを打つ場所に関係するエラーを扱います。表示されたメッセージごとに、公式が示す原因は次のとおりです。

command not found: claude（Mac/Linux）、'claude' is not recognized（Windows）。 インストール後にこの表示が出る場合、公式はインストール先のフォルダがPATH（コマンドを探す場所の一覧）に入っていないことを原因に挙げています。インストーラーが最後に「Setup notes」として表示する修正コマンドを実行し、新しいウィンドウで claude を打ち直します。Macの標準シェル（Zsh）の場合、公式の修正手順は次の2行です。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

'irm' is not recognized。 PowerShell用のコマンドをCMDで打っています。PowerShellを開き直すか、CMD用のインストールコマンドを使います。逆に The token '&&' is not a valid statement separator と出たら、CMD用のコマンドをPowerShellで打っています。

syntax error near unexpected token '<' や、HTMLのような文字列が出る。 インストーラーの代わりにWebページが返ってきています。ページに「App unavailable in region」とあれば、提供対象外の国からのアクセスです。そうでなければ、もう一度実行します。

Windowsでコマンド実行の挙動が説明と違う。 ネイティブのWindowsではGit for Windowsの導入が推奨されており、入っていない場合、Claude CodeはBashの代わりにPowerShellをコマンド実行に使います。

ここに当てはまらないエラー（ログイン、ネットワーク、利用上限など）は、エラーを原因別に切り分ける記事で分類しています。なお、この記事のバージョン番号や対応ターミナルの一覧は、2026年10月19日に確認した公式ドキュメントの記述に基づきます。挙動が記事と違う場合は、claude --version でバージョンを確認してから、公式のターミナル設定ページと初心者向けターミナルガイドを見直してください。

ターミナルに慣れたあと、次に何を学ぶか

ターミナルを開き、claude で起動し、Ctrl+J で改行しながら依頼を書き、Esc で止められるようになれば、ターミナル版を使い始める準備は整っています。次に効いてくるのは、依頼の書き方です。プロンプトの書き方の記事から読み進めると、同じ依頼でも結果の質が変わる理由がつかめます。