Chronist

Anthropic公式に学ぶClaude Codeベストプラクティス徹底解説

Chronist Team Chronist Team

エンジニアの開発現場では、「AIをどのようにワークフローに組み込むか」が重要なテーマとなっています。その解決策のひとつが、コマンドラインからAIを活用できるエージェント型のコーディング支援ツール Claude Code です。柔軟で強力な一方、効果的に使いこなすには一定のコツが必要です。

Anthropicが公開している 「 Claude Code: Best practices for agentic coding 」 では、同社のエンジニアが実際に活用してきた知見をまとめています。

本記事では、この公式記事を参考に、Claude Codeを日常の開発で活用するためのベストプラクティスを整理しました。ぜひ、自分のプロジェクトに取り入れる際のヒントとしてご活用ください。

あわせてご覧ください

Claude Code公式Tips集｜生産性を高める実践テクニック

Claude Codeとは？

まず、Claude Codeがどのようなツールかを理解しておきましょう。

Claude Codeは「低レベルで非依存的」な設計方針に基づいており、ほぼ生のモデルアクセスを提供します。特定のワークフローに縛られず、自由にスクリプト化・自動化できる点が特徴です。

  • シンプルで低レベルな設計：余計な枠組みを押し付けずに利用可能

  • 高い柔軟性：各チームの開発文化に合わせてカスタマイズ可能

  • 安全設計：危険な操作は必ず許可が求められる

あわせてご覧ください

Claude Codeとは？料金・機能・安全性をまとめて理解する導入ガイド

セットアップを最適化する

Claude Codeを活用する第一歩は、環境設定を整えることです。特に「CLAUDE.md」と権限管理は欠かせません。

CLAUDE.mdファイルを活用する

Claude Codeは、特定のファイルを自動で参照してコンテキストに取り込みます。その代表例が「CLAUDE.md」です。ここに情報を整理しておくことで、Claudeの理解が深まり、やり取りがスムーズになります。

記載例：

  • よく使うbashコマンド

  • コーディング規約やスタイルガイド

  • テスト実行方法

  • ブランチ命名規則などの運用ルール

  • 環境構築手順や注意点

# Bash commands
- npm run build: Build the project
- npm run typecheck: Run the typechecker


# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')


# Workflow
- Be sure to typecheck when you're done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance

場所はプロジェクトルートが推奨ですが、~/.claude/ に置けば全セッションで利用できます。

ツール利用権限を調整する

初期状態ではClaude Codeが行える操作は制限されています。これは安全性を考慮した仕様です。よく使う操作（例：ファイル編集、git commit）は /permissions や --allowedTools オプションであらかじめ許可しておくと効率的です。

Claudeに道具を与える

Claude Codeは単体でも便利ですが、環境内のツールや外部サービスと連携させることで、真価を発揮します。人間のエンジニアが「手元の便利ツール」を駆使するように、Claudeにも道具を持たせると作業効率が大きく変わります。

bashツールと連携

Claudeはシェル環境を引き継ぐため、既存のbashコマンドやユーティリティをそのまま利用できます。

  • ls や grep などの基本コマンドはClaudeも理解しています。

  • チームで用意した独自スクリプトについては、CLAUDE.md に使い方を明記しておくと認識しやすくなります。

  • たとえば「ログ解析用スクリプト」「デプロイスクリプト」を登録しておけば、Claudeが自律的に呼び出せるようになります。

MCPで拡張する

Claude CodeはMCP（Model Context Protocol）のサーバー・クライアントとして動作可能です。これにより外部ツールの呼び出しが容易になり、できることが飛躍的に増えます。

  • ブラウザ操作

Puppeteerサーバーを登録してUIテストやスクリーンショット取得

  • 監視ツール連携

Sentryサーバーを使ってエラーログを自動分析

  • チーム共有

.mcp.json に設定をチェックインしておけば、全員が同じツール群をClaude経由で利用可能

カスタムスラッシュコマンド

繰り返し発生するタスクは、スラッシュコマンドとして登録しておくと便利です。

.claude/commands にMarkdown形式で保存すれば、チーム全員がショートカットとして利用できます。

活用例：

  • GitHubのIssue番号を入力するだけで「調査→修正→PR作成」まで自動化

  • ログ解析ルーチンを1コマンドで呼び出し

  • 大規模コード修正をチェックリスト形式で順番に進行

例：GitHub issue修正フローを自動化するコマンドを定義。

Please analyze and fix the GitHub issue: $ARGUMENTS.


Follow these steps:
1. Use gh issue view to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR


Remember to use the GitHub CLI (gh) for all GitHub-related tasks.

ポイントは「Claudeが毎回ゼロから考えるのではなく、決まりきった流れはあらかじめ型化して渡す」こと。これにより一貫性とスピードが大きく向上します。

成功しやすいワークフロー

Claude Codeは自由度が高いため、活用方法は人それぞれですが、特に効果的とされるワークフローがいくつかあります。

  • 探る → 計画 → 実装 → コミット

まず調査と計画を行い、方針を固めてから実装に進むと安定度が増す。

  • テスト駆動開発（TDD）との組み合わせ

Claudeにテストを書かせてから実装させることで品質を担保できる。

  • スクリーンショットでの反復改善

UI設計やモックと比較しながら改善を繰り返すと完成度が高まる。

  • 安全なYOLOモード

許可確認をスキップして一気に処理する方法。ただしDockerなど安全な環境での利用推奨。

  • コードベースQ&A

新規プロジェクト参加時に「ロギングはどうなっている？」など質問するだけで調査可能。

  • GitやGitHub操作の自動化

コミットメッセージ作成やPR修正、履歴調査などをClaudeに任せられる。

効果を最大化するコツ

Claude Codeをうまく使いこなすには、小さな工夫が大きな差を生みます。

  • 具体的な指示を出す

「テストを追加」ではなく「 foo.py にログアウト時のテストケースを追加」と伝える

PoorGood
foo.py にテストを追加するfoo.py に新しいテストケースを追加し、ユーザーがログアウトしている場合のエッジケースをカバーする。モックは使用しないこと
ExecutionFactoryはなぜこんなに変なAPIなの？ExecutionFactoryのGit履歴を確認し、そのAPIがどのようにしてこの形になったのかをまとめる
カレンダーウィジェットを追加するホームページに実装されている既存のウィジェットを確認し、パターンやコードとインターフェースの分離方法を理解する。HotDogWidget.phpが良い参考例。次に、そのパターンに従って新しいカレンダーウィジェットを実装し、ユーザーが月を選択し、前後にページネーションして年を選べるようにする。他のライブラリは使わず、既存コードベースで使われているもののみを使用してゼロから構築する。
  • 画像やURLを渡す

設計モックやドキュメントをそのまま共有すると精度が向上

設計モックで精度向上

引用： https://www.anthropic.com/engineering/claude-code-best-practices

  • 早めに修正指示をする

計画段階での方向転換が効率的

  • /clearで文脈整理

長時間のセッションはリセットを活用

  • チェックリストやScratchpadを活用

大規模タスクはMarkdownで進行管理すると精度が上がる

自動化とマルチClaude活用

Claude Codeは自動化や並列活用でも力を発揮します。

  • ヘッドレスモード

CI/CDやlint、GitHub Issueの自動ラベル付けなどに利用可能

  • 複数Claudeの並行利用

1つがコードを書き、もう1つがレビューする、といった役割分担が可能

  • git worktreeの活用

複数ブランチを同時に進行させる場合に便利

まとめ

Claude Codeは、コマンドラインからAIを活用できる「開発者の新しい相棒」です。

Anthropic公式のベストプラクティスから見えてくるのは、次の3つの軸です。

  1. 環境整備 – CLAUDE.mdや権限設定で「正しい前提」をClaudeに与える

  2. 道具の提供 – bashツールやMCP、スラッシュコマンドを通じてClaudeを強化する

  3. ワークフロー設計 – 調査・計画・実装・レビューといった流れを明示し、Claudeを活かす

これらを意識すれば、単なるコード補助にとどまらず、開発プロセス全体をAIで支えることができます。 まずは CLAUDE.mdの整備 と よく使うスクリプトの登録 から試してみてください。小さな改善が、やがて大きな開発効率化につながります。