Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

disable-model-invocation: true を設定したスキルをメッセージ途中で /<skill> として呼び出すと失敗する問題を修正しました。

原文（英語） ​

Fixed skills with disable-model-invocation: true failing when invoked via /<skill> mid-message.

概要 ​

Claude Code v2.1.110では、disable-model-invocation: trueが設定されたスキル（AIモデルを呼び出さずに実行されるスキル）を会話の途中でスラッシュコマンドとして呼び出した場合に失敗する問題が修正されました。disable-model-invocationはスキルがモデルへのAPIコールなしで直接実行されるよう指定するオプションで、主に設定変更や情報表示などの軽量なスキルで使用されます。

基本的な使い方 ​

yaml
# スキルの定義例（SKILL.md または skills/ ディレクトリ内）
---
name: quick-status
disable-model-invocation: true
description: 現在のプロジェクト状態を素早く表示
---

このスキルはモデルを呼び出さずに直接実行されます。
bash
# 会話の途中でスキルを呼び出す
/quick-status

# 修正前: 会話の途中での呼び出しで失敗することがあった
# 修正後: 正常に実行される

実践例 ​

ユースケース1: 設定表示スキル ​

yaml
# .claude/skills/show-config.md
---
name: show-config
disable-model-invocation: true
description: 現在の設定を表示する（モデル呼び出しなし）
---

現在のClaude Code設定を表示します:
- モデル: ${CLAUDE_MODEL}
- 作業ディレクトリ: ${CWD}
- セッションID: ${SESSION_ID}
// 会話途中での使用
ユーザー: コードをレビューして... あ、その前に /show-config
Claude: [設定を表示]
モデル: claude-sonnet-4-6
作業ディレクトリ: /Users/user/project
セッションID: abc123

// 修正前: 「スキルの実行に失敗しました」エラーが表示されることがあった
// 修正後: 正常に設定が表示される

ユースケース2: 素早い情報表示スキル ​

yaml
# .claude/skills/git-status-quick.md
---
name: git-status-quick
disable-model-invocation: true
description: Gitの状態を素早く確認（AIなし）
---

!git status --short
bash
# 長い会話の途中で使用
/git-status-quick

# 即座にgit statusの結果が表示される（AIへのAPIコールなし）
M  src/main.py
?? new-feature.py

ユースケース3: 複数スキルの連続呼び出し ​

// 会話の途中で複数のdisable-model-invocationスキルを使用
ユーザー: プロジェクトを分析して...
/show-config
/git-status-quick
/show-todos
... 続きをお願い

// v2.1.110以降: すべてのスキルが正常に実行される

ユースケース4: スキル定義のベストプラクティス ​

yaml
# disable-model-invocation を使うべき場合の例
---
name: toggle-debug
disable-model-invocation: true
description: デバッグモードのオン/オフ切り替え
---

<bash>
if [ "${CLAUDE_DEBUG}" = "true" ]; then
  export CLAUDE_DEBUG=false
  echo "デバッグモードを無効にしました"
else
  export CLAUDE_DEBUG=true
  echo "デバッグモードを有効にしました"
fi
</bash>

注意点 ​

  • disable-model-invocationの用途 — このオプションはAIモデルへのAPIコールが不要な軽量スキル（設定表示、環境情報取得、簡単なbashコマンド実行など）に使用します。
  • 会話コンテキスト — disable-model-invocation: trueのスキルは会話コンテキストにアクセスできない場合があります。
  • パフォーマンス — モデル呼び出しがないため、通常のスキルより大幅に高速に実行されます。
  • 修正の適用 — v2.1.110以降は会話のどの時点でも安定して実行できます。
  • エラーハンドリング — スキル内でエラーが発生した場合は適切なエラーメッセージが表示されます。

関連情報 ​