この記事の目次
Claude Code CLIは何をどこまで担うツールなのか(この記事の射程)
Claude Code CLIは、CLI(コマンドラインインターフェース。ターミナルでテキストの入力と出力によって操作する仕組み)上で動作するAIコーディングエージェントで、対話モードや非対話モードでの指示を通じてコードの読み書きやコマンド実行を行うツールです。
インストール手順や機能の全体像は、すでにClaude Codeの使い方ガイド:インストールから日常利用、応用機能まででまとめており、まだインストールが済んでいない場合は先にインストール手順のガイドを確認しておくとスムーズです。本記事はそこから対象を絞り、ターミナル上での「操作の型」だけに焦点を当てます。具体的には、対話モードと非対話モードの切り替え、セッションの状態管理、スラッシュコマンドと自然文指示の使い分け、ファイル参照やシェル実行の組み込み方です。Git連携やMCP(Model Context Protocol、外部ツールと接続するための仕組み)、Hooks、設定ファイルといった個別機能の深掘りは、それぞれの専門記事に譲ります。
対話モードと非対話モード(-p)はどう使い分けるのか
試行錯誤しながら作業を進めたいなら対話モード、スクリプトやCIに組み込んで一度きりの指示を実行させたいなら非対話モード(-pフラグを使ったワンショット実行)という選び方になります。
対話モードは、ターミナルでclaudeとだけ入力して起動します。この状態では複数のやり取りを重ねながら、途中で方針を変えたり追加の指示を出したりできます。コードの調査や、仕様が固まっていない作業に向いています。
一方、claude -p "指示内容"のように-pフラグを付けて実行すると、対話を開始せずに一度だけ指示を処理して終了します。この形式は、シェルスクリプトや自動化パイプラインの中に組み込みやすく、人手を介さずに動かしたい処理との相性が良い方式です。
| 観点 | 対話モード | 非対話モード(-p) |
|---|---|---|
| 起動方法 | claudeで開始 |
claude -p "指示" |
| 入力の性質 | 複数回のやり取りを重ねる | 一度の指示で完結する |
| 向いている場面 | 調査、試行錯誤、仕様の詰め | 自動化、CI組み込み、定型処理 |
| 終了のタイミング | 明示的に終了させるまで続く | 処理完了と同時に終了する |
CI(継続的インテグレーション)への組み込みをさらに進めたい場合はGitHub Actionsとの連携ガイドが、無人実行の具体例を知りたい場合はブログ自動化の実例が参考になります。
セッションの状態はどう管理すればよいのか(再開・圧縮・クリア)
セッションの状態管理には3つの操作があります。作業を続けたいときは--resumeか--continueで再開し、文脈が膨らんで動作が重くなってきたら/compactで圧縮し、話題を切り替えたいときは/clearで初期化します。
長時間の作業では、やり取りの履歴(コンテキスト)が蓄積していき、応答の精度や速度に影響することがあります。そのため、いま何をしたいかに応じて操作を選び分ける判断が必要になります。
| 操作 | コマンド | 使うタイミング |
|---|---|---|
| 前回の続きから再開する | --resume / --continue |
別のタイミングで同じ作業を続けたいとき |
| 文脈を圧縮する | /compact |
やり取りが長くなり応答が重く感じるとき |
| 履歴を初期化する | /clear |
話題を切り替え、前の文脈を持ち越したくないとき |
セッションを再開しても期待通りに動かない、応答がかみ合わないといった状況にぶつかることもありますが、まずは--resume・/compact・/clearのどれで扱うべき状況かを整理し直すことが、原因の切り分けにつながります。
スラッシュコマンドと自然文の指示はどう使い分けるのか
両者の役割は異なります。スラッシュコマンドは/initや/reviewのように決まった処理を確実に呼び出す手段であり、自然文指示は文脈に応じて柔軟に意図を伝える手段です。
たとえば/initはプロジェクトの初期設定、/reviewはコードレビューに相当する処理を、決まった形で実行します。一方、「このファイルのエラーハンドリングをもう少し丁寧にしてほしい」といった自然文の指示は、決まった処理名がない代わりに、その場の文脈や意図を細かく伝えられます。すべてのスラッシュコマンドを覚える必要はなく、まず「定型処理はコマンド、それ以外は自然文」という判断軸を持っておけば、迷わず選べます。
自然文指示の書き方はプロンプトの書き方ガイドにまとめてあります。/reviewの具体的な使い方はコードレビュー機能のガイドで扱っています。
ファイル参照やシェル実行はどう組み込むのか(@と!の使い方)
@ファイル名と書けば特定のファイルをそのやり取りの文脈に含めて参照でき、!から始めれば任意のシェルコマンドを実行できます。ファイルの内容確認やコマンドの実行結果を、対話の流れの中に自然に組み込める点が特徴です。
たとえば@src/index.tsのように書くと、そのファイルの内容を踏まえた上で次の指示を出せます。複数ファイルにまたがる修正を依頼するときや、変更前の状態を確認しながら作業したいときに役立ちます。!から始める入力はシェルコマンドとして実行され、Git操作と組み合わせた具体的な使い方はGit連携ガイドで扱っていますが、基本的な使い方としては、テストの実行結果やGitの状態をそのまま以降のやり取りの材料にできる、という点を押さえておけば十分です。
ターミナル操作を安全に保つには何を確認すればよいか
権限確認のプロンプトが表示されたら、まず内容を読み、ファイルの削除や上書き、外部への送信など取り消しにくい処理が含まれていないかを確認してから許可するかどうかを判断します。
CLIは指示に従ってコマンドを実行できるため、意図しない操作を許可してしまわないよう、プロンプトの表示内容を確認する習慣が実務上の安全確保につながります。特に、対象ファイルの範囲やコマンドの内容が広すぎないか、一度立ち止まって確認すると安心です。組織やチームでの運用ルールの設計については運用ルールの作り方に、法人・企業利用時のセキュリティ上の論点については企業利用時のセキュリティガイドにまとめています。個人利用であっても、権限プロンプトの内容を都度読む習慣そのものが最も基本的な防御線になります。
操作でつまずいたときはどこを確認すればよいか
原因は大きく、インストール起因・認証起因・実行時エラー・権限やサンドボックスの制約起因の4つに整理すると、切り分けの見通しが立ちます。
インストール直後であればインストール手順の見直しが先決ですし、認証エラーであればログイン状態の確認が優先されます。実行の途中で止まる場合は、指示の内容や参照しているファイルの範囲が原因になっていることもあります。詳細な切り分け手順はエラー・トラブルシューティングガイドに譲りますが、バージョンの更新が原因になっている場合はアップデートガイドも確認しておくと切り分けの手がかりになります。
まとめ
本記事では、対話モードと非対話モードの使い分け、セッションの再開・圧縮・クリアによる状態管理、スラッシュコマンドと自然文指示の役割分担、@と!によるファイル参照・シェル実行、そして権限確認における安全確認という、CLI操作の型を順に確認しました。
型を覚えたら、次は実際の業務やコードに当てはめながら手を動かし続けることが定着への近道になります。一人で試行錯誤を続けるのも一つの道ですが、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」では、Claude Codeを自分の手で使いこなせるようになるまで、学びを継続できる場を用意しています。操作の型を実務に落とし込む段階で行き詰まりを感じたときは、選択肢の一つとして覗いてみてください。