この記事でわかること
- CLAUDE.mdの書き方と効果
- エージェントモードを効果的に使う方法
- 並列エージェントとGitを組み合わせた開発フロー
- MCPと組み合わせた拡張活用
Claude Codeの使い方を一段階進める
Claude Codeを使いはじめてしばらく経つんですが、最初はただターミナルで「このバグ直して」って打ってるだけでした。それでも十分便利なんですが、ちゃんと使い方を覚えたらもっと開発体験が変わるよ、という話です。
余談ですが、Cursorも使ってるので「どっちがいいんだろう」と毎日悩んでます。結論は「用途で使い分け」なんですが、それはまた別の話。
CLAUDE.mdを整備する
Claude CodeにはCLAUDE.mdというファイルをプロジェクトルートに置いておくと、毎回の会話で自動的に読み込んでくれる仕組みがあります。いわゆる「プロジェクトのルールブック」みたいなもので、これを整備するだけで会話の質が大きく変わります。
実際に自分が書いてるのはこんな感じです。
# プロジェクト概要
Pythonで書いたAWS Lambda関数群。DynamoDBとS3を使っています。
# コーディングルール
- 関数は型アノテーションをつける
- エラーハンドリングは必ずtry/exceptで
- ログはprint()ではなくlogging.getLogger()を使う
# よく使うコマンド
- テスト実行: pytest tests/ -v
- デプロイ: ./deploy.sh staging
これを書いておくだけで、毎回「このプロジェクトはPythonで〜」と説明しなくて済みます。地味だけど、コンテキストの解像度が上がるのでClaude Codeの精度もグッと向上します。
エージェントモードで効率的に「タスクを委譲する」
Claude Codeの強みのひとつが、ファイルの読み書きやコマンド実行を自律的にやってくれるエージェントモードです。「この機能追加して」とだけ言えば、ファイルを探して、修正して、テストまで走らせてくれる流れができるんですが、やり方次第で結果が大きく変わります。
自分が意識してる使い方は以下の3つです。
- タスクの粒度を小さくする：「ユーザー認証機能を全部作って」より「JWTのデコード処理だけ書いて」のほうが正確。スコープが明確だとエージェントも迷わない
- git diffで確認する習慣をつける：エージェントが何を変えたかを毎回確認する。意外と関係ないところも触ってることがあるので、これは必須
- テストを先に書かせる：「先にテストを書いて、それをパスする実装をして」という流れにすると、コードの品質が上がりやすい傾向にあります
並列エージェントでブランチ作業を同時進行させる
最近のアップデートで並列ツール処理が強化されていて、複数のサブエージェントに別々のタスクを振ることができるようになっています。これをGitブランチと組み合わせると、「フロント側の修正」と「APIレスポンスの修正」を別ブランチで同時進行させるのが割と簡単になりました。
ただし、コンテキストが分散するのでそれぞれに適切なCLAUDE.mdを用意するか、プロンプトで背景情報をしっかり渡す必要があります。このあたりはまだ試行錯誤中ですが、工夫次第で開発スピードが上がる実感があります。
MCPと組み合わせると活用の幅が広がる
Claude CodeはMCP（Model Context Protocol）に対応しているので、GitHub MCPやNotion MCPと繋げると、「このIssueを実装して」→コードを書いてPRまで作る、みたいな流れも組めます。以前MCP単体の記事を書いたんですが、Claude Codeと組み合わせるとエコシステムとしての価値が出てくる感じです。
※この記事にはプロモーションが含まれます
ちなみに、Aiarty Image Enhancer（AI画像高画質化ツール。ノイズ除去・8倍拡大に対応）も気になっています。Aiarty Image Enhancer
まとめ
Claude Codeはただ使うだけでも便利なんですが、CLAUDE.mdをちゃんと書く・タスク粒度を意識する・git diffで確認する、この3つを意識するだけで開発の質がだいぶ変わります。エージェント機能はまだ「うまく使いこなせてる」とは言えないんですが、少しずつ精度が上がってきました。引き続き試していきます。
参考になったらクリックしてもらえると嬉しいです!
