settings.json

ultracode

型boolean記述場所どの設定ファイルでも可

セッションを [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) で開始します。

既定値: unset, so ultracode is off

記述例

{
  "ultracode": true
}

使い方・用途

  • デフォルト値は未設定（ultracode はオフ）
  • true に設定すると、動的ワークフローが有効でモデルが xhigh をサポートしている場合、セッションは xhigh 努力レベルで開始されます
  • Claude Code はこのキーを読み取りませんが書き込みません：/effort ultracode は現在のセッションのみに適用されます
  • v2.1.203 以降で利用可能
英語原文(公式ドキュメントより)

Start sessions with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. With it on, Claude plans a workflow for each substantive task instead of waiting for you to ask. Claude plans workflows only when [dynamic workflows](/docs/en/workflows) are enabled for you and your model supports xhigh effort. Either way, ultracode: true runs the session at xhigh effort. Claude Code reads this key but never writes it: /effort ultracode turns ultracode on for the current session only.

関連ドキュメント

関連する変更履歴

v2.1.239(1件)

Fixed
カスタムテーマ設定において、effort や ultracode などのステータスバッジ色に対する配色オーバーライド指定が無視されてしまう不具合を修正しました。
英語原文を表示
Fixed custom theme overrides for the effort/ultracode status badge colors being ignored

変更前

ユーザーが作成したカスタムテーマファイル（~/.claude/themes/ 配下）で、高負荷推論（effort）や高度なコード生成（ultracode）のバッジカラーをカスタマイズするための特定のトークンを設定していても、適用されずにデフォルトの配色で描画されていました。

変更後

カスタムテーマのパース処理において、バッジ用の配色オーバーライド指定が正常に読み込まれ、ユーザーが定義した好みの色でステータスエリアが鮮やかに描画されるようになります。

ユーザーへの恩恵

ターミナルの背景色とステータスバッジの配色の相性が悪い場合に、見やすい好みの配色へと確実に変更することができます。

関連ドキュメント

v2.1.210(2件)

Fixed
Permissions
ウェブフックのペイロードや PR コメントなど、人間以外からの入力で ultracode キーワードが反応してしまう問題を修正した。
英語原文を表示
Fixed the ultracode keyword opt-in firing on non-human-originated input such as webhook payloads and relayed PR comments

変更前

GitHub アプリ経由などでリレーされたコメント内に ultracode という文字列が含まれていると、ユーザーが意図していなくても高コストなワークフローが自動的に開始されてしまうことがあった。

変更後

ultracode によるワークフローの自動オプトインは、ターミナルからの直接入力などの人間による明示的な操作に限定されるようになる。

ユーザーへの恩恵

自動化されたコメントなどによって意図せずトークンを大量消費してしまう事態を防げます。

関連ドキュメント

Fixed
claude agents --effort ultracode で指定した設定が、個別のセッションに反映されない問題を修正した。
英語原文を表示
Fixed claude agents --effort ultracode not reaching dispatched sessions; the value was silently dropped

変更前

エージェントダッシュボード起動時に ultracode を指定しても、そこから新しく開始される各エージェントにはその設定が引き継がれず、通常の思考レベルで動作してしまっていた。

変更後

ダッシュボードのフラグが、そこからディスパッチされるすべてのバックグラウンドセッションに正しく伝播するようになった。

ユーザーへの恩恵

複数のタスクを一度に高度な思考・自動ワークフロー設定で開始できるようになります。

関連ドキュメント

v2.1.160(2件)

Fixed
Settings
/effort ultracode使用時、モデルがxhighをサポートしていない場合に誤ってワークフロー設定のせいにする問題を修正
英語原文を表示
Fixed /effort ultracode incorrectly blaming the dynamic workflows setting when the model cannot run xhigh; ultracode is no longer offered on models that do not support it

変更前

モデルの能力不足でultracodeが実行できない時、設定が無効であるかのような不正確なエラーが表示されていました。

変更後

モデルのサポート状況を正しく判定し、非対応モデルではultracodeを選択肢から除外、または適切な理由を表示します。

ユーザーへの恩恵

モデルの性能制限とツールの設定不備を混同することがなくなり、トラブルシューティングが容易になります。

関連ドキュメント

Changed
動的ワークフローのトリガー単語を workflow から ultracode に変更。入力中に紫色のハイライトで通知
英語原文を表示
Renamed the dynamic-workflow trigger keyword from workflow to ultracode. The word "workflow" no longer triggers a run; asking for one in your own words still works. The trigger keyword is highlighted in violet in the prompt input

変更前

「workflow」という一般的な単語がトリガーになっていたため、単に文章内で使いたいだけでもワークフローが起動してしまうことがありました。

変更後

独自のキーワード「ultracode」に変更され、入力バーで色がつくため、ワークフローが起動することを事前に視覚的に把握できます。

ユーザーへの恩恵

意図しないワークフローの起動を防ぎつつ、高度な自動化機能を使いたい時だけ確実に発動させることができます。

関連ドキュメント