Claude Codeを「最強の相棒」にするための実践ベストプラクティス集
shanraisshan/claude-code-best-practice
今回は、最近話題の Claude Code を使いこなすためのバイブル的存在、claude-code-best-practice についてや。これを知ってるかどうかで、開発効率が「サラダチキン」か「特上カルビ」くらい変わってくるから、しっかりついてきてや!
ダイエットで言うなら「最強のパーソナルトレーナー」が横に座ってるようなもんや。
「Vibe Coding(バイブ・コーディング)」の極致
「こんな感じの機能作って」っていうフワッとした指示(バイブス)を、Claudeが正確にコードに落とし込んでくれる。
文脈(コンテキスト)の理解力がエグい
プロジェクト全体の構造を把握した上で提案してくれるから、コピペミスが減る。
「動く」までのスピード
自分で一から for ループ書いてる間に、ClaudeはAPIの実装からテストコードまで書き終えてる。エンジニアは「設計」と「レビュー」に集中できるんや。
まずは Claude Code 自体をインストールせなあかん。ダイエットと同じで、まずは形から入るのが大事や!
# Claude Codeをインストール(npmを使うで)
npm install -g @anthropic-ai/claude-code
# プロジェクトのディレクトリに移動して起動!
cd my-awesome-project
claude
これで、Claudeが君のターミナルに居座るようになる。あとは、claude-code-best-practice で推奨されてる「振る舞い」を意識するだけや。
「お腹空いた、なんか食べさせて」って言うたら、プロのトレーナーは怒るやろ?「高タンパク低糖質で、15分で作れる鶏胸肉料理を教えて」って言うのがエンジニアの作法や。
Claudeに「リファクタリングして」だけじゃなくて、こう指示するんや。
# Claudeへの指示
/ask 以下の条件で `UserService.ts` をリファクタリングして。
- 重複しているバリデーション論理を共通関数に切り出す。
- エラーハンドリングに独自の `AppError` クラスを使用する。
- 既存のユニットテストが通ることを確認して。
Claude Codeはファイルを直接見れるから、必要なファイルだけを明示的に食わせるのがコツや(情報の過剰摂取はメタボの元やからな)。
# 特定のファイルを読み込ませて編集させる
claude "Review @api/auth.py and fix the session expiration bug."
エンジニア(空腹)
「Claude、このReactコンポーネント、なんか重いねん。シュッとさせて。あ、ついでに僕の体重もシュッとさせて」
Claude
「(無視して)了解。useMemo を追加して不要な再レンダリングを抑えます。依存配列に userId を含めるのがベストプラクティスです。あと、間食のドーナツは論理削除(ゴミ箱ポイ)してください」
エンジニア
「ううっ、論理削除じゃなくて物理削除(胃袋直行)したい……。でも、提案されたコードは完璧や。テストも自動で書いてくれたし、これなら浮いた時間でスクワットできるわ……(涙)」
このリポジトリ(claude-code-best-practice)が教えてくれるのは、「Claudeを単なるAIチャットとしてではなく、ターミナル上で一緒に働く『同僚』として扱う方法」や。
指示は明確に。
ファイルのコンテキストを適切に与える。
生成されたコードは必ずテストで検証する。
これを守れば、君のコードはどんどん筋肉質(クリーン)になっていくはずや!