はじめに — コードを書くAI、コードを書かせるあなた

Claude Codeは「AIにコードを書かせる」ツールではない。「AIと一緒にコードを書く」ツールだ。この違いが、すべてを変える。

コードを書く医師が増えている

2025年、ある変化が静かに医療界に広がった。

コードを書く医師が増えている。

電子カルテのデータを分析するPythonスクリプト、患者説明用のWebアプリ、論文のメタアナリシス用のRスクリプト。かつては情報工学の専門家に依頼していた作業を、臨床医自身がAIの力を借りて行うようになった。

その背景にあるのが、AIコーディングアシスタントの進化だ。

ChatGPTやClaudeに「こういうプログラムを書いて」と頼むと、それなりのコードが返ってくる。しかし、Webブラウザのチャット画面でコードをコピー&ペーストする作業には限界がある。ファイルの読み書き、テストの実行、Gitの操作――実際の開発作業には、チャットだけでは対応できない多くの工程が存在する。

Claude Codeは、この隙間を埋めるために生まれた。

Claude Codeは何が違うのか

Claude Codeは、Anthropicが開発した公式のCLI（コマンドラインインターフェース）ツールだ。

ブラウザのチャット画面とは根本的に異なる。Claude Codeはあなたのコンピュータのターミナルで動作し、ファイルシステムに直接アクセスできる。

これが意味することは大きい。

• ファイルを読み、理解し、編集できる
• テストを実行し、結果を確認し、修正できる
• Gitでコミットし、PRを作成できる
• プロジェクト全体の文脈を理解した上で作業できる

つまり、Claude Codeは「チャットボット」ではなく、あなたの開発環境に住む共同開発者なのだ。

なぜ「周辺」まで学ぶ必要があるのか

Claude Codeを単体で使うだけなら、インストールして対話を始めれば済む。

しかし、本当の力を引き出すには、そのエコシステムを理解する必要がある。

CLAUDE.md — プロジェクトの設計図

プロジェクトのルートに CLAUDE.md を置くだけで、Claude Codeの振る舞いが劇的に変わる。コーディング規約、アーキテクチャの方針、テスト戦略。これらを一度書いておけば、毎回説明する必要がなくなる。

Hooks — 自動化の仕組み

ファイルを保存したら自動フォーマット。コミット前にセキュリティチェック。Hooksを使えば、人間が忘れがちな作業をClaude Codeが自動で行ってくれる。

Skills — 再利用可能なワークフロー

/commit と打てばコミットメッセージを自動生成。/tdd と打てばテスト駆動開発のワークフローが始まる。Skillsは、よく使う作業パターンをコマンド化する仕組みである。

Agents — 専門家チーム

セキュリティレビュー担当、コードレビュー担当、テスト担当。複数のAgentを並行して動かし、一人では到底カバーできない品質チェックを可能にする。

MCP — 外部サービス連携

GitHub、データベース、外部API。MCPサーバーを通じて、Claude Codeの能力を外部サービスにまで拡張できる。

Claude API / Agent SDK — プログラマティックな活用

Claude Codeの中で使われているAPIやSDKを直接使えば、自分だけのAIツールを構築できる。

これらの「周辺」を知ることで、Claude Codeは単なるコーディングアシスタントから、開発ワークフロー全体を変革するプラットフォームへと姿を変える。

本書の構成

本書は7つのパートで構成される。

Part 1「Claude Codeとは」

全体像の把握、インストール、最初の対話。まず手を動かして体感する。

Part 2「コア概念」

ツールシステム、CLAUDE.md、設定ファイル、パーミッション。Claude Codeの設計思想を理解する。

Part 3「カスタマイズ」

Hooks、Skills、Agents、MCP。自分の開発スタイルに合わせてClaude Codeを拡張する。

Part 4「開発ワークフロー」

Git連携、テスト駆動開発、コードレビュー、Plan Mode。実務で使える開発手法を身につける。

Part 5「高度なテクニック」

プロンプト設計、コンテキスト管理、マルチエージェント、Worktrees。上級者への道を開く。

Part 6「実践プロジェクト」

Webアプリ構築、医療アプリ開発、CI/CD自動化。実際に何かを作りながら学ぶ。

Part 7「エコシステム」

Claude API、Agent SDK、コミュニティ。Claude Codeを取り巻く世界を知り、次のステップへ進む。

読み方のガイド

本書は順番に読むこともできるし、必要な章だけを読むこともできる。

ただし、以下の読み方を推奨する。

初学者: Part 1 → Part 2 → Part 4 の順に読み、手を動かしながら基本を身につける。その後、興味のあるパートへ進む。

経験者: Part 3（カスタマイズ）と Part 5（高度なテクニック）から読み始めると、すぐに実務に活かせる知識が得られる。

開発リーダー: Part 5 の「マルチエージェント」と Part 6 の「実践プロジェクト」が、チーム開発の設計に役立つ。

AIと「一緒に」コードを書く

Claude Codeは、あなたの代わりにコードを書くツールではない。

AIが書いたコードをレビューし、方向性を修正し、テストで品質を担保する。そのプロセスにおいて、あなたの判断力と専門知識は不可欠だ。

AIはコードを書く。あなたは設計する。

この協働のあり方を、本書を通じて体得してほしい。