Advanced

Claude Code:Claude Code 实战指南

了解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官方文档プロンプトエンジニアリング指南

#Claude Code #プロンプトエンジニアリング #上級 #CLAUDE.md #プロンプト設計