Claude Code CLIの使い方とは？できること・強み・VS Codeとの違いを整理

Claude Code の CLI って結局どう使うの？ ブラウザ版 Claude と何が違うの？ VS Code で使うのとどちらがいいの？ と迷う人は多いです。
ここを雑に理解すると、ただの AI チャットだと思って終わったり、逆に権限を広く渡しすぎて危なくなったりします。

この記事では、2026年4月19日時点で Anthropic の Claude Code 公式ドキュメントを確認しながら、CLI としての Claude Code の使い方、強み、特徴、向いている作業を整理します。
既にある Claudeの使い方全体比較 や おすすめコマンド記事 より、今回は CLI そのものの実務感 に寄せます。

Claude Code CLIとは何か

Anthropic の overview では、Claude Code は lives in your terminal なツールとして説明されています。
つまり、エディタの補完機能やブラウザチャットの延長ではなく、ターミナルの中でリポジトリを読み、必要ならファイルを変更し、コマンドを実行しながら進む前提の道具です。

ここで重要なのは、CLI で Claude に質問する のではなく、CLI を作業環境として Claude と一緒に使う という感覚です。

たとえば次のような流れができます。

• 失敗しているテストを見せて原因を切り分ける
• 既存の実装パターンを探して、それに合わせて修正する
• ログや設定ファイルを読ませて、どこが怪しいか絞り込む
• 修正後にテストや lint を実行して確認する
• その結果を踏まえて追加修正する

この 読む → 直す → 実行する → また直す のループが、Claude Code CLI の中心です。

まずはインストールと起動

Anthropic の getting started では、Claude Code の標準インストール方法として次が案内されています。

npm install -g @anthropic-ai/claude-code

同ページでは、sudo npm install -g は permission 問題や security risk につながるため使わないよう案内されています。
対応 OS は macOS、Ubuntu / Debian、Windows 10+ で、Windows は WSL 1 / WSL 2 / Git for Windows が案内されています。

起動の入口はかなりシンプルです。

claude

これで対話型の REPL が開きます。
最初はここから入るのが一番分かりやすいです。

Claude Code CLIの基本的な使い方

CLI reference では、よく使う入口として次が整理されています。

最初のおすすめは次の3パターンです。

1. 対話型で始める

claude

これはいちばん自然です。
いま開いているプロジェクトで このバグの原因を探して この関数を整理して テストが落ちる理由を見て と頼みながら進めます。

2. 単発で処理する

claude -p "このディレクトリで migration まわりの変更点を要約して"

-p は、スクリプトや一発処理に向きます。
チャットを開きっぱなしにせず、結果だけ欲しいときに使いやすいです。

3. パイプで渡す

cat storage/logs/app.log | claude -p "このエラーの原因候補を3つに絞って"

ログ、diff、テスト出力をそのまま渡せるのが CLI らしい強みです。
GUI に貼るより、そのまま次の処理へつなぎやすくなります。

Claude Code CLIの強み

1. その場で行動できる

Anthropic は Claude Code を not another chat window と位置づけています。
この表現がかなり本質です。

普通のチャット型 AI だと、こう直してください という提案で止まりがちです。
Claude Code CLI は、必要な権限があればファイルを読んで、差分を作って、テストを実行して、結果を踏まえてもう一度直すところまでつながります。

この差は、実務だとかなり大きいです。

• エラーの説明だけではなく、修正まで進めやすい
• 断片コードではなく、リポジトリ全体の文脈を踏まえやすい
• テスト結果を見ながら繰り返し改善しやすい

2. CLIなので再現しやすい

CLI の強みは再現性です。
Claude Code でも、同じ作業をコマンド、設定、CLAUDE.md、hooks、subagents へ落とし込めます。

つまり、今回だけうまくいった で終わらせず、チームのやり方に寄せていきやすいです。

たとえば、

• プロジェクト共通ルールを CLAUDE.md に置く
• .claude/settings.json で権限や禁止ファイルを管理する
• hooks でフォーマットやチェックを差し込む
• subagents でレビュー担当、調査担当の役割を分ける

といった形で、運用を少しずつ固められます。

3. 自動化との距離が近い

CLI reference では、--output-format json がスクリプトや automation に useful だと案内されています。
また、GitHub Actions のドキュメントでは、Claude Code GitHub Actions は Claude Code SDK の上に built されていると説明されています。

つまり Claude Code CLI は、手作業の補助だけでなく、将来的に自動化へつなげやすい入口でもあります。

Claude Code CLIの特徴

権限ベースで動く

security と settings のドキュメントでは、Claude Code は read-only を基本に、編集や bash 実行では permission を求める設計だと説明されています。
このため、便利さと安全性のバランスを自分で作れます。

特に settings では、.claude/settings.json の permissions.deny によって .env や secrets を見えなくする方法が案内されています。
AI に機密情報を読ませたくないなら、会話で注意するだけではなく、設定で見えなくする方が安定します。

スラッシュコマンドで状態を操作できる

slash commands のページでは、/clear、/compact、/permissions、/model、/memory、/mcp、/doctor、/agents などが案内されています。

CLI でよく効くのは、まずこのあたりです。

• /init: プロジェクトの最初の土台を作る
• /permissions: 何を許可するか確認する
• /model: モデルを切り替える
• /cost: セッション消費を確認する
• /compact: 長い会話を圧縮して続ける
• /clear: 別タスクへ切り替える
• /doctor: インストールや接続の調子を見る
• /mcp: MCP 接続を確認する

このあたりの細かい使い分けは、Claude Codeおすすめコマンド｜/compactと翻訳ワークフローのコツ で詳しく整理しています。

memory、hooks、subagentsで育てられる

Claude Code の面白さは、1回限りの会話で終わらないことです。

memory ドキュメントでは、Claude Code が CLAUDE.md を使ってプロジェクトごとの前提を持てると説明されています。
hooks ドキュメントでは、ツール実行の前後にコマンドを差し込めます。
subagents ドキュメントでは、役割を絞った AI サブエージェントを作れます。

この3つがそろうと、CLI はかなり 作業環境 らしくなります。

VS Code連携との違い

ここは誤解が多いところです。
Anthropic の IDE integrations では、Claude Code は any IDE with a terminal で使え、さらに VS Code や JetBrains には dedicated integrations があると説明されています。

つまり、関係はこうです。

• Claude Code CLI: 本体
• VS Code integration: その本体を IDE から使いやすくする拡張

VS Code 連携で増える主な価値は、次の通りです。

• diff viewer で差分を見やすい
• 選択中のコードを共有しやすい
• IDE の diagnostics を Claude と共有しやすい
• エディタから起動しやすい

一方で、CLI 単体の良さも残ります。

• ターミナル中心で気持ちよく回せる
• SSH 先、サーバー、WSL、tmux でも扱いやすい
• パイプや shell の文脈とつなぎやすい
• エディタに依存しにくい

なので、VS Code か CLI か は対立ではなく、CLI が本体で、IDE 連携は見やすさ強化 と考えるのが自然です。

どんな人に向いているか

かなり向いている人

• ターミナル作業に慣れている開発者
• バックエンド、インフラ、SRE、運用寄りの人
• コード修正だけでなく、テスト、ログ、設定確認まで一気に見たい人
• 将来的にスクリプト化、CI、自動化にもつなげたい人

最初はVS Code連携の方が楽な人

• ターミナル単体だと差分確認がつらい人
• 選択中のコードを自然に渡したい人
• まず GUI の安心感が欲しい人

まずブラウザ版 Claude からの方が良い人

• コーディングより壁打ちや文章整理が中心
• 権限やローカル実行まではまだ不要
• AI に何を頼めるかの感覚を先に知りたい

よくある失敗

1. ただのチャットツールとして使う

Claude Code CLI の価値は、会話よりも 作業ループ にあります。
提案だけ読んで終わるなら、ブラウザ版 Claude でも足りることがあります。

2. いきなり権限を広げすぎる

--dangerously-skip-permissions のような強い設定を、意味を分からないまま常用するのは危険です。
最初は permission を確認しながら進めて、必要な範囲だけ絞って許可した方が安定します。

3. 秘密情報を見えるままにする

.env、credentials、顧客データ、秘密鍵を普通に読める状態にしておくと、事故の入り口になります。
settings の permissions.deny で読めないようにしておく方が現実的です。

4. 1本のセッションで何でもやる

バグ修正、翻訳、設計相談、レビューを全部つなげると、文脈もコストも膨らみます。
同じ作業は /compact、別作業なら /clear で切る方が精度が落ちにくいです。

パターン別おすすめ

1. 個人開発でまず試したい

おすすめは CLI 単体 です。
claude で入り、/init と /permissions を確認しながら、小さいバグ修正や調査から始めると感覚をつかみやすいです。

2. 既にVS Codeで開発している

おすすめは Claude Code + VS Code integration です。
本体は CLI のまま、差分確認や選択範囲共有を IDE 側で受ける形が扱いやすいです。

3. サーバーや運用寄りの作業が多い

おすすめは CLI 中心 です。
ログ、設定、grep、テスト、シェル履歴との相性が良いので、GUI より気持ちよく回ることがあります。

4. 将来的に自動化まで考えている

おすすめは CLI から始めて、print mode や GitHub Actions へ広げる 形です。
いきなり全部自動化するより、まず手元で安定パターンを作る方が失敗しにくいです。

まとめ

Claude Code CLI は、Claude に質問する窓 ではなく、ターミナルで一緒に作業する環境 として見ると分かりやすいです。
強みは、コードを読む、直す、実行する、確認する、を1つの流れで回しやすいことにあります。

そのうえで、

• ターミナル中心なら CLI
• 差分確認や選択共有も欲しいなら VS Code 連携
• 壁打ち中心ならブラウザ版 Claude

と分けると、かなり迷いにくくなります。

最初は小さな修正、明確なテスト、狭い権限から始める。
そこに CLAUDE.md、permissions、hooks、subagents を少しずつ足していくと、Claude Code CLI はかなり実務の道具らしく育ちます。

参考リンク

• Anthropic Docs: Claude Code overview
• Anthropic Docs: Set up Claude Code
• Anthropic Docs: CLI reference
• Anthropic Docs: Slash commands
• Anthropic Docs: Claude Code settings
• Anthropic Docs: Manage Claude's memory
• Anthropic Docs: Hooks reference
• Anthropic Docs: Subagents
• Anthropic Docs: Add Claude Code to your IDE
• Anthropic Docs: Manage costs effectively
• Anthropic Docs: Claude Code GitHub Actions
• Anthropic Docs: Security