Claude Code基礎 ターミナルAI開発入門

Claude Codeとは -- CLIベースAI開発の全体像

GUIチャットとの根本的な違い

claude.aiのチャット画面にコードを貼り付けて回答をコピーする。その往復が開発の全体像だとすれば、Claude Codeはその枠を壊します。ファイルシステムへの直接アクセス、Bashコマンドの実行、Git操作、プロジェクト全体の文脈把握。ブラウザでは不可能だった操作をターミナルから一気に処理できるのがCLIベースのAI開発です。

「AIにコードを書いてもらう」段階から「AIと一緒に開発する」段階へ。言葉は似ていますが、体験はまったく別物になります。

%%{init:{'theme':'dark','themeVariables':{'primaryColor':'#00A5BF','primaryBorderColor':'#007A8F','primaryTextColor':'#e8e8e8','lineColor':'#00A5BF','secondaryColor':'#1a1a1a','background':'#141414','mainBkg':'#1a1a1a','nodeBorder':'#00A5BF'}}}%%
graph LR
  A["ユーザー入力
(自然言語)"] --> B["Claude Code CLI"]
  B --> C["Anthropic API
(Claude)"]
  C --> D["ツール実行"]
  D --> E["Read / Edit / Write"]
  D --> F["Bash / Grep / Glob"]
  D --> G["Git / MCP"]
  E --> H["結果表示"]
  F --> H
  G --> H
  H -.->|継続対話| B

何ができるのか

• ファイル操作 -- プロジェクト内のファイルを読み、編集し、新規作成する
• シェルコマンド実行 -- npm install、テスト実行、ビルドなどをCLI上から直接
• コードベース全体の検索 -- 特定の関数やパターンをGrep/Globで横断検索
• Git操作 -- コミット、ブランチ操作、差分確認をAIに委任
• MCP連携 -- 外部ツール(GitHub、DB、Slack等)と標準プロトコルで接続

動作環境と料金

claude.ai vs Claude Code vs Claude API -- 使い分け

インストール確認

インストールが完了したら、バージョン確認で動作を確認できます。

バージョン番号は更新されるため、数字が異なっていても問題ありません。コマンドが認識されていれば正常です。

料金プランの比較: Max plan vs API従量課金

基本操作マスター -- ファイル操作、コード生成、検索

Claude Codeが持つツール一覧

Claude Codeは内部で複数のツールを持っています。どのツールを使うかはClaude Codeが自動判断するため、ユーザーはツール名を意識する必要はありません。ただし、ツールの存在と役割を知っておくと、指示の精度が上がります。

効果的な指示の出し方

Claude Codeへの指示は、具体的であるほど精度が高くなります。「コードを直して」ではなく「src/index.jsの23行目にあるfetchのエラーハンドリングを追加して」のように、対象ファイル、対象箇所、操作内容を明示するのが鍵です。

ツール使い分け判断表

Claude Codeはどのツールを使うか自動判断しますが、内部ロジックを知っておくと「なぜこのツールが選ばれたのか」が理解でき、指示の精度も上がります。

CLAUDE.mdの設計 -- AIの行動をルールで制御する

CLAUDE.mdとは何か

プロジェクトルートに置く「AIへの永続的な指示書」です。通常のチャットでは、毎回プロジェクトのルールやコーディング規約を伝え直す必要があります。CLAUDE.mdがあれば、Claude Codeは起動時にこのファイルを自動で読み込み、そのルールに従って動作します。

人間の新メンバーにオンボーディング資料を渡すのと同じ発想です。プロジェクトの前提知識をドキュメントとして渡しておけば、AIは毎回ゼロから説明を受ける必要がなくなります。

推奨テンプレート構成

CLAUDE.md vs .claude/settings.json

両者は補完関係にあります。CLAUDE.mdは人間も読める自然言語のルール。settings.jsonはツール許可やMCP設定などの構造化されたマシン設定です。

階層構造

CLAUDE.mdは3つのレベルで配置でき、より具体的なレベルが優先されます。

コマンドとスキル -- カスタマイズで生産性を上げる

組み込みスラッシュコマンド

Claude Codeには最初から使えるコマンドが用意されています。対話中に / を入力すると候補が表示されます。

/init -- CLAUDE.mdの自動生成

/init コマンドは、プロジェクトの構成を自動分析し、CLAUDE.mdの初版を生成します。新しいプロジェクトでClaude Codeを使い始めるときに最初に実行すべきコマンドです。

/init が生成するCLAUDE.mdは出発点であり、そのまま使うものではありません。自動生成された後に、プロジェクト固有のルール(社内コーディング規約、セキュリティ方針、禁止事項など)を手動で追記・修正してください。

/review -- コードレビュー

/review はgit diffの結果を読み取り、変更内容に対するレビューコメントを返します。PRを出す前のセルフチェックに適しています。

カスタムコマンドの作り方

プロジェクト内に .claude/commands/ フォルダを作り、Markdownファイルを置くだけです。ファイル名がコマンド名になります。

$ARGUMENTS 変数を使えば、コマンド実行時に引数を受け取れます。

実行例: /explain src/utils/helper.js

スキル

.claude/skills/ フォルダに配置するのがスキルです。コマンドが「短い指示テンプレート」なら、スキルは「複雑な手順書」の位置づけになります。特定の技術やワークフローに関する詳細なガイドラインを記述できます。

権限とセキュリティ -- 安全に使うための設定

権限モデルの仕組み

Claude Codeはツールを実行する前に、そのツールが「自動許可」されているか「確認が必要」かを判断します。settings.jsonでこの挙動を制御できます。

%%{init:{'theme':'dark','themeVariables':{'primaryColor':'#00A5BF','primaryBorderColor':'#007A8F','primaryTextColor':'#e8e8e8','lineColor':'#00A5BF','secondaryColor':'#1a1a1a','background':'#141414','mainBkg':'#1a1a1a','nodeBorder':'#00A5BF'}}}%%
graph TD
  A["ツール実行リクエスト"] --> B{"allowedTools
に含まれる?"}
  B -->|Yes| C["自動実行"]
  B -->|No| D{"disallowedTools
に含まれる?"}
  D -->|Yes| E["実行拒否"]
  D -->|No| F["ユーザーに確認"]
  F --> G{"許可する?"}
  G -->|Yes| C
  G -->|No| E

settings.jsonの構造

allowedToolsに入れたツールはユーザー確認なしに自動実行されます。Read、Grep、Globのような「読むだけ」の操作は自動許可にしておくと快適です。一方、ファイル削除やforce pushのような破壊的操作はdisallowedToolsで完全にブロックできます。

機密ファイルの保護

CLAUDE.mdにセキュリティルールを書くことで、AIが触るべきでないファイルを指定できます。

チーム開発での運用

MCP連携入門 -- 外部ツールとの統合

MCP(Model Context Protocol)とは

AIが外部ツールと通信するための標準プロトコルです。USBがどのメーカーの周辺機器でも接続できるように、MCPはどのAIツールからでも外部リソースに統一的にアクセスできる仕組みを提供します。

MCPがない世界では、GitHub連携、Slack連携、DB連携をそれぞれ個別に実装する必要がありました。MCPがあれば、1つのプロトコルで全てに対応できます。

%%{init:{'theme':'dark','themeVariables':{'primaryColor':'#00A5BF','primaryBorderColor':'#007A8F','primaryTextColor':'#e8e8e8','lineColor':'#00A5BF','secondaryColor':'#1a1a1a','background':'#141414','mainBkg':'#1a1a1a','nodeBorder':'#00A5BF'}}}%%
graph LR
  A["Claude Code"] --> B["MCP Protocol"]
  B --> C["filesystem
MCPサーバー"]
  B --> D["GitHub
MCPサーバー"]
  B --> E["PostgreSQL
MCPサーバー"]
  B --> F["Slack
MCPサーバー"]
  C --> G["ローカルファイル"]
  D --> H["リポジトリ/PR/Issue"]
  E --> I["データベース"]
  F --> J["チャンネル/メッセージ"]

MCPサーバーの種類

設定方法

MCPサーバーの設定は .mcp.json ファイルに記述します。プロジェクトルートに置くか、settings.jsonのmcpServersセクションに書くかの2つの方法があります。

複数サーバー接続の設定例

実際のプロジェクトでは、複数のMCPサーバーを同時に接続するケースが一般的です。

各サーバーの command にはnpxを指定するのが最も簡単な方法です。初回実行時にパッケージが自動ダウンロードされます。env でサーバー固有の環境変数(APIトークン等)を渡せます。

実践ワークフロー -- 日常開発での使い方パターン

ワークフロー1: バグ修正フロー

エラー報告を受けてから修正完了までを、Claude Codeで一気通貫に処理するパターンです。

ワークフロー2: 新機能開発フロー

仕様を自然言語で記述し、実装からテストまでをClaude Codeに委任するパターンです。

ワークフロー3: ドキュメント整備フロー

既存コードを読解してドキュメントを自動生成するパターンです。READMEの更新、APIドキュメント生成、コメント追加に向きます。

効率的な使い方のコツ

トレンド -- Claude Code進化とIDE統合、Agent SDK

IDE統合の広がり

Claude Codeはターミナル専用のCLIとして始まりましたが、VS CodeやJetBrains IDEへの統合が進んでいます。ターミナルを離れずに開発するスタイルと、IDEの補完やデバッグ機能を組み合わせるスタイルの両方が選べるようになっています。

Agent SDK

Claude CodeをプログラムのCLIとしてではなく、SDKとして組み込む手段が提供されています。これによりClaude Codeの能力をCI/CDパイプラインや自動化スクリプトに統合できます。

サブエージェント(Agent tool)

Claude Code内でサブエージェントを起動し、タスクを並列実行する機能です。大きなリファクタリングを複数のエージェントで分担させたり、worktreeで分離して安全にテストするといった使い方が可能になります。詳細はC07応用コースで扱います。

フック/プラグイン

ツール実行の前後に自動処理を挟む「フック」や、Claude Codeの機能を拡張する「プラグイン」の仕組みが整備されつつあります。例えば、Writeツール実行後に自動でPrettierを走らせる、コミット前にLintを実行する、といった自動化が可能です。

自律開発エージェントへの道

現在のClaude Codeは人間がプロンプトを入力し、AIが応答する対話型です。今後は、Issueの内容を読んで自動的にブランチを切り、実装し、テストし、PRを作成する「自律型」の方向に進化が見込まれます。Claude Codeの --headless オプションや cron トリガーはその布石です。

総合ハンズオン: CLAUDE.md + コマンド + MCPで開発環境構築

ゴール

このセクションでは、コース全体で学んだ内容を統合し、実務で使える完全な.claude/ディレクトリ構成を完成させます。既存の自分のプロジェクトを使っても、新規プロジェクトで始めても構いません。

完成形のディレクトリ構成

ダウンロードテンプレート

各ファイルのテンプレートをダウンロードできます。