Claude Code: Claude Code 활용 가이드

プロンプトの質が成果を決める

Claude Codeの출력品質はプロンプトの質に大きく依存します。기본적인プロンプトの書き方は효과적인プロンプトの5つのコツで解説しましたが、이글では더 나아가高度なテクニックを紹介します。

テクニック1：制約指定プロンプト

「何をすべきか」뿐만 아니라「何をすべきでないか」を明示します。

> 사용자검색機能를 구현해줘。
>
> 制約：
> - any타입は使わない
> - 外部라이브러리は추가しない（既存の依存のみ使用）
> - SQLは直接書かずPrisma clientを使用
> - console.logは残さない
> - 1함수50行以内

制約を明示することで、レビューで差し戻されるような問題を事前に防げます。

テクニック2：ステップバイステップ指示

複雑な태스크は段階的に指示します。

> 다음의ステップで알림システム를 구현해줘。
> 각ステップ완료後に테스트が通ることを확인してから
> 次に進んで。
>
> Step 1: 알림の타입定義（Notification, NotificationType）
> Step 2: 알림サービス클래스（생성、既読、Delete）
> Step 3: API엔드포인트（CRUD + WebSocket）
> Step 4: React hooks（useNotifications）
> Step 5: UI컴포넌트（NotificationBell, NotificationList）

テクニック3：출력形式の指定

期待する출력形式を明確にします。

> 이コードをレビューして。結果は다음의形式で：
>
> ## 致命的な問題
> - [파일名:行番号] 問題の説明 → 수정案
>
> ## 改善推奨
> - [파일名:行番号] 問題の説明 → 수정案
>
> ## 品質スコア
> 보안: X/10
> 성능: X/10
> 유지보수성: X/10
> 테스트: X/10

テクニック4：ロールとコンテキストの설정

CLAUDE.mdに프로젝트固有のコンテキストを설정します。

# CLAUDE.md

## プロジェクト概要
ECサイトのバックエンドAPI。TypeScript + Express + Prisma。
月間100万PVを想定した設計。

## 技術スタック
- Runtime: Node.js 20
- Framework: Express 4
- ORM: Prisma 5
- DB: PostgreSQL 16
- Cache: Redis 7
- Test: Vitest

## コーディング規約
- 関数名は動詞で始める（get, create, update, delete）
- 非同期関数は必ずasync/awaitを使用
- エラーはカスタムエラークラスを使用（throw new NotFoundError()）
- APIレスポンスは { data, meta, error } 形式

## 禁止事項
- any型の使用
- console.log（loggerモジュールを使用）
- var宣言
- ==（===を使用）
- 外部APIのURLハードコード（環境変数を使用）

CLAUDE.mdの書き方의 상세 정보는CLAUDE.mdの書き方完全가이드를 참고하세요.

テクニック5：比較・선택を求める

複数の선택肢を提示させてから決定します。

> 状態관리のアプローチを3つ提案して。
> 각案のメリット・デメリット・コード例を示して。
> 判断は私がするので구현はまだしないで。
>
> 候補：
> 1. React Context + useReducer
> 2. Zustand
> 3. Jotai

テクニック6：メタプロンプト

Claude Code에最適なプロンプトを생성させます。

> 大規模な데이터베이스리팩터링を
> Claude Code로実施したい。
> 最適なプロンプトの구성を提案して。
> 安全性を最大限確保する指示を含めて。

テクニック7：イテレーティブな改善

一度で完璧を目指さず、段階的に改善します。

> まずシンプルに動く구현を作って。테스트も書いて。

> 動いたので、以下を改善して：
> - 에러 핸들링を추가
> - 입력유효성 검사を強化
> - 성능を최적화
> 改善後も테스트が通ることを확인して。

> いい感じ。最後に리팩터링して：
> - 함수を分割して単一責任に
> - 命名を改善
> - 문서댓글を추가

テクニック8：실패パターンからの学習

うまくいかなかった指示を改善する方法です。

> （悪い例）
> いい感じに리팩터링して。

> （良い例）
> src/services/orderService.ts を리팩터링して。
> 目標：
> - 200行を超えている함수を50行以内に分割
> - ビジネスロジックとDB操作を分離
> - 테스트커버리지を維持（現在75%）
> - 公開APIの타입シグネチャは変えない

구체적인数値や制約を入れることで、Claude Codeの출력が格段に改善します。生産性全般のTipsは生産性を3倍にする10のTipsを、리팩터링の具体例は리팩터링자동화가이드도 함께 확인하세요.

정리

上級プロンプトエンジニアリングのポイントは、制約の明示、段階的な指示、출력形式の指定です。CLAUDE.mdに프로젝트のコンテキストを充実させることで、毎回のプロンプトが短くなり、一貫した品質が得られます。

プロンプトエンジニアリング의 상세 정보는Anthropic공식 문서やプロンプトエンジニアリング가이드를 참고하세요.