Claude Code 完全ガイド2026
CLI インストール・MCP・料金・実運用パターン
「Claude Code って結局どこまで便利なの?」「Cursor や Copilot とどう違うの?」という問いに、 一次情報と実運用の肌感覚だけで答えるガイドです。コマンド表や料金だけでなく、 本当に効くワークフローとハマりどころまで含めて、エンジニアが 30 分で導入判断できる構成にしています。
1. Claude Code とは — 他ツールと何が違うのか
Claude Code は Anthropic が提供するターミナル常駐型の AI 開発エージェントです。 VS Code の拡張や JetBrains IDE プラグインでも動作しますが、本体は CLI で、 「リポジトリ全体を理解した上で、複数ファイルをまたぐ編集・リファクタ・実装タスクを代行する」 のが最大の特長です。
類似ツールとの立ち位置
| ツール | 得意領域 | Claude Code との違い |
|---|---|---|
| GitHub Copilot | 行単位の補完 | Claude Code は「タスク単位」で複数ファイルを書き換える |
| Cursor | エディタ常駐 | Claude Code は CLI で CI / スクリプト / 非 IDE 環境にも入る |
| OpenAI Codex CLI | CLI 代行 | Claude 系モデル(Opus / Sonnet / Haiku)の強みを直接使える |
| Gemini CLI | 長文コンテキスト | Claude Code は MCP + プロンプトキャッシュで料金と速度の両立が強い |
2. インストールとセットアップ
公式手順:docs.anthropic.com/claude/docs/claude-code (一次情報は常に公式を参照してください)
macOS / Linux
# npm 経由(Node 18+ 推奨)
npm install -g @anthropic-ai/claude-code
# 初回起動 → ブラウザでログイン
claude-code
# Anthropic API キーを別に使いたい場合
export ANTHROPIC_API_KEY="sk-ant-..."
Windows (PowerShell)
npm install -g @anthropic-ai/claude-code
$env:ANTHROPIC_API_KEY = "sk-ant-..."
claude-code
VS Code 連携
Claude Code 公式拡張を VS Code マーケットプレイスからインストールすると、 サイドパネルに Claude チャットが出ます。CLI と同じアカウントで連携するので、 ターミナル派 / IDE 派どちらでもシームレスに切り替え可能です。
3. よく使うコマンドと基本ワークフロー
基本コマンド
claude-code— インタラクティブセッション開始/plan— 現在のタスクを実装する計画をまず立てさせる(いきなりコードを書かせない)/resume— 直近のセッションを再開/cost— セッション内のトークン消費・コスト確認/compact— コンテキストが長くなったら圧縮
推奨ワークフロー(3ステップ)
- タスクを自然文で伝える:コードでも仕様でもなく「何を達成したいか」を書く
- 計画を必ず先に出させる(
plan modeまたは「まず計画を立てて」と依頼) - 計画を承認してから実装:Claude Code が複数ファイルを自動で編集 → 差分を確認 → コミット
4. MCP (Model Context Protocol) で外部ツールと連携する
MCP は Anthropic が提唱した、LLM と外部ツール(DB, API, 業務システム)をつなぐ オープンプロトコルです。Claude Code は MCP サーバに接続することで、 「自分のターミナルから、Slack / Jira / GitHub / BigQuery などを直接操作する」ことが可能になります。
よく使う MCP サーバ
@modelcontextprotocol/server-github— Issue / PR の読み書き@modelcontextprotocol/server-filesystem— 指定フォルダだけを読ませる@modelcontextprotocol/server-postgres— 本番 DB への read-only クエリ- コンテキストモード系 — 大きな出力を Claude のコンテキストに入れずにサンドボックス処理
設定例(~/.claude/claude_desktop_config.json)
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
}
}
}
5. 運営者が毎日やっている活用パターン
このサイト visionhub.jp の運営で実際に Claude Code に回しているワークフローを公開します。 そのままコピーして自分のリポジトリで動かせます。
パターンA: 日次ニュース要約 → スライド化
input/day/MMDD.txtに当日の AI ニュース生テキストを投入- 「このニュースを 5 分で読めるスライドにして、既存テンプレと同じ構造で HTML を書いて」と Claude Code に指示
- 3〜5 分で 1 スライド(5〜8 セクション、コード例・図表つき)が完成 → 目視確認して公開
時間削減: 手作業 45 分 → 5 分
パターンB: 既存スライドへの SEO/OG 一括注入
今まさに Claude Code で組んだ injection スクリプト群がそれです:
scripts/inject_seo_meta.py— description/OG/Twitter Card 一括追加scripts/inject_newsarticle_jsonld.py— Schema.org JSON-LD を全件注入scripts/generate_og_images.py— Pillow で 1200×630 を自動生成
「既存の 278 スライドにこういう meta を冪等に入れるスクリプトを作って」と依頼しただけで、 完全に動くものが 30 分で出来上がりました。
パターンC: リサーチ → Markdown 要約
Anthropic 公式ブログや arXiv の PDF を Claude Code に読ませて、
一次情報のまま 500 字以内で要約させる。
ハルシネーションを抑えたいので 原文にない推測は書かないで、引用部分は行番号も残して
と必ずプロンプトに含めます。
6. 料金・プランと Anthropic API との関係
2026 年 4 月時点の主要プラン(最新は 公式ページ を参照してください):
| プラン | 月額 | 主な対象 | メモ |
|---|---|---|---|
| Claude Pro | $20 | 個人ユーザー | Claude Code を標準プランで利用可能 |
| Claude Max | $100 / $200 | パワーユーザー | Opus を大量利用したい人向け |
| API 従量課金 | トークン単価 | 自社アプリ組込み | プロンプトキャッシュで最大90%削減可能 |
個人開発者が Claude Code を毎日「普通に」使う分には Pro ($20) でほぼ足ります。 巨大なリファクタやバッチ処理を走らせる場合のみ Max か API 直叩きを検討。
7. よくあるハマりどころと回避策
- コンテキストがすぐ溢れる →
/compactか MCP のサンドボックス処理を併用 - ファイルを勝手に壊される → 必ず clean な git branch で動かし、差分を目視レビュー
- 計画なしで書き始めて暴走 →
/planを癖にする。最初に「まず計画して」を言う - 同じ質問でコストが増える → プロンプトキャッシュを前提に、共通指示は最初に1回だけ
- 機密情報が API に乗る不安 → Pro/Max は学習に使われない明記あり。とはいえ秘匿度の高い情報は別途評価
8. FAQ
Q. Copilot と Claude Code、どちらを先に入れるべき?
A. 両方入れる前提で、用途で使い分けるのが正解です。コード中の「次の一行」は Copilot、 「このファイル全体をリファクタして」は Claude Code。
Q. 日本語での指示は精度が落ちる?
A. ほぼ落ちません。Claude 4.x 系は日本語の意図理解が強く、 日常的にそのまま日本語でタスクを渡して問題なく動いています。
Q. オフラインでは使える?
A. 使えません。Anthropic のクラウド API 必須です。社内ネット閉域で使いたい場合は Claude Enterprise プランか、別の On-premise モデルを検討してください。
Q. セキュリティレビューは必要?
A. Pro/Max プランでは学習に利用しない契約ですが、 企業で使う場合は Anthropic の DPA / Subprocessor 一覧 を必ず法務・情報システムに共有して判断を仰いでください。
最終更新:2026-04-19 / このガイドは随時アップデートされます / © 2026 awano27 — AI Intelligence Hub