Claude Code ultrathink 完全ガイド — 拡張思考モードの使い方と効果的な活用法

ultrathink とは？ — Claude Code の「深く考える」モード

「Claude Code に複雑な設計を任せたら、浅い回答しか返ってこなかった…」 その悩み、ultrathink で解決できます。拡張思考モードを使いこなせば、Claude Code の実力を最大限に引き出せます。

ultrathink は、Claude Code の**拡張思考（Extended Thinking）**モードを最大レベルで発動させるキーワードです。通常のプロンプトに特定のキーワードを含めることで、Claude が回答を生成する前により長い内部推論プロセスを実行し、より深い分析と高品質な回答を返します。

思考レベルの段階

Claude Code には複数の思考レベルがあり、プロンプトに含めるキーワードによってレベルが変わります。

キーワード	思考レベル	思考トークン目安	用途
（指定なし）	標準	なし	簡単な質問、単純な修正
think	レベル1	数千トークン	中程度の複雑さのタスク
think hard	レベル2	約1万トークン	複雑なバグ修正、リファクタ
think harder	レベル3	約2万トークン	設計判断、アーキテクチャ検討
ultrathink	最大	約3万トークン以上	最も複雑な問題の分析

💡 Tips: 思考レベルが高いほど、内部で使用するトークン数が増え、処理時間も長くなります。すべてのタスクでultrathinkを使うのではなく、複雑さに応じて使い分けるのがポイントです。

---

ultrathink の有効化方法

方法1: プロンプトにキーワードを含める

最もシンプルな方法です。プロンプトの中に ultrathink というキーワードを含めるだけです。

# Claude Code CLI での使用例
claude "ultrathink このプロジェクトのアーキテクチャを分析して、パフォーマンスのボトルネックを特定してください"

# または文末に付ける
claude "この認証フローのセキュリティ上の問題を分析してください ultrathink"

方法2: 設定ファイルでデフォルトを変更

~/.claude/settings.json で拡張思考をデフォルトで有効にできます。

{
  "preferences": {
    "alwaysThinkingEnabled": true
  }
}

この設定では常に拡張思考が有効になりますが、ultrathink レベルではなく標準の think レベルです。

方法3: セッション中にトグル

Claude Code のセッション中に Option + T（macOS）/ Alt + T（Windows/Linux）で拡張思考のオン・オフを切り替えられます。

方法4: 環境変数で思考トークンの上限を設定

# 思考トークンの上限を設定
export MAX_THINKING_TOKENS=31999

# Claude Code を起動
claude

---

通常モードと ultrathink の比較

出力品質の違い

同じプロンプトを通常モードとultrathinkモードで比較してみましょう。

プロンプト例:

「このNext.jsアプリのAPI Routes をApp Router のRoute Handlers に移行する計画を立ててください」

通常モードの回答傾向

- 基本的な移行手順のリスト
- 主要なAPIルートの列挙
- 一般的な注意点
- 概要レベルの計画

ultrathink モードの回答傾向

- 既存のAPI Routes の依存関係分析
- 移行の優先順位付け（依存度の低いものから）
- 各ルートの具体的な変更点とコード例
- エッジケースの洗い出し
- 段階的な移行計画（Phase 1, 2, 3...）
- テスト戦略
- ロールバック計画
- パフォーマンスへの影響評価

処理時間の比較

モード	処理時間目安	コスト	出力品質
標準	5〜15秒	低	十分（単純なタスク向け）
think	10〜30秒	中	良い
think hard	20〜60秒	高	とても良い
ultrathink	30〜120秒	最高	最高品質

---

ultrathink が効果的な使い所

1. アーキテクチャ設計

プロジェクト全体の設計やリアーキテクチャを検討する際に最も効果を発揮します。

# アーキテクチャ設計の例
claude "ultrathink
このモノリシックなExpressアプリをマイクロサービスに分割する計画を立ててください。
現在の構成:
- /api/users - ユーザー管理
- /api/orders - 注文管理
- /api/payments - 決済処理
- /api/notifications - 通知
共有データベース: PostgreSQL
考慮事項: チーム3名、段階的移行、ダウンタイムゼロ"

ultrathink を使うことで、以下のような深い分析が期待できます。

• サービス境界の適切な設計
• データの整合性をどう担保するか
• 段階的な移行ロードマップ
• 各フェーズでのリスクと対策

2. 複雑なバグの根本原因分析

再現が難しいバグや、複数のコンポーネントにまたがるバグの分析に有効です。

claude "ultrathink
以下のバグを分析してください:
- 症状: 本番環境でのみ、特定の条件下でAPIレスポンスが空になる
- 発生条件: 高負荷時、特にDBコネクションプールが80%以上使用されている時
- ログ: TimeoutError が散発的に記録されている
- 再現: ローカル環境では再現できない
関連するコードは src/api/ と src/db/ にあります"

3. セキュリティレビュー

認証・認可フローや機密データの取り扱いなど、セキュリティに関わるコードレビューでは、深い思考が必要です。

claude "ultrathink
このOAuth2.0の認証フローのセキュリティを包括的にレビューしてください。
以下の観点を含めてください:
- CSRF対策
- トークンの保存方法
- リフレッシュトークンのローテーション
- セッション管理
- PKCE の実装"

4. パフォーマンス最適化

ボトルネックの特定と最適化戦略の立案に活用できます。

claude "ultrathink
このReactアプリのパフォーマンスを改善する計画を立ててください。
現在の問題:
- First Contentful Paint: 3.2秒
- Largest Contentful Paint: 5.8秒
- Total Blocking Time: 800ms
- バンドルサイズ: 2.1MB（gzip後450KB）
使用ライブラリ: React 19, Next.js 15, MUI v6, recharts"

5. データベース設計・移行

スキーマ設計や大規模なマイグレーションの計画に向いています。

claude "ultrathink
現在のMongoDBスキーマをPostgreSQLに移行する計画を立ててください。
- コレクション数: 15
- ドキュメント数: 約500万件
- 埋め込みドキュメントの多用あり
- リアルタイムのトランザクション処理あり
ダウンタイムは最大30分まで許容"

---

ultrathink を使わない方がよいケース

すべてのタスクに ultrathink を使うのは非効率です。以下のケースでは通常モードで十分です。

ケース	理由	推奨モード
単純なコード生成	十分な品質が得られる	標準
typo の修正	深い思考が不要	標準
ドキュメントの更新	分析が不要	標準
定型的なCRUD作成	パターンが明確	標準 or think
単一ファイルの小さな修正	コンテキストが限定的	標準
既知のライブラリの使い方	知識の取り出しだけ	標準

---

実際の出力例: ultrathink でのアーキテクチャ分析

以下は、ultrathink を使って実際に得られる回答の構造例です。

プロンプト

ultrathink このAstroプロジェクトのビルド時間を半分に短縮する方法を提案してください

回答の構造（要約）

## 分析結果

### 現状の把握
- ビルド時間: 約4分30秒
- ページ数: 約200ページ
- 画像処理: sharp による最適化が全画像に対して実行
- MDXコンパイル: remarkプラグイン5個、rehypeプラグイン3個

### ボトルネックの特定
1. 画像処理（全体の45% — 約2分）
   - 未キャッシュの画像が毎回再処理されている
   - 元画像のサイズが大きい（平均3MB）
2. MDXコンパイル（全体の30% — 約1分20秒）
   - 重いremarkプラグインが全ファイルに適用
3. SSGレンダリング（全体の25% — 約1分10秒）

### 改善提案（優先度順）

#### Phase 1: 画像処理の最適化（期待効果: -40%）
- astro.config.mjs で画像キャッシュを有効化
- 元画像をあらかじめ適切なサイズに縮小
- WebP 形式での事前変換スクリプト作成

#### Phase 2: MDXコンパイルの高速化（期待効果: -20%）
- 不要なremarkプラグインの削除
- remark-smartypants を軽量な代替に置換

#### Phase 3: ビルドプロセスの並列化（期待効果: -15%）
- workerThreads の有効化
- インクリメンタルビルドの検討

### 期待されるビルド時間
- 現在: 約4分30秒
- Phase 1 後: 約2分40秒
- Phase 2 後: 約2分10秒
- Phase 3 後: 約1分50秒

---

ultrathink と Plan モードの組み合わせ

Claude Code の Plan モード（Shift + Tab で切り替え）と ultrathink を組み合わせると、さらに効果的です。Claude Codeのエージェントモードについては「Claude Code エージェントモード完全ガイド」で詳しく解説しています。

組み合わせの手順

# Step 1: Plan モードに切り替え（Shift + Tab）
# Step 2: ultrathink で計画を立てる
"ultrathink このプロジェクトにE2Eテストを導入する計画を立ててください"

# Step 3: 計画を確認・承認
# Step 4: Act モードに切り替え（Shift + Tab）
# Step 5: 計画に沿って実装を依頼
"計画のPhase 1を実装してください"

Plan モード + ultrathink が特に有効なケース

• 大規模なリファクタリング: 変更箇所が多く、影響範囲が広いとき
• 新しいアーキテクチャの導入: マイクロサービス、モジュラーモノリスなど
• 技術スタックの移行: Vue → React、Express → Fastify など
• パフォーマンスの全体最適化: 複数のボトルネックが絡み合うとき

---

CLAUDE.md での思考レベル制御

プロジェクトの CLAUDE.md に思考レベルに関するルールを書いておくと、タスクの種類に応じて適切な思考レベルが自動的に適用されやすくなります。CLAUDE.mdの書き方については「CLAUDE.md 完全ガイド」を参照してください。

# CLAUDE.md の例

## 思考レベルのガイドライン

### ultrathink を使うべきタスク
- アーキテクチャに関わる変更
- セキュリティに関わるコードレビュー
- 3ファイル以上にまたがるリファクタリング
- パフォーマンス最適化の計画策定

### think hard を使うべきタスク
- バグの根本原因分析
- 新機能の設計
- テスト戦略の策定

### 通常モードで十分なタスク
- 単一ファイルの修正
- ドキュメントの更新
- 定型的なコード生成

---

ultrathink の思考プロセスを確認する方法

ultrathink で Claude がどのように考えたかを確認するには、Verbose モードを有効にします。

Verbose モードの有効化

# セッション中に Ctrl + O で切り替え
# または起動時に --verbose フラグを付ける
claude --verbose

Verbose モードを有効にすると、Claude の内部思考プロセス（thinking output）がターミナルに表示されます。これにより、以下のことが分かります。

• どのような前提条件を考慮したか
• どのような選択肢を検討し、なぜその結論に至ったか
• 見落としがないかの自己チェックプロセス

---

コスト最適化のコツ

ultrathink は強力ですが、思考トークンの消費が大きいため、コストを意識した使い方が重要です。

コスト削減の戦略

戦略	詳細
段階的エスカレーション	まず通常モードで試し、不十分なら think → ultrathink と段階的に上げる
スコープを絞る	「プロジェクト全体を分析」より「認証モジュールを分析」の方が効率的
思考上限の設定	MAX_THINKING_TOKENS で上限を設定し、過剰な思考を防ぐ
結果のキャッシュ	ultrathink の分析結果を CLAUDE.md に記録し、再分析を避ける

# 思考トークンを制限する例
export MAX_THINKING_TOKENS=10000
claude "think hard このバグを分析してください"

---

まとめ — ultrathink は「ここぞ」というときの切り札

ultrathink は Claude Code の最も深い思考モードで、複雑なアーキテクチャ設計やセキュリティレビュー、パフォーマンス最適化など、高度な分析が必要な場面で真価を発揮します。

ポイント	内容
使い方	プロンプトに ultrathink を含めるだけ
効果的な場面	アーキテクチャ設計、バグ分析、セキュリティレビュー
避けるべき場面	単純な修正、定型的なコード生成
コツ	Plan モードと組み合わせる、段階的にエスカレーション
コスト管理	MAX_THINKING_TOKENS で上限設定

すべてのタスクに ultrathink を使うのではなく、複雑さに応じて思考レベルを使い分けるのが、Claude Code を最も効率的に活用するコツです。他のAIコーディングツールとの使い分けが気になる方は「Claude Code vs Cursor 使い分けガイド」も参考にしてください。