CC逆引きリファレンス

モデルの思考深度(努力レベル)を調整したい

3. モデル・思考

コマンド / 機能

/effort または --effort

low/medium/high で思考量を制御

概要

effort レベルはモデルが使うトークン量(思考の深さ)を制御します。low は高速・低コスト、high は深い分析が必要な複雑なタスクに最適です。セッション単位で設定でき、settings.json には保存されません。

設定例

# 対話モードでの設定
/effort low     # 高速・低コスト
/effort medium  # バランス型(デフォルト)
/effort high    # 深い思考
/effort auto    # デフォルトにリセット

# CLIフラグで設定
claude --effort high "このアーキテクチャを設計して"
claude --effort low "このファイルを要約して"

# エージェント frontmatter での設定
# .claude/agents/my-agent.md
---
effort: high
---
公式ドキュメントを見る

こんな時に使う

  • 複雑な設計や難しいバグ修正を依頼したい時(high)
  • 単純な質問やサマリーを素早く取得したい時(low)
  • コストを意識しながら軽いタスクをこなしたい時(low)

使い方

  1. 1/effort <レベル> でセッション中に設定
  2. 2起動時に --effort <レベル> フラグを使用
  3. 3設定は settings.json には保存されずセッション中のみ有効

Tips

  • Opus 4.6 のみ max レベル(最大思考)が使用可能
  • Max/Team サブスクライバーは Opus 4.6 のデフォルトが medium
  • エージェントや スキルの frontmatter でも effort を指定可能
  • スキルの frontmatter で effort を設定すると呼び出し時のみ有効