Claude Code 完全入門ガイド2026|ゼロから実務で使えるまでの7ステップ
Claude Codeを初めて触る方向けの完全入門ガイド。インストールから実際の開発ワークフローへの組み込みまで、Masa自身が最初につまずいたポイントを踏まえて丁寧に解説。
「Claude Code って名前は知ってるけど、何から始めればいいかわからない」
私が初めて Claude Code を触った時、まさにそう感じました。ターミナルで claude と入力して何かが動くのはわかるけど、普段の開発にどう組み込めばいいのか、全然イメージが湧かなかった。
この記事では、私自身がゼロから始めて実務で使えるようになるまでにやったことを、7つのステップに整理して解説します。「インストールしたけど何に使えばいいかわからない」という方に、特に役立つ内容です。
迷ったら、この記事は次の順番で使ってください。
- まず無料の Claude Code Quick Reference Cheatsheet を手元に置く
- この記事の「最初の30分」だけをそのまま実行する
- 設定・権限・
CLAUDE.mdで詰まったら 教材一覧 から Setup Guide を見る - プロンプト作成で毎回迷うなら 50 Prompt Templates を使う
- チーム導入、運用設計、収益導線まで含めたいなら 導入相談 に進む
なお、インストールや認証方法は更新されることがあります。この記事では2026年6月1日時点の公式情報に合わせ、最新確認先として Anthropic の Claude Code getting started docs も併記します。
最初の30分でやること
初心者が最初につまずくのは、インストールそのものより「起動できたあと、何を頼めばいいのか」です。最初の30分は、いきなりコードを書き換えず、Claude Code にプロジェクトを読ませる練習に使ってください。
0〜5分: 対象プロジェクトを1つだけ選ぶ
練習用の小さなリポジトリか、壊れても戻せる個人プロジェクトを選びます。仕事の本番リポジトリで始める場合は、必ず作業ブランチを切ってください。
git status
git switch -c try-claude-code
最初に git status を見る理由は、未コミットの変更を巻き込まないためです。Claude Code は便利ですが、変更前の状態が曖昧なまま使うと、あとで差分の意味が追えなくなります。
5〜15分: 読ませるだけの依頼をする
まずは編集をさせず、説明だけを頼みます。
claude -p "README.md と package.json だけを読んで、このプロジェクトの目的、起動方法、次に読むべきファイルを日本語で説明して"
ここで大事なのは「だけを読んで」と範囲を狭めることです。初心者のうちは、Claude Code が大量のファイルを読み始めると、何を根拠に答えているのか追いにくくなります。
15〜25分: 小さなレビューを依頼する
次に、1ファイルだけを対象にコードレビューを頼みます。
claude -p "src/utils/date.ts だけを読んで、バグになりそうな点、命名、テスト不足を3つ以内で指摘して。まだ編集はしないで"
「まだ編集はしないで」と書くと、レビューと実装が混ざりません。最初は Claude Code の提案を読む練習が先です。
25〜30分: 次にやることを1つだけ決める
最後に、今日やるタスクを1つに絞ります。
claude -p "ここまでの調査を前提に、初心者が今日やるべき安全な次の1タスクを1つだけ提案して。理由も短く書いて"
この30分で「起動できる」「読ませられる」「編集前に判断できる」状態になれば十分です。初日にいきなり大規模リファクタリングまで進める必要はありません。
ステップ1: インストールと初期設定
インストール
npm install -g @anthropic-ai/claude-code
Node.js 18 以上が必要です。インストール後、claude --version でバージョンを確認してください。
現在の認証方法
2026年6月1日時点では、最初に claude を起動し、ブラウザでサインインする流れが基本です。古い記事では「APIキーを環境変数に入れる」手順が主役になっていることがありますが、まずは公式ドキュメントの認証フローに合わせてください。
cd your-project
claude
主な選択肢は、Anthropic Console の課金アカウントでOAuthサインインする方法、Claude Pro / Max など Claude App 側のサブスクリプションでログインする方法、企業向けに Amazon Bedrock や Google Vertex AI を使う方法です。
個人開発者なら、まず cd your-project して claude を起動し、画面に出る案内に従うのが一番迷いません。APIキーを直接扱う必要がある構成は、チームの認証方針やクラウド環境が決まってからで十分です。
最初の動作確認
claude -p "Hello! 日本語で自己紹介してください"
これが動けばセットアップ完了です。
ステップ2: CLAUDE.md を作ってプロジェクトを教える
Claude Code はプロジェクト直下の CLAUDE.md を自動で読み込みます。ここにプロジェクトの情報を書いておくと、毎回説明しなくて済みます。
私が最初に書いた CLAUDE.md は、こんなシンプルなものでした。
# プロジェクト名
## 技術スタック
- TypeScript + Node.js
- PostgreSQL (Prisma)
- React + Vite
## よく使うコマンド
- 開発サーバー: npm run dev
- テスト: npm test
- ビルド: npm run build
## ルール
- コメントは日本語で書く
- 関数名は英語のcamelCase
これだけで、Claude Code は「このプロジェクトの言語はTypeScriptで、テストは npm test で実行する」ことを理解してくれます。
最初につまずいたこと: CLAUDE.md を書かずに使い始めたら、毎回「このプロジェクトは TypeScript です」と説明する羽目になりました。最初の5分で書くだけで、その後の全会話が快適になります。
ステップ3: 最初の「お試しタスク」を選ぶ
いきなり複雑なタスクに挑戦すると「あれ、思ったより使いにくい」となりがちです。最初はこのリストから選ぶのがおすすめです。
入門タスクリスト (難易度低)
# 1. コードの説明を求める
claude -p "src/auth/login.ts を読んで、このファイルが何をしているか説明して"
# 2. コードレビューをお願いする
claude -p "src/utils/date.ts のコードをレビューして、改善点を教えて"
# 3. テストを書いてもらう
claude -p "src/api/users.ts の getUserById 関数のユニットテストを書いて"
# 4. README を生成してもらう
claude -p "このプロジェクトの README.md を作って"
どれも「読むだけ」か「新しいファイルを追加するだけ」のタスクです。既存のコードを書き換えるタスクは、Claude Code に慣れてからにすると安心です。
ステップ4: 対話モードとワンショットモードを使い分ける
Claude Code には大きく2つの使い方があります。
対話モード (claude)
cd my-project
claude
ターミナルが REPL (対話型インターフェース) になり、複数のやり取りができます。コードを書きながら「ここはこういう意図で修正して」「やっぱり戻して」という試行錯誤に向いています。
ワンショットモード (claude -p "...")
claude -p "src/api/ 以下のファイルで TODO コメントが残っている箇所を全部列挙して"
1回だけ実行して結果を返します。スクリプトや CI から呼ぶときはこちら。
私の使い分け: 複雑な実装作業は対話モード、調査・確認・定型作業はワンショットモード、という感じです。
ステップ5: 権限設定で安全に使う
Claude Code はファイル操作やコマンド実行ができるので、最初のうちは権限設定をしておくと安心です。
.claude/settings.json を作成してください。
{
"permissions": {
"allow": [
"Read(**)",
"Glob(**)",
"Grep(**)",
"Bash(npm run *)",
"Bash(git log*)",
"Bash(git diff*)",
"Bash(git status*)"
],
"deny": [
"Bash(rm -rf*)",
"Bash(git push --force*)"
],
"ask": [
"Write(**)",
"Edit(**)",
"Bash(git commit*)",
"Bash(git push*)"
]
}
}
この設定では:
- 自動で実行: ファイルの読み取り、検索、テスト実行
- 毎回確認: ファイルの書き込み、git コミット・プッシュ
- 絶対禁止:
rm -rfやgit push --force
最初は ask に多くの操作を入れて、慣れてきたら allow に移すのがおすすめです。
初心者が最初にやってはいけないこと
Claude Code は強力なので、初心者ほど「便利そうなこと」を先にやりすぎます。私が最初に戻れるなら、次の5つは避けます。
1. いきなり大規模リファクタリングを頼まない
「このプロジェクトをきれいにして」のような依頼は、範囲が広すぎます。Claude Code は大量のファイルを読み、もっともらしい変更を提案できますが、初心者側が差分を評価できません。
最初は「1ファイル」「1関数」「1テスト」の単位にしてください。
claude -p "src/api/auth.ts の login 関数だけを読んで、編集せずに問題点を3つ以内で説明して"
2. sudo npm install -g を反射的に使わない
公式ドキュメントでも、グローバルインストール時に sudo npm install -g を使うのは権限問題やセキュリティリスクにつながるため避けるべきとされています。権限エラーが出たら、まずNode.jsのインストール方法やnpmのprefixを見直してください。
3. 秘密情報をそのまま貼らない
.env、本番APIキー、顧客データ、社内URL、トークンをそのまま貼るのは避けます。必要なら値を伏せて、構造だけを渡してください。
claude -p "この .env.example の形式を見て、足りない説明を提案して。実際の秘密値は含めない"
4. 差分を見ずにコミットしない
Claude Code が編集したら、必ず自分で差分を確認します。
git diff
npm test
「動いたように見える」と「意図した差分だけになっている」は別です。初心者ほど、テストとdiff確認をセットにしてください。
5. force push や削除コマンドを許可しない
git push --force、rm -rf、本番デプロイ、DBマイグレーションは、最初から allow に入れないでください。必要になった時だけ、人間が確認して実行する運用で十分です。
ステップ6: 効率的な指示の出し方を覚える
Claude Code を使い始めてすぐ気づくのが「指示の出し方で結果がかなり変わる」ということです。
悪い例 vs 良い例
# ❌ 曖昧すぎる
claude -p "ログイン機能を直して"
# ✅ 具体的で範囲が明確
claude -p "
src/api/auth.ts の login 関数 (42行目〜) に以下を修正:
- パスワードが空の場合に 400 エラーを返す処理がない
- エラーメッセージが英語のみなので日本語も返すようにする
既存のエラー処理パターン (src/utils/errors.ts) に合わせること
"
3つのコツ:
- ファイル名と行番号を明示する — 探索時間が大幅に減る
- 期待する動作を具体的に書く — 「いい感じに」は通じない
- 制約を伝える — 「既存パターンに合わせて」「他のファイルは触らないで」
ステップ7: 毎日のワークフローに組み込む
ここまで来たら、毎日の開発に組み込みましょう。私が実際にやっている日常パターンです。
朝の確認作業
# 昨日のコミット内容をまとめてもらう
claude -p "git log --oneline -10 を実行して、変更内容を日本語で要約して"
バグ修正時
claude
# → 「このエラーログを見て原因を探して」とペーストして会話
PR説明文の生成
claude -p "
git diff main...feature/add-search の変更を確認して、
GitHub PR の description を markdown 形式で書いて。
変更の目的・実装方法・テスト方法を含めること
"
コードレビューの補助
claude -p "
この PR の変更ファイルをレビューして:
$(git diff --name-only main...HEAD)
セキュリティ上の問題とパフォーマンス上の問題を優先的に指摘して
"
よくある「最初の壁」と解決策
壁1: 「なんか遅い」
Claude Code は会話が長くなるほど遅くなります。30分〜1時間おきに /compact コマンドを実行して会話を圧縮しましょう。
# Claude Code の REPL で
/compact
壁2: 「余計なファイルまで読もうとする」
指示に「他は読まなくていい」と明記するだけで改善します。
# 修正前
"src/ 以下のバグを直して"
# 修正後
"src/api/auth.ts だけを読んで修正して。他のファイルは読まなくていい"
壁3: 「コストが心配」
デフォルトは高性能な Opus モデルを使いますが、単純なタスクは Sonnet で十分です。
# セッション中にモデルを変更
/model claude-sonnet-4-6
まとめ: 最初の1週間でやること
Day 1: インストール + CLAUDE.md を書く
Day 2-3: 入門タスク (コード説明・レビュー) を試す
Day 4-5: 権限設定を入れて実際のファイル編集を試す
Day 6-7: 自分のワークフローに組み込む
Claude Code は使えば使うほど「こういう時に使えばいいのか」という感覚が育ちます。最初の1週間は「コードの説明を求める」「テストを書いてもらう」から始めて、徐々に複雑なタスクに挑戦していくのがスムーズです。
このサイト (claudecode-lab.com) は Claude Code で自動運営しており、記事生成・翻訳・デプロイを毎日自動化しています。最初は「本当にそんなことができるの?」と思いましたが、今はClaude Codeなしの開発が考えられないほど使い込んでいます。あなたもぜひ試してみてください。
教材・相談に進む判断基準
この記事だけで迷わず進めるなら、そのまま無料で試せば大丈夫です。次に進む判断基準は、詰まり方で分けると自然です。
- コマンドや安全な頼み方を手元で確認したい: 無料Claude Codeチートシート
- 設定、権限、
CLAUDE.md、hooksをまとめて整えたい: 教材一覧 - レビュー、デバッグ、テスト、ドキュメント作成の依頼文をすぐ使いたい: 50 Prompt Templates
- チーム導入、運用ルール、公開フロー、収益導線まで相談したい: 導入相談
私の実感では、個人で1〜2回試す段階なら無料チートシートで十分です。同じ作業を毎週くり返すようになったら教材、複数人や本番運用が絡むなら相談、という順で考えると押し売り感なく判断できます。
関連記事
無料PDF: Claude Code はじめてのチートシート
まずは無料PDFで基本コマンドと最初の使い方をまとめて確認してください。登録後はそのままテンプレート集や導入相談にも進めます。
スパムは送りません。登録情報は厳重に管理します。
Claude Codeを仕事で使える形にしませんか?
無料PDFで基礎を固めたあと、すぐ使えるテンプレート集で試し、必要なら業務自動化や導入相談まで進められます。
この記事を書いた人
Masa
Claude Codeの実務活用、導入設計、収益導線改善を検証しているエンジニア。10言語の技術メディアを運営中。
関連書籍・参考図書
この記事のテーマに関連する書籍を楽天ブックスで探せます。
※ 当サイトは楽天市場のアフィリエイトプログラムに参加しています。上記リンクから商品をご購入いただくと、運営者に紹介料が支払われる場合があります。
関連記事
Claude Code権限セーフティラダー: 初心者がallowを広げる順番
Claude Codeの権限をread-onlyからbuild、限定編集、deploy確認まで段階的に広げる安全な運用手順。
Claude Code Small PR Proof Pack: 小さなPRをレビュー可能にする証拠セット
Claude Codeの小さなPRに、差分・検証・公開URL・CTA・rollbackを添える実務チェックリスト。
Claude Codeのコミット前レビューゲート: 差分、テスト、CTAをまとめて止める型
Claude Codeでcommit前に差分をレビューする実践手順。build、公開URL、CTA、Gumroadリンク、未翻訳本文を検知します。