Claude Code 入門 2026:セットアップから初コミットまで

Claude Code とは何か

Claude Code はチャットインターフェースではありません。コマンドラインで動作するエージェントであり、ファイルシステムを読み、bash コマンドを実行し、ファイルを編集し、自身の出力を反復しながら、指定したゴールに到達します。プロジェクトディレクトリで起動し、タスクを伝えると、既存コードを読み、変更を加え、テストを走らせ、失敗時は再度ループしながら、段階的に問題を解決していきます。

実用上の含意は明確です。Claude Code は、現実のコードベース上の、現実かつスコープのある問題で最も力を発揮します。「プロジェクトを手伝って」のような指示はドリフトを生みます。「src/api/users.ts 内の createUser 関数に入力検証を追加し、対応するテストも更新して」と指示すれば、結果を出します。

ステップ 1 — インストール

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

インストール完了の確認:

claude --version
# → claude-code 1.x.x

macOS や Linux でパーミッションエラーが出る場合、sudo で npm を走らせるのではなく、npm のグローバルディレクトリの所有権を調整するのが基本対処です。Anthropic のドキュメントの前提条件セクションに手順があります。Windows はターミナルを管理者権限で起動すれば多くの問題を回避できますが、エージェント業務を本格的に回すなら WSL2 経由のほうが安定します。

ステップ 2 — 認証

claude login

ブラウザが開き OAuth が完了します。認証情報は ~/.claude/ に保存されるため、アカウントを切り替えない限り再認証は不要です。

API キーを直接利用する場合(CI 環境やブラウザ非対応マシンなど)、環境変数として設定します。

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Claude Pro サブスクリプションには月間トークン枠が同梱されており、個人の中程度の利用なら十分カバーできます。大規模コードベースの操作、広範なテスト生成、ループ処理を行う場合は、Pro 枠を超過する可能性が高く、API クレジットでの補填が必要になります。Anthropic コンソールでは利用量がリアルタイム表示されますので、最初の数セッションを終えたら必ず確認し、自身のバーンレートを把握してください。

ステップ 3 — CLAUDE.md を整備する

最低限かつ実効性のある CLAUDE.md は、以下の 5 項目を押さえます。

# Project: [プロジェクト名]

## Stack
- Runtime: Node 20, TypeScript 5.3
- Framework: Next.js 14 (App Router)
- Database: PostgreSQL via Prisma
- Tests: Vitest, run with `npm test`

## Commands
- Dev server: `npm run dev`
- Build: `npm run build`
- Lint: `npm run lint` — fix before committing
- Migrate: `npx prisma migrate dev`

## Rules
- All new API routes go in src/app/api/
- Zod for all input validation — no raw req.body access
- Never touch the /legacy/ directory
- Do not remove console.error calls in error handlers

## Do not
- npm install packages without asking first
- Modify .env files
- Run database migrations without confirmation

多くの開発者が初回に省略しがちなのが「Do not」セクションです。しかし高くつくミスを防ぐのは、まさにこのセクションです。Claude が触れてはならないファイルがあるなら、明記してください。自律的に実行してはならないコマンドがあるなら、その旨を明示してください。

CLAUDE.md の構造をさらに掘り下げたい方は、実効性のある CLAUDE.md の書き方を参照してください。Septim Starter パック($9)には、Next.js・Python Flask・Rails・Go・素の Node の 5 つのプロジェクト類型に対応した実戦投入済みテンプレートが含まれており、白紙から始める必要がありません。

ステップ 4 — 実タスクを与える

cd ~/projects/my-app
claude

プロンプトが表示されたら、完了状態が明確に判定できる程度に具体的なタスクを与えてください。初心者向けの最初のタスクとして、たとえば以下のようなものが適しています。

• /api/login ルートにレートリミッターを追加 — IP あたり毎分 5 回、超過時は 429
• src/lib/date-utils.ts 内の全関数に対してユニットテストを記述 — ブランチカバレッジ 90% を目標
• src/components/UserTable.tsx を素の fetch から React Query へリファクタ

Claude Code は関連ファイルを読み、変更を提案し、ディスク書き込みやコマンド実行の前に承認を求めます。デフォルト設定ではすべての書き込み操作前に確認があります — 学習段階ではこのモードが最適です。~/.claude/settings.json でこの権限設定は緩めることも厳格化することもできますが、ツールの挙動を理解してから手を入れてください。

エージェントループの内側で起きていること

典型的な Claude Code タスクは、以下のサイクルで進行します。

1. 関連するソースファイルを読み込み、現状の構造を理解する
2. 実装計画を提案し、変更対象ファイルを列挙する
3. 説明を添えてファイル単位で変更を書き込む
4. (CLAUDE.md に記載があれば)テストスイートを実行し、失敗時は反復する
5. 完了を報告し、変更したファイルを一覧する

素直なタスク — フォームへのフィールド追加、小さなユーティリティ関数の作成、型エラー修正 — であれば、2 分以内に終わります。より大きなタスク(モジュールのリファクタ、機能の端から端までの追加)では、5〜15 分と数回の反復を見込んでください。

ステップ 5 — コストを確認する

Anthropic コンソール(console.anthropic.com)では、トークン消費がモデル別・日付別に表示されます。最初の 2〜3 セッションを終えたあとにダッシュボードを確認し、長時間タスクに着手する前に自分のバーンレートを把握してください。

想定外コストを生む典型パターンは 3 つあります。

• 大きなファイルが文脈に入る。1 関数についての質問のために 10,000 行のファイルを読ませると、入力トークン 10,000 行分の請求が発生します。コードベース全体を巻き込む広範な質問より、特定ファイルを指定する形で問いを立ててください。
• 文脈の繰り返し再構築。セッション内の各メッセージは、過去の会話履歴をすべて再送します。長時間セッションは高くつきます。1 日中ひとつのセッションを引き伸ばすより、無関係なタスクごとに新しいセッションを始めてください。
• サブエージェントの生成。Claude Code は並行作業のためにサブエージェントを生成できます。各サブエージェントは独自の文脈を持つため、複数を同時実行すればコストもそれに比例します。詳細はトークン黙示録の解説 — サブエージェントコストの内訳をご覧ください。

スコープが整ったコーディングタスク 1 件は、ファイルサイズや複雑さにもよりますが、API クレジットでおおむね $0.05〜$0.40 程度です。一方、何かを始める前にコードベース全体を理解させようとするセッションは、数ドルかかることがあります。ステップ 3 で書いた CLAUDE.md は、まさに後者のパターンを大きく抑えます — 事前に与えた文脈が、探索に費やされるトークンを置き換えるからです。

初回セッションでよくある失敗

「プロジェクトを見て、問題があれば教えて」と頼む

これは文脈ウィンドウを当てのない探索で消費し尽くす指示です。一般的なコードレビューが返り、実在の問題を一部指摘するかもしれませんが、トークンコストは多大です。Septim Drills($29)の構造化されたコードレビュー演習を活用するか、特定ファイルに対して特定の問いを立てて Claude Code を向けてください。

計画を読まずに承認する

Claude Code は実行前に計画を提案します。読んでください。複雑なタスクでは、許可するつもりのない手順 — テーブル削除、キャッシュ層撤去、明示的に除外したファイルへの操作など — が混じることがあります。計画段階でこれを捕まえるのは無料です。書き込み完了後に気づくと git revert が必要になります。

バージョン管理なしで実行する

Claude Code はディスクに書き込みます。git diff で変更を逐一確認し、納得できないものを git checkout . で破棄できるよう、作業ツリーがクリーンなリポジトリでのみ動かしてください。git をまだ使っていないなら、最初のセッションを始める前にリポジトリを初期化してください。

CLAUDE.md を省略する

CLAUDE.md なしでは、Claude Code はファイル探索からプロジェクト文脈を推測します。その推測はトークンを食い、規約・禁止コマンド・テストランナーについてしばしば誤ります。ステップ 3 で 20 分かけて整備した CLAUDE.md は、最初の 1 週間で十分元が取れます。

次に進む先

いくつかのタスクを成功させたら、自然な次の一手は、MCP サーバーで Claude Code を拡張することです — データベース、GitHub、ブラウザなど、外部ツールへのアクセスを与える統合です。実践手順はMCP サーバーチュートリアルを参照してください。

チームで Claude Code を運用し、PR の自動レビューを構築するなら、PR レビュー設定ガイドに GitHub Action 構成を端から端まで掲載しています。

初心者期を抜けて Claude Code を日常運用するようになり、コストを本格的に管理したい方は、コスト監視ガイドと文脈管理の記事をどうぞ。