HUB · DEVELOPER TOOLS

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 CLICLI 代行Claude 系モデル(Opus / Sonnet / Haiku)の強みを直接使える
Gemini CLI長文コンテキストClaude Code は MCP + プロンプトキャッシュで料金と速度の両立が強い
運営者メモ。「補完」ではなく「意図を伝えたら複数ファイルを並行編集して帰ってくる」 のが Claude Code の本質です。visionhub.jp の日次スライド更新・sitemap 自動化・OG 画像生成といった作業は、 ほぼすべて Claude Code に「こうしたい」と自然文で渡すだけで回っています。

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ステップ)

  1. タスクを自然文で伝える:コードでも仕様でもなく「何を達成したいか」を書く
  2. 計画を必ず先に出させるplan mode または「まず計画を立てて」と依頼)
  3. 計画を承認してから実装:Claude Code が複数ファイルを自動で編集 → 差分を確認 → コミット
運営者の使い分け。細かい補完は Cursor / Copilot、 「1時間かけて複数ファイルを書き換える仕事」は 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: 日次ニュース要約 → スライド化

  1. input/day/MMDD.txt に当日の AI ニュース生テキストを投入
  2. 「このニュースを 5 分で読めるスライドにして、既存テンプレと同じ構造で HTML を書いて」と Claude Code に指示
  3. 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