Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

x-api-key ヘッダーが欠落していたMantleエンドポイント認証の失敗を修正しました。

原文（英語） ​

Fixed Mantle endpoint authentication failing with missing x-api-key header

概要 ​

Mantleエンドポイント（Claude Codeの内部サービスインフラ）への認証リクエストで、必要な x-api-key ヘッダーが送信されていないことが原因で認証に失敗する問題がありました。これにより一部のユーザーで特定の機能が利用できない状態が発生していました。この修正により x-api-key ヘッダーが正しく送信され、Mantleエンドポイントへの認証が正常に機能するようになります。

基本的な使い方 ​

この修正はバックエンドの認証処理の修正であるため、ユーザーが特別な操作をする必要はありません。Claude Codeを最新バージョンに更新するだけで修正が適用されます。

bash
# Claude Codeを最新バージョンに更新
npm update -g @anthropic-ai/claude-code

# バージョンを確認
claude --version
# v2.1.131 以降であることを確認

実践例 ​

APIキーの設定と確認 ​

bash
# Anthropic APIキーの設定
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# または ~/.claude/settings.json に設定
{
  "apiKey": "sk-ant-api03-..."
}

# Claude Codeを起動して認証状態を確認
claude
/status

# 修正後: Mantleエンドポイントへの認証が正常に行われる
# 認証エラーが発生していた機能が復元される

認証エラーのトラブルシューティング ​

bash
# 認証エラーが発生している場合の確認手順

# 1. APIキーが正しく設定されているか確認
echo $ANTHROPIC_API_KEY  # 環境変数が設定されているか

# 2. APIキーの有効性を確認（curlで直接テスト）
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "max_tokens": 10,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

# 3. Claude Codeの設定を確認
cat ~/.claude/settings.json

# 4. 認証情報をリセット
/login  # 再認証を実行

企業環境でのMantleエンドポイント設定 ​

bash
# 企業プロキシ環境での設定

# HTTPプロキシの設定
export HTTPS_PROXY="https://proxy.company.com:8080"
export HTTP_PROXY="http://proxy.company.com:8080"

# SSL証明書の設定（自己署名証明書の場合）
export NODE_EXTRA_CA_CERTS="/path/to/company-ca-cert.pem"

# Claude Codeを起動
claude

# 修正後: x-api-keyヘッダーが正しく送信されるため
# プロキシ経由でも認証が正常に機能する

/loginコマンドでの再認証 ​

# 認証に問題がある場合は /login で再認証

/login

# 認証方法を選択:
# 1. Anthropic Console (APIキー)
#    → APIキーを直接入力
# 2. claude.ai アカウント
#    → ブラウザで認証

# 修正後: 認証情報がMantleエンドポイントに正しく送信される

注意点 ​

  • Mantleエンドポイントはclaude.aiプラットフォームの内部サービスインフラです。このエンドポイントへの認証はClaude Codeが自動的に処理します。
  • この問題は主にclaude.aiアカウント経由で認証しているユーザーに影響していました。Anthropic APIキーを直接使用しているユーザーへの影響は限定的でした。
  • 認証エラーが続く場合は、/login コマンドで再認証を試みてください。
  • 企業のファイアウォールやプロキシでAPIリクエストがブロックされている場合は、ネットワーク管理者に Anthropic のエンドポイントへのアクセスを許可するよう依頼してください。

関連情報 ​