Claude Codeの使い方｜初心者が最初の30分で安全に試す手順
Claude Codeを入れたものの、最初に何を頼めばよいかわからない。そんなときは、いきなり機能追加や本番変更を任せず、『読ませる → 小さく直す → 人が確認する』を一度通すのがおすすめです。
この記事では、既存のコードを壊しにくい小さな題材で、Claude Codeとの最初の30分を進めます。開発経験が浅い人でも、何を確認すればよいか分かるようにまとめました。
先に結論：最初の一回は、公開済みのコードを説明させるか、見た目や文言だけの小さな変更に絞りましょう。変更前後の差分とテスト結果を自分で確認できれば、次の依頼の精度が上がります。
Claude Codeは何をしてくれる？
Claude Codeは、ターミナルからプロジェクトのファイルを読み、質問への回答、コードの変更、コマンドの実行を手伝うAIコーディング支援です。チャットでコードを貼り付けるだけの使い方と違い、作業中のリポジトリを前提に、関連ファイルを探して提案できます。
ただし、AIが提案した変更が正しいとは限りません。特に、設定変更、削除、外部サービスへの送信、本番環境への操作は、最初から任せないでください。Claude Codeは作業者、あなたは承認者という役割分担が基本です。
始める前の3分チェック
まず、公式のClaude Code Quickstartに沿って利用できる状態にします。利用条件や対応環境は変わるため、インストール方法・ログイン方法・料金は公式画面で最新情報を確認してください。
最初に開くフォルダは、次の条件を満たすものが安心です。
- Gitで管理され、変更履歴を確認できる
- 本番用の認証情報や顧客データを含まない
- 小さな見た目修正や文言修正を試せる
- テストまたはビルドの実行方法が分かる
作業前に git status を実行し、自分や同僚の未コミット変更がないかも確認します。変更がある状態で始めるなら、何が元からあった変更かを先にメモしておきましょう。
最初の10分：変更させずにプロジェクトを説明させる
最初の依頼は、読み取りだけに限定します。いきなり『この機能を作って』と頼むより、プロジェクトの地図を作る方が、後のやり取りが短くなります。
このリポジトリは何をするものですか。
ファイルは変更せず、次を箇条書きで説明してください。
- 起動方法
- 主な画面または機能
- 変更時に実行すべきテスト・ビルド
- 設定や秘密情報を扱うときの注意点
不明な点は推測せず、不明と書いてください。返答を見たら、特にコマンド名と対象ファイルを自分でも確認します。Claude Codeの公式ドキュメントでも、タスクの範囲と検証方法を具体的に伝えることが推奨されています。
この段階の目的は正解をもらうことではなく、AIがどこまで把握できていて、どこを人が補うべきかを知ることです。
次の10分：小さく、元に戻せる変更を頼む
次は、影響範囲が狭い変更を1つ選びます。たとえば、ボタンの文言、見出しの表現、READMEの説明などです。認証、課金、データベースの構造変更は後回しにします。
依頼には、目的・触ってよい範囲・完成条件・検証方法を入れます。
READMEのセットアップ手順を、初めて参加する開発者向けに読みやすくしてください。
- 変更してよいのは README.md のみ
- 既存のコマンド名と意味は変えない
- 不明な手順は補完せず、質問として残す
- 変更後に、何を変えたかを3点以内で説明するコードを変更する場合も同じです。『どの画面で』『どう見えるように』『どこまで触ってよいか』を渡します。曖昧な依頼は、AIの能力より前提不足でズレることが多いからです。
最後の10分：差分とテスト結果を自分で見る
変更後は、Claude Codeの説明だけで完了にしません。次の順で確認します。
git diffで、意図しないファイルが変わっていないか見る- 変更内容を読み、目的と違う表現・処理がないか見る
- プロジェクトで決まっているテストやビルドを実行する
- 失敗した場合は、エラー全文と再現手順を渡して原因を一緒に絞る
テストがないプロジェクトなら、ブラウザで変更した画面を開き、変更前に決めた完成条件を満たすかを確認します。『動いたように見える』だけでは、次の変更で困りやすくなります。
最初は避けたい4つの依頼
慣れるまでは、次の依頼を一度に出さない方が安全です。
- 『全部直して』『最適化して』のように完成条件がない依頼
- 本番環境へのデプロイ、外部サービスへの送信、権限変更
- APIキー、顧客情報、未公開資料をそのまま渡すこと
- テストなしで大規模なリファクタリングや削除をさせること
絶対に止めたい操作は、指示文だけに頼らず、権限設定や実行環境の分離で守る必要があります。プロジェクトの恒常的なルールは、公式のsettings files and precedenceも確認しながら、短く具体的に管理しましょう。
次に進むなら：毎回の説明を減らす
同じ説明を何度も書くようになったら、プロジェクトのルールを CLAUDE.md に整理する段階です。何を書くべきかは、CLAUDE.mdとAGENTS.mdの書き方で詳しく解説しています。
複数の調査やレビューを分けたいなら、Claude Codeのサブエージェント設計へ進んでください。どちらも、最初の小さな変更を安全に確認できるようになってから取り入れると効果が出やすいです。
今日の一歩
今日やるのは、作業中のプロジェクトでClaude Codeに『変更せずに、起動方法・テスト方法・注意点を説明して』と聞くことだけで構いません。返答と実際のファイルを見比べ、違った箇所を一つメモしてください。その差分が、次に渡すべき前提になります。
参照した一次情報（2026年9月12日確認）
※Claude Codeの対応環境、利用条件、料金、機能、権限設定は変更されることがあります。実行前に公式の最新情報と、所属組織のルールを確認してください。
