Claude Codeを使ったサンプルプロジェクト（Sample）最速構築

【結論】安全なSample Projectを作る

Claude CodeのSampleは、実Projectではなく小さなGit repositoryでRead、Plan、Edit、Test、Reviewを一巡できるものが適しています。

最初からDeploymentやSecretを含めず、単一Bugと明確なTestを用意します。

生成結果より、Permission確認、Diff review、Rollbackを学べる構成にします。

# ターミナルで実行：Sample repositoryを作成
mkdir claude-sample && cd claude-sample && git init
# ターミナルで実行：簡単なPython fileを作成
printf '%s\n' 'def add(a, b):' '    return a - b' > calc.py
# ターミナルで実行：初期状態を保存
git add calc.py && git commit -m 'add sample bug'
# ターミナルで実行：Planモードで開始
claude --permission-mode plan

具体的な手順・設定方法

1. Bugと期待結果をREADMEへ記載します。

2. Claude Codeへ調査とTest計画だけを依頼します。

3. 承認後に最小修正とTestを実行します。

4. DiffとCommitを確認し、別Branchで再試行します。

実践プロンプト / 活用テクニック

# 起動後のセッション内で入力
calc.pyのBugを調査してください。
期待動作はadd(2, 3)が5になることです。
まだ編集せず、原因、最小修正、Test caseを提示してください。

注意点・よくあるエラーと対処法

Sampleに実API keyや個人Dataを含めないでください。

成功例だけでなく誤変更のRollbackも演習します。

一度の成功を本番品質の証明にしません。