Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

Vertex AIでは、非対応のbetaヘッダーエラーを回避するため、ツール検索がデフォルトで無効になった（ENABLE_TOOL_SEARCH でオプトイン可能）

原文（英語） ​

Tool search is now disabled by default on Vertex AI to avoid an unsupported beta header error (opt in with ENABLE_TOOL_SEARCH)

概要 ​

Vertex AI経由でClaude Codeを使用する場合、ツール検索機能がデフォルトで無効になった。Vertex AIがサポートしていないbetaヘッダーが原因で発生していたエラーを防ぐための変更。ツール検索を使用したい場合は ENABLE_TOOL_SEARCH 環境変数を設定することで有効化できる。

基本的な使い方 ​

bash
# デフォルト（Vertex AI環境）: ツール検索は無効
# Vertex AI APIを使用しているとエラーなく動作する

# ツール検索を有効にする場合
ENABLE_TOOL_SEARCH=1 claude

実践例 ​

Vertex AI環境でのデフォルト動作（ツール検索無効） ​

bash
# Google Cloud / Vertex AI環境での通常使用
# 環境変数が設定されていればVertex AIが自動検出される
export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"
export CLOUD_ML_REGION="us-central1"

# ツール検索なしで動作（デフォルト）
claude "コードをレビューしてください"

ツール検索を有効にする ​

Vertex AIがツール検索のbetaヘッダーをサポートする環境では有効化できる：

bash
export ENABLE_TOOL_SEARCH=1
claude "MCPツールを検索して使用してください"

または ~/.claude/settings.json で設定：

json
{
  "env": {
    "ENABLE_TOOL_SEARCH": "1"
  }
}

CI/CDでのVertex AI使用 ​

yaml
# GitHub Actions での例
- name: Run Claude Code on Vertex AI
  env:
    ANTHROPIC_VERTEX_PROJECT_ID: ${{ secrets.GCP_PROJECT_ID }}
    CLOUD_ML_REGION: us-central1
    # ENABLE_TOOL_SEARCH は設定しない（デフォルト無効）
  run: claude --print "コードを分析してください"

注意点 ​

  • この変更はVertex AI経由でClaude Codeを使用している場合にのみ影響する
  • 通常のAnthropic API（api.anthropic.com）を使用している場合は影響なし
  • ENABLE_TOOL_SEARCH=1 を設定した場合、Vertex AIがbetaヘッダーをサポートしていないとエラーが発生する可能性がある
  • Vertex AIでのbetaヘッダーサポート状況はGoogleのドキュメントを確認すること
  • この変更はバグ修正であり、既存のVertex AI環境で予期せぬエラーが発生していた場合は解消される

関連情報 ​