Claude Code導入チェックリスト｜最初の修正を安全に試す
更新日：2026年9月29日
Claude Codeを初めて使う人向けに、インストール前後で確認する項目をまとめます。対象はターミナルとGitを使ったことがある開発者です。
先に結論
最初は公開リポジトリのコピーで、読み取り、1ファイルの修正、テスト実行の順に試します。秘密情報を含む本番リポジトリを最初の題材にしません。
手順
- OS、Node.js、Gitのバージョンを記録する。
- Claude Codeの公式クイックスタートで認証条件を確認する。
- 作業用ブランチを作り、変更前のテストを実行する。
- 「この関数の役割とテストを説明して」と読み取りだけ依頼する。
- 変更を依頼するときは対象ファイル、禁止事項、実行するテストを指定する。
- 差分を自分で読み、テストと秘密情報の混入を確認してからコミットする。
実際に試す題材
次のような小さなPython関数を作業用リポジトリへ置きます。
def normalize_name(value: str) -> str:
return " ".join(value.strip().split()).title()
最初の依頼は「この関数の動作を説明し、変更はせず、足りないテストケースを3つ挙げて」です。次に「テストだけを追加し、関数本体は変更しない。実行コマンドと結果を示して」と依頼します。
期待する確認は、" ada lovelace " が "Ada Lovelace" になり、空文字と日本語入力も扱えることです。AIが関数本体まで変更したら、差分を戻して依頼を分けます。
よくある失敗
Node.jsや認証条件を確認せず始める、作業ブランチを作らない、テスト結果を保存しない、APIキーをプロンプトへ貼る、の4つです。最初の成功は「AIがコードを書いた」ではなく、変更を説明して安全に戻せることです。
最初の完了条件
変更前後のテスト結果、差分、使った指示を残せれば完了です。テストがない場合は、先に期待する動作を3例書きます。
失敗時
認証エラーは公式の認証案内、権限エラーはリポジトリ権限、予期しない変更は作業ブランチと差分を確認します。自動で再実行せず、原因を記録します。
次に読む記事
Claude Code講座の選び方で、独学と研修の分岐を確認できます。
コメント