Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

ツール利用不可エラーを改善しました：モデルが現在のコンテキストでは利用できないツールを呼び出した場合に、その理由と次の手順を説明するようになりました。

原文（英語） ​

Improved tool-not-available errors to explain why and how to proceed when the model calls a tool that exists but isn't available in the current context

概要 ​

Claude Codeでは、ツールが存在していても特定のコンテキストでは利用できない場合があります。このアップデートにより、そのような状況でのエラーメッセージが改善され、なぜそのツールが利用できないのか、そしてどのように対処すればよいかが明確に説明されるようになりました。これにより、デバッグ時間の短縮と開発体験の向上が期待できます。

基本的な使い方 ​

bash
# 以前のエラーメッセージ（改善前）
# Error: Tool 'bash' is not available

# 改善後のエラーメッセージ例
# Error: Tool 'bash' is not available in the current context.
# Reason: Bash execution is disabled in sandbox mode.
# How to proceed: Use '--no-sandbox' flag or configure allowed commands in settings.

実践例 ​

サンドボックス環境でのツールエラー対処 ​

bash
# サンドボックスモードでBashツールを使おうとした場合
claude --sandbox "npm install express"

# 改善されたエラーメッセージが表示される:
# Tool 'Bash' is not available: Bash execution is restricted in sandbox mode.
# To allow specific commands, add them to .claude/settings.json:
# {
#   "allowedTools": ["Bash(npm install*)"]
# }

# 解決策: 設定ファイルで許可するコマンドを指定
cat .claude/settings.json

MCPツールが利用できない場合の対処 ​

bash
# MCPサーバーが起動していない状態でMCPツールを使用しようとした場合
# 改善されたエラーメッセージ:
# Tool 'mcp__myserver__search' is not available.
# Reason: MCP server 'myserver' is not connected.
# How to proceed: Check your MCP server configuration in settings.json
#                 and ensure the server is running.

# MCPサーバーの設定確認
cat ~/.claude/settings.json | jq '.mcpServers'

# MCPサーバーの再起動
claude mcp restart myserver

権限制限によるツールエラー ​

bash
# 組織の設定でツールが制限されている場合
# 改善されたエラーメッセージ:
# Tool 'WebSearch' is not available in your current organization plan.
# Reason: Web search requires the Pro plan or higher.
# How to proceed: Upgrade your plan or contact your organization admin.

# 利用可能なツールの確認
claude --list-tools

設定ファイルでのツール管理 ​

json
// .claude/settings.json
{
  "allowedTools": [
    "Read",
    "Write",
    "Edit",
    "Bash(git *)",
    "Bash(npm *)",
    "Bash(python *)"
  ],
  "disabledTools": [
    "WebSearch"
  ]
}
bash
# 設定を適用して実行
claude "テストを実行して"
# 許可されていないツールの場合、理由と対処法が明示される

注意点 ​

  • エラーメッセージには「理由」と「次の手順」が含まれるようになりました
  • ツールが存在するかどうかと、利用可能かどうかは別の概念です
  • 組織の設定、プランの制限、サンドボックスモードなどがツールの可用性に影響します
  • エラーメッセージを参考に設定を調整することで、多くの問題を自己解決できます
  • --list-tools フラグで現在のコンテキストで利用可能なツール一覧を確認できます

関連情報 ​