【結論】開発ベストプラクティスの設定
実務の基本は、短いCLAUDE.md、permissions、小さなタスク、Git、テスト、差分レビューです。
旧記事で多用される.claudeignoreではなく、読ませたくないファイルは.claude/settings.jsonのdenyルールで制御します。
文脈は/contextで確認し、関連作業は/compact、別作業は/clearで整理します。
# ターミナルで実行:設定用ディレクトリを作成
mkdir -p .claude
# ターミナルで実行:機密ファイルの読み取り拒否を設定
cat > .claude/settings.json <<'JSON'
{
"permissions": {
"deny": ["Read(.env)", "Read(**/.env)", "Read(**/secrets/**)"]
}
}
JSON
# ターミナルで実行:Claude Codeを起動
claude
具体的な手順・設定方法
セッション内の
/initでCLAUDE.mdを作り、実際のビルド、テスト、Lint、禁止事項だけを残します。依頼ごとに対象、変更禁止範囲、完了条件、検証コマンドを指定します。
実装後は
/diff、/code-review、テスト結果を確認してからコミットします。
実践プロンプト / 活用テクニック
規約とスコープを固定する実践例です。
CLAUDE.md の規約に従い、src/components/Header.tsx だけを変更してください。
先に変更計画を示し、承認後に実装してください。
型チェックと関連テストを実行し、他ファイルを変更した場合は理由を報告してください。
注意点・よくあるエラーと対処法
CLAUDE.mdは行動を導く指示であり、セキュリティ境界ではありません。
読み取り禁止やコマンド制限はpermissions、組織全体の統制はmanaged settingsで実装します。
チェックポイントはBashや外部APIの副作用を戻せないため、Gitとバックアップを併用してください。