「AIにコードをお願いする」で止まっていませんか？

Claude Code は、ターミナルの中であなたのプロジェクトを直接読み書きし、

コマンドを実行し、テストまで回してくれる “エージェント型” の開発ツールです。

本書は、その Claude Code を「なんとなく便利なチャット」から

「実務で使いこなせる相棒」へ引き上げるための実践教科書です。

プログラミング初心者でも置いていかれないよう、環境構築から一歩ずつ。

中級者がつまずくポイント（権限設計・Hooks・サブエージェント・MCP・チーム運用）も

妥協なく扱います。

── こんなこと、感じていませんか ──

・便利そうだけど、CLAUDE.md とか Hooks とか、結局よく分からない

・チャットでコードを書かせるだけで終わっている。もっと使いこなせるはずなのに

・繰り返しの作業を自動化して、開発を楽にしたい

情報は断片的にネットに転がっています。でも「最初から順番に、手を動かして、

実務で使えるところまで」まとめて案内してくれるものは、意外とありません。

── この教科書で身につくこと ──

Claude Code を「触れる」から「実務で使える」へ。

・初心者でも置いていかれないよう、環境構築から一歩ずつ

・許可モードで事故を防ぎながら、安全に速く開発する型

・CLAUDE.md／Hooks／Skills で、作業を自動化し品質を安定させる

・サブエージェント・MCP で、大きな仕事や外部ツール連携までこなす

・設定・権限・セキュリティ・チーム運用まで、実務で必要な知識を網羅

しかも、この教材自体が「AIに読ませて伴走させる」前提で書かれています。

詰まったら、その章を丸ごと Claude Code に貼り付ければOK。

初心者はAI伴走で、中級者は写経で進められます。

── 中身（全12章＋付録） ──

第1章セットアップと最初の一歩（課金の落とし穴も）

第2章基本操作 — 許可モードで事故を防ぐ／計画→承認→実行

第3章 CLAUDE.md とメモリ設計（AIに“プロジェクトの常識”を渡す）

第4章スラッシュコマンド — 定番の指示を資産化する

第5章 Hooks — 「毎回やること」を自動実行する

第6章 Skills — ノウハウをパッケージ化して再利用する

第7章サブエージェント — 大きな仕事を分割・並行処理

第8章 MCP — DB・GitHub・Slackなど外部ツールに接続

第9章設定・権限・セキュリティ・チーム運用

第10章実践 — 自動化ワークフローの設計と運用

付録A チートシート＆トラブルシュート

付録B 特典スターターパックの使い方

各章に図解と、そのまま使える実コードを収録。読んで終わりにさせません。

── 購入特典：Claude Code スターターパック ──

読むだけでなく、そのまま自分のプロジェクトに置いて使える初期設定一式が付きます。

・CLAUDE.md（プロジェクト規約テンプレート）

・settings.json（権限＋Hooks 配線済み）

・Hooks 3種（危険コマンド遮断／秘密の直書き検知／開始時TODO表示）

・コマンド5種（/summarize /fixbug /security /pr /test）

・Skills 2種（レビュー基準／記事下書き＋テンプレ）

解凍して置くだけ。本書の内容を “設定済みの状態” から始められます。

── こんな人に向いています ──

・Claude Code を使い始めたが、使いこなせている実感がない人

・繰り返し作業を自動化して、開発を効率化したい人

・チームでAIエージェントを安全に運用したいエンジニア

向いていないもの：

・コードを一切書かない／読む気がまったくない人

── よくある質問 ──

Q. プログラミング完全初心者でも大丈夫？

A. はい。環境構築から順に進めます。詰まった章はそのままAIに貼って伴走させられます。

Q. Mac / Windows どちらでも使える？

A. はい。Windows特有のつまずき（文字化け等）の対処も本文に含めています。

Q. Claude Code は有料？

A. サブスクでもAPIキーでも使えます。課金の違いと事故の避け方も第1章で解説します。

── お渡し方法 ──

ご購入後、教科書本編（全12章＋付録・図解込みのPDF）と特典スターターパックを、

このページの購入者エリアのリンクからそのままお受け取りいただけます。

Claude Code は、“便利なチャット” で終わらせるにはもったいない道具です。

自分の作業を自動化し、開発を一段速く・安全にする——

その具体的な方法を、初心者でも歩けるように一冊にまとめました。

★─────────────────────★

　ここから無料サンプル（第1章・第2章）を試し読みできます

★─────────────────────★

════════════════════

第1章セットアップと最初の一歩

════════════════════

■ この章のゴール

・Claude Code をインストールして起動できる

・認証（サブスク or API）の違いを理解する

・最初のセッションでファイルを1つ作らせる

■ 1-1. 前提の準備

Claude Code は Node.js 18 以上が入っていれば動きます。まず確認しましょう。

node --version

# v18.0.0 以上ならOK。入っていなければ https://nodejs.org からLTS版を入れる

Windows の場合は PowerShell、Mac / Linux の場合はターミナルを開いてください。

■ 1-2. インストール

npm でグローバルインストールします。

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

インストールできたか確認します。

claude --version

バージョン番号が表示されれば成功です。command not found になる場合は、

npm のグローバル bin にパスが通っていません。npm config get prefix で表示された場所の

bin（Windows なら直下）を PATH に追加してください。

■ 1-3. 認証の2系統を理解する

Claude Code の認証には大きく2通りあります。ここは課金に直結する重要ポイントです。

・サブスクリプション（Pro / Max）　／　初回起動でブラウザログイン　／　月額の中で使える

・API キー　／　環境変数 ANTHROPIC_API_KEY を設定　／　従量課金（トークン単価）

　注意：両方を同時に設定すると、意図せず API キー側（従量課金）が使われて

　「サブスクのつもりが課金された」という事故が起きます。サブスクで使いたいなら、

　ANTHROPIC_API_KEY を設定しないようにしましょう。

初回起動して、画面の指示に従ってログインします。

claude

ブラウザが開くので、Claude の契約アカウントで承認すればセッションが始まります。

■ 1-4. 最初のセッション

適当な作業フォルダを作って、その中で起動するのが基本です。

mkdir hello-claude

cd hello-claude

claude

プロンプトが出たら、日本語でそのまま指示できます。

hello.py というファイルを作って、実行すると「Claude Codeへようこそ」と表示されるようにして

Claude Code は「ファイルを新規作成してよいか？」と許可を求めてきます（許可モードは次章で詳説）。

承認すると hello.py が作られます。続けて実行させましょう。

それを実行して結果を見せて

Claude がコマンドを実行し、出力を報告します。ここまでできれば、あなたはもう

「AI にファイルを作らせ、実行させる」という Claude Code の中核を体験したことになります。

■ 1-5. セッションの基本操作

・終了：Ctrl+C を2回、または /exit

・会話をクリア：/clear（文脈をリセットして新しい話題に切り替える）

・ヘルプ：/help

・直前のセッションを再開：claude --continue（あるいは claude --resume で一覧から選ぶ）

　コツ：話題が大きく変わったら /clear を使いましょう。前の文脈を引きずったままだと、

　関係ないファイルを触られたり、判断がぶれたりします。「1セッション＝1テーマ」が基本です。

■ 章末チェック

・[ ] claude --version が表示される

・[ ] サブスクと API キーの課金の違いを説明できる

・[ ] ファイルを1つ作らせ、実行させられた

次章では、日々の作業で最も重要な「許可モード」と、安全に速く進めるための編集フローを学びます。

════════════════════

第2章基本操作 — 対話・編集・許可モード

════════════════════

■ この章のゴール

・許可モード（Permission Mode）を使い分けて事故を防ぐ

・ファイル編集・検索・コマンド実行の流れを理解する

・「良い指示」の型を身につける

■ 2-1. 許可モードは"ブレーキ"

Claude Code はファイルを書き換え、コマンドを実行します。だからこそ、

どこまで自動で許可するかを選べるようになっています。これが許可モードです。

・default（通常）　／　変更・実行のたびに確認を求める　／　慣れないうち・重要なリポジトリ

・acceptEdits　／　ファイル編集は自動承認、コマンドは確認　／　編集が多い作業を速くしたい時

・plan（プランモード）　／　読み取り専用。まず計画だけ立てる　／　変更前に方針を固めたい時

・bypassPermissions　／　すべて自動承認　／　使い捨て環境・完全に信頼できる作業のみ

セッション中は Shift+Tab でモードを切り替えられます。

　鉄則：bypassPermissions は「壊れてもいいフォルダ」でだけ使うこと。

　本番リポジトリや個人ファイルのある場所で全自動にすると、取り返しのつかない削除・上書きが起きえます。

■ 2-2. プランモードで"考えさせてから"動かす

大きめの変更は、いきなりやらせずまず計画を出させると失敗が激減します。

（Shift+Tab でプランモードに切り替えてから）

このプロジェクトに、ユーザー登録とログイン機能を追加したい。まず設計と手順を提案して

Claude は読み取りだけを行い、変更はせずに計画を提示します。

納得したら承認して実行へ、違えば「認証は JWT でなくセッションにして」と修正を伝えます。

「計画 → 承認 → 実行」は Claude Code を安全に使う基本リズムです。

■ 2-3. Claude が使う主なツール

Claude Code は内部で次のような操作を行います（あなたが直接叩くわけではありませんが、

理解しておくと指示が的確になります）。

・Read / Glob / Grep：ファイルを読む・パターンで探す・中身を検索する

・Edit / Write：既存ファイルの一部を書き換える・新規作成する

・Bash：シェルコマンドを実行する（テスト・ビルド・git など）

だから「〇〇というエラーの原因を探して」と言えば、Claude は自分で grep して該当箇所を特定します。

あなたがファイル名を全部教える必要はありません。

■ 2-4. 良い指示の型

Claude Code への指示は、次の要素が揃うほど精度が上がります。

1. ゴール：何を達成したいか（例：「注文APIに在庫チェックを足す」）

2. 範囲：どこを触っていいか（例：「api/orders.py だけ」）

3. 制約：守ってほしいこと（例：「既存のテストは壊さない」）

4. 完了条件：どうなれば終わりか（例：「在庫0なら400を返すテストが通る」）

悪い例と良い例：

悪い: 在庫のとこ直して

良い: api/orders.py の create_order に在庫チェックを追加して。

在庫が足りなければ HTTP 400 と {"error":"out_of_stock"} を返す。

既存テストは壊さず、この挙動のテストを1つ足して。

■ 2-5. 変更を確認する習慣

Claude が編集したら、git diff で差分を確認する癖をつけましょう。

git diff

Claude Code に「今の変更を要約して」と聞くこともできます。

AI に任せる＝丸投げではありません。差分を見て、意図と違えばその場で戻す。

この確認のループが、速さと安全の両立を生みます。

■ 2-6. コミットも任せる（が、確認は自分で）

今の変更をコミットして。メッセージは日本語で、何をなぜ変えたか書いて

Claude は変更内容を読み取り、適切なコミットメッセージを作ってくれます。

ただしプッシュや破壊的な git 操作は、明示的に頼むまでやらせないのが安全です。

■ 章末チェック

・[ ] 4つの許可モードを使い分けられる

・[ ] プランモードで計画→承認→実行の流れを試した

・[ ] 「ゴール・範囲・制約・完了条件」を含む指示が書ける

ここまでが無料サンプルです。次章からは本編。まず AI に「プロジェクトの常識」を教える

CLAUDE.md から始めます。ここを押さえると、毎回同じ説明を繰り返す無駄がなくなり、

Claude の出力が一気に安定します。

──────────

続き（第3章〜第10章・付録）は、ご購入後にこの下でお読みいただけます。