Blog

はじめに

Claude Codeを使い始めてしばらく経つと、「もっとうまく使えるはずだ」という感覚を持つことがあります。

実際、Claude Codeの機能を最大限に引き出すには、いくつかの重要なコツがあります。

この記事では、経験豊富なClaude Codeユーザーが活用しているTipsとトリックを厳選して紹介します。

これらを実践することで、Claude Codeとの作業効率が格段に向上します。

 

Tip 1：具体的かつ文脈豊かな指示を出す

Claude Codeへの指示の質が、出力の質を直接決定します。

漠然とした指示より、具体的で文脈豊かな指示が圧倒的に良い結果をもたらします。

悪い例：

 認証機能を実装して 

良い例：

 src/auth/ ディレクトリに 
JWT ベースの認証機能を実装してください。 
- アクセストークンの有効期限は15分 
- リフレッシュトークンの有効期限は7日 
- リフレッシュトークンはHTTPOnly 

クッキーに保存 
- 既存のUserモデル（src/models/user.ts）を使用 
- エラーハンドリングはsrc/shared/errors.tsのパターンに従う 
- 実装後にユニットテストも追加してください 

具体的な要件、使用するファイル、既存のパターンへの言及があることで、Claudeは意図に沿った実装を行えます。

 

Tip 2：CLAUDE.mdを徹底的に活用する

CLAUDE.mdは最も投資対効果の高い機能です。

一度書けば、以後のすべてのセッションで効果を発揮します。

特に効果的なCLAUDE.mdの内容：

 
## よく使うコマンド 
- テスト実行: `npm test` 
- ビルド: `npm run build` 
- ローカル起動: `npm run dev` (port 3000) 
- DBリセット: `npm run db:reset` 

## 絶対に変更しないファイル 
- src/legacy/payment_core.js (触れないでください) 
- config/production.env (本番環境設定) 

## このプロジェクトの特殊な慣習 
- APIの返り値は必ず { data, error, meta } の形式 
- 日時はすべてUTCで扱い、表示時のみJSTに変換 
- ユーザーIDはUUID v4を使用（連番は使わない）
 

Tip 3：コンテキストを引き継ぐ方法

Claude Codeのセッションは会話の履歴を持ちますが、新しいセッションでは引き継がれません。コンテキストを効果的に引き継ぐTips：

CLAUDE.mdに進行状況を記録する

 
現在の作業状況をCLAUDE.mdの「Current Work」セクションに 記録してください。
明日のセッションで再開できるよう、 
- 完了したこと 
- 進行中のこと 
- 次にやること 
- 注意点 を書いてください。 

/recapを活用する
長いセッションの途中で/recapを実行すると、これまでの作業のサマリーが表示されます。

新しいセッションを開始する前に確認するか、CLAUDE.mdに引き継ぎ情報をコピーします。

 

Tip 4：段階的に複雑さを増やす

一度に大きな変更を依頼するより、段階的に進める方が信頼性が高まります：

段階1：分析

 
このモジュールのコードを分析して、 
現在の実装の問題点と改善点をリストアップしてください。 
実装はまだ変更しないでください。 

段階2：計画の確認

 
先ほどの分析に基づいて、改善の計画を提案してください。 
変更の順番と、各変更の影響範囲を明示してください。 

段階3：実装

 
計画の最初のステップを実装してください。 
完了したらテストを実行して、問題がないことを確認してください。 

この段階的アプローチにより、各ステップで意図通りに進んでいることを確認できます。

 

Tip 5：ネガティブな制約を明示する

やって欲しいことだけでなく、やって欲しくないことも明示することが重要です：

 
src/components/UserCard.tsx をリファクタリングしてください。 
ただし： 
- コンポーネントのAPIは変更しない（他が依存しているため） 
- CSSはsrc/styles/components.css から変更しない 
- TypeScriptのany型は使わない 
- 動作を変える最適化は含めない（まずリファクタリングのみ） 

Tip 6：出力形式を指定する

必要な情報の形式を指定することで、後の処理が楽になります：

 
依存関係の分析結果を以下の形式でまとめてください： 

## 依存関係マップ 
| モジュール | 依存先 | 理由 | 重要度 | 
|-----------|-------|------|-------| 
| auth | database | ユーザーデータ | 高 | 

## 循環依存（危険） 
- ModuleA → ModuleB → ModuleA（理由：...） 

## 改善提案 優先度順にリストアップ 

Tip 7：プロジェクトのパターンを教える

Claude Codeは既存のコードのパターンを読み取りますが、明示的に教えることでより精度が上がります：

 
このプロジェクトでは以下のパターンでAPIエンドポイントを実装しています： 
[既存のエンドポイントのコードを貼り付け] 
このパターンに完全に従って、 
ユーザー更新エンドポイントを実装してください。 

Tip 8：チェックポイントを戦略的に使う

チェックポイントはいつでも使えますが、特に重要な変更の前に意識的に使いましょう：

 
これから大きな変更を加えます。 
まず現在の状態をチェックポイントとして保存してください。 
その後、[変更の内容]を実装してください。 

手動でチェックポイントを記録するには：

 /checkpoint save current-working-state 

Tip 9：エラーメッセージはそのまま貼り付ける

エラーが発生した場合、エラーメッセージを自分の言葉で説明するより、そのままコピーして貼り付ける方が確実です：

 
以下のエラーが発生しました： 
[エラーメッセージ全文をここに貼り付け] 
このエラーを修正してください。 

Claude Codeはエラーメッセージを正確に解析し、適切な修正を提案します。

 

Tip 10：/modelでタスクに合わせてモデルを選ぶ

使うモデルをタスクに合わせて切り替えることでコストと品質のバランスを取れます：

 
/model claude-haiku-4-5 
# 素早い確認やシンプルなタスク 
/model claude-sonnet-4-6 

# 通常の開発タスク（デフォルト） 
/model claude-opus-4-7 

# 複雑なアーキテクチャ設計やデバッグ 

コストを意識した使い分けが大切です。

 

Tip 11：/loopで粘り強く改善する

テストをパスさせたい、特定の品質基準を満たすまで繰り返したい場合：

 
/loop 以下の条件をすべて満たすまで改善を繰り返してください： 
1. 全テストがパスすること 
2. TypeScriptの型エラーがないこと 
3. ESLintのエラーがないこと 
4. カバレッジが80%以上であること 

Claude Codeが自律的に改善を繰り返し、全条件が満たされたら停止します。

 

Tip 12：作業後に知識を定着させる

Claude Codeがどのように問題を解決したかを理解することで、自身のスキルも向上します：

 
先ほどのバグ修正について、 
なぜこの方法が正しかったのかを説明してください。 
また、将来同様の問題を防ぐために コードレビューで注意すべき点も教えてください。 

Tip 13：定型タスクをショートカット化する

よく使うタスクをCLAUDE.mdにショートカットとして記録します：

 
## Quick Commands 
以下のショートカットを使用できます： 
- "PR準備"：lint, test, セキュリティチェックを実行してPR作成 
- "朝チェック"：未解決PR確認、失敗CI確認、今日のタスク整理 
- "週次レポート"：週間の変更サマリーとメトリクスを生成 

セッション開始時に「PR準備をお願いします」と言うだけで一連の作業が実行されます。

 

Tip 14：複数のアプローチを比較する

重要な実装判断の際、複数のアプローチを比較することも有効です：

 
このキャッシュの実装に3つのアプローチを提案してください： 
1. Redisを使ったインメモリキャッシュ 
2. データベースのキャッシュテーブル 
3. アプリケーションレベルのメモリキャッシュ 
各アプローチのメリット・デメリット、 
このプロジェクトへの適合性を比較してください。 

最後の選択は人間が行い、選んだアプローチの実装をClaude Codeに依頼します。

 

まとめ

Claude Codeを効果的に使うためのTipsの多くは、「より具体的に」「より文脈豊かに」というシンプルな原則に集約されます。

CLAUDE.mdの整備、段階的なアプローチ、チェックポイントの活用を組み合わせることで、Claude Codeとの作業の信頼性と効率が大幅に向上します。

これらのTipsを日々の開発に取り入れ、自分なりのベストプラクティスを積み上げていってください。

Claude Codeは使えば使うほど、あなたのプロジェクトの文脈を理解し、より的確なアシスタントになっていきます。

 

ご利用にあたってのお願い

本記事は執筆時点の情報をもとにしており、仕様変更により内容が古くなっている場合があります。
最新情報はAnthropic公式ドキュメントでご確認ください。
記事内のコマンドやコードの実行はご自身の責任で行ってください。
AIの出力は必ずレビュー・検証した上でご利用ください。
とくにAPIキーや機密情報の取り扱い、セキュリティ設定の変更には十分ご注意ください。