Claude Code 入門｜公式ドキュメントには載っていない実務の使い方【2026年版】
公開: 2026-05-09
この記事でわかること
- Claude Code を CLI で導入する 5 ステップと、最初の 1 週間で詰まりやすい落とし穴
- 業務コードに使うときの安全設定 (許可コマンド・読込ファイル・ログ・履歴)
- Cursor / GitHub Copilot との使い分けを「対話粒度」で判断する基準
- Pro $20/月 vs Max $100/月 vs API 従量の課金タイミング
- チームで導入するときに整えるべき 3 つのレビュールール
なぜ「公式チュートリアル」を読んだだけでは足りないのか
Anthropic の Claude Code 公式ドキュメント は、CLI のインストール手順とコマンド一覧という意味では完璧です。一方で、実務で詰まるところ はほとんど書かれていません。例えば:
- どの粒度のタスクを Claude Code に任せて、どこから人間が引き取るのか
- レビューが厳しい組織で「AI が書いた PR」をどう扱うか
- API 従量と Pro $20/月、Max $100/月 のどれを使うべきか
- 暴走しないように Claude Code を「躾ける」方法
本記事は、Anthropic 公式とは別の角度で、Claude Code を業務に取り入れた人が最初の 1 週間でぶつかる現実的な疑問 に答える形で構成しています。
CLI を入れて 5 分で動くまで
1. インストール
# Node.js 18+ が必要
npm install -g @anthropic-ai/claude-code
# 認証 (3 つの方法のどれか)
# 方法 A: Anthropic API キー
export ANTHROPIC_API_KEY=sk-ant-xxx
# 方法 B: Claude Pro/Max サブスクリプション (claude.ai でログイン)
claude # 初回起動時にブラウザ認証を促される
# 方法 C: AWS Bedrock / Google Vertex AI
# (大規模組織向け、ガバナンス要件がある場合)
2. 起動と最初のタスク
リポジトリのルートに移動して claude と打つだけです。最初のセッションで CLAUDE.md を作るかどうか聞かれますが、必ず Yes を選んでください。CLAUDE.md は「このプロジェクトでの好まれる書き方」をメモしておくファイルで、Claude Code はセッション起動時に毎回読み込みます。
最初の 1 つ目のタスクとして推奨するのは、読み取り専用のもの です。
> このリポジトリのアーキテクチャを 3 行で教えて
これで Claude Code が Read, Grep, Glob ツールをどう使うかを観察できます。書き込みタスクをいきなり投げると、本番コードを意図せず編集してしまうリスクがあります。
3. 書き込みタスクは別ブランチで
最初の書き込みタスクは:
git checkout -b experiment/claude-first
で別ブランチを作り、その上で投げるのが安全です。終わったら必ず git diff で変更内容を確認します。意図しないファイルが変わっていないか、コメントが過剰についていないか、不要な console.log が残っていないかを目視確認します。
4. 詰まりやすいポイント Top 3
最初の 1 週間で多くの人が詰まるポイント:
- 「全部 Claude にお任せ」してしまう: Claude Code は強力だが、設計判断を AI に任せると後で痛い目を見ます。「設計は人間、実装は AI」という境界を最初に決めてください。
- コンテキストが膨らんで遅くなる: 長い対話の後半でレスポンスが遅くなったら、新しいセッションを起動する勇気を持ちましょう。
/clearで履歴をクリアできます。 - CLAUDE.md を更新しない: 同じ指摘を 2 回した時点で CLAUDE.md に書きます。3 回目以降は自動的に守られるようになります。
業務コードに使うときの安全設定
許可コマンドの考え方
Claude Code は 破壊的コマンド (rm -rf, git push --force, systemctl stop, DROP TABLE 等) を実行する前に必ず確認を求めます。ただし以下は要注意です:
- 大量ファイル一括書き換え: 10 ファイル以上の編集は、事前に対象ファイル一覧を提示してもらうルールを CLAUDE.md に書いておく
- 本番 DB 操作: 本番 DB への接続は明示的に拒否する。CLAUDE.md に「prod_db_url は使用禁止、staging のみ」と書く
- 環境変数:
.env,credentials.json等の機密ファイルはコミット対象から外す。Claude Code は.gitignoreを尊重するが、新規作成時に明示的に書いておくと事故が減る
CLAUDE.md に書いておくべき項目
最低でも以下の 5 項目を CLAUDE.md に書きます:
- 言語と Format: 例「Python は ruff format + ruff check」「TypeScript は prettier + tsc」
- テスト: 例「変更後は pytest tests/ を必ず実行」「型エラーは npm run typecheck で確認」
- コミット規約: 例「日本語コミットメッセージ可、Co-Authored-By 必須」
- やってはいけないこと: 例「
.envをコミットしない」「main 直 push 禁止、feature branch + PR」 - 本番影響の事前確認: 例「systemctl stop/disable は要確認」
Anthropic 公式の CLAUDE.md ベストプラクティス も参考になりますが、上記 5 項目は最低限のチェックリストとして使えます。
Cursor / GitHub Copilot との使い分け
対話粒度で考える
3 つのツールを「対話粒度」で並べるとこうなります:
| ツール | 粒度 | 得意 | 苦手 |
|---|---|---|---|
| GitHub Copilot | 行単位 | タイピング中の補完、定型コード | リファクタ、複数ファイル横断 |
| Cursor | ファイル単位 | 単一ファイルの編集、UI 統合 | 自律実行 (人間が逐次操作必要) |
| Claude Code | タスク単位 | 「バグを直して」「機能を追加して」のような自律実行 | リアルタイム補完 |
実務での使い分け
- タイピング中の補完を最重視: Copilot
- 既存ファイルを少し書き換える: Cursor
- 「このバグを直して」「このリファクタをやって」「このテストを書いて」: Claude Code
3 つを併用しても問題ありません。実際、Claude Code でリファクタを実行 → Cursor で微調整 → Copilot でタイピング、という流れで使う人もいます。
課金タイミング: API vs Pro vs Max
月いくら使うかで決まる
| プラン | 月額 | 向いている人 |
|---|---|---|
| Anthropic API 従量 | $1〜 (試用) | まず触ってみたい / 月数時間しか使わない |
| Claude Pro | $20/月 | 平日毎日 1-2 時間使う、Sonnet 中心 |
| Claude Max 5x | $100/月 | Opus を多用、リファクタ・大規模実装 |
| Claude Max 20x | $200/月 | 複数プロジェクト並行、フルタイムで使う |
切替タイミングの目安
- API 従量 → Pro: 月額が $20 を超えそうになったら Pro に切替
- Pro → Max: Sonnet ではタスクが完結しないことが週 2 回以上ある (Opus が必要)
- Max 5x → 20x: チームで共有 or 1 日 4 時間以上使う
経験的には、エンジニア個人なら Pro $20 で 8 割の人は満足できます。複雑なリファクタ・アーキテクチャ設計を頻繁にする人は Max を検討してください。
「AI が書いた PR」を組織でどう扱うか
3 つのチームルール
最低限の 3 つ:
- PR ラベル「ai-assisted」: Claude Code が編集した PR に明示的にラベル付け。レビュアーの目線が変わる (型エラーは出さないが要件違いの可能性あり)
- テストカバレッジを高める: AI が書いた箇所は通常より厳密にテストを書く。型は通っても挙動が違う罠を防ぐ
- 設計は人間、実装は AI: 設計判断 (アーキテクチャ・データモデル・API 仕様) は人間が決め、実装の量産部分を AI に任せる
レビューで見るべきポイント
通常のコードレビューに加えて:
- 過剰なコメント: AI は丁寧すぎるコメントを書きがち。冗長なら削る
- 意味のない
try/except: 本来 raise すべきところで握り潰しているケース - 重複した実装: 既存のユーティリティ関数を見落として新規実装してしまうケース
- 依存ライブラリの追加: 安易に新しいライブラリを追加していないか
次のステップ: 実装力を定着させる
Claude Code を「使える」と「業務で使いこなせる」の間にはギャップがあります。実装力を定着させるには 動く成果物を提出して採点される 体験が必要です。
ここで紹介した内容は概念入門です。実際に手を動かして 40 レッスンを通して身につけたい方は、Claude Code 実践 40 レッスン (バイブコーディング実践編) を 4 週間限定で無料公開中 です。各レッスンに提出物テンプレ・採点ルーブリック・期待ログが付いており、設計→実装→レビュー→テストまでひとりで完走できる構成になっています。
次に読む: バイブコーディング実践編は /lms/free/vibe-practice から無料で開始できます。料金プランは /lms/pricing を参照してください。
関連ガイド
- Claude Code チュートリアル — 5 つの実例タスクで運用感覚を掴む
- バイブコーディングとは — AI ペアプロの基礎と業務導入 3 段階
- MCP 入門 — Claude を社内ツールに繋ぐ Model Context Protocol
- AI Agent SDK 入門 — Agent SDK + MCP で AI を働かせる
- Claude Code vs Cursor 比較 — エディタ統合 AI ツールとの使い分け
- Claude Code vs GitHub Copilot 比較 — Copilot との対話粒度の違い
- Claude Code セキュリティガイド — 法人導入のリスク評価と社内規約テンプレ
- Anthropic Academy vs 実装力定着型研修 — 概念入門と動く成果物のギャップ
まとめ
- Claude Code は CLI で 5 分で動く。最初は読み取りタスクから始める
- CLAUDE.md にプロジェクト規約を書くと事故が減る
- Cursor/Copilot との使い分けは「対話粒度」で考える
- 課金は API → Pro → Max の順に段階的に切替
- 組織導入では「AI が書いた」を明示するラベル運用が鍵
ブログとして読むだけでなく、実際に手を動かしてみてください。Claude Code は「触ってみた」と「使いこなした」の差が大きいツールです。