Claude API 認証エラー 401 Invalid API Key の原因と解決方法

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API Key"
  }
}

# 環境変数が設定されているか確認（先頭10文字だけ表示）
echo "${ANTHROPIC_API_KEY:0:10}..."
 
# 設定されていなければ空が返る

# macOS / Linux: シェル設定ファイルに追加
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx..."' >> ~/.zshrc
source ~/.zshrc
 
# Windows (PowerShell): ユーザー環境変数に設定
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-xxxxx...", "User")
# PowerShellを再起動して反映

# Python: .env ファイルの読み込み確認
import os
from dotenv import load_dotenv
 
load_dotenv()  # .env ファイルを読み込み
 
api_key = os.getenv("ANTHROPIC_API_KEY")
if not api_key:
    raise ValueError("ANTHROPIC_API_KEY が設定されていません")
 
print(f"API Key found: {api_key[:10]}...")
# 期待出力: API Key found: sk-ant-api...

# 新しいキーを設定
export ANTHROPIC_API_KEY="sk-ant-api03-新しいキー..."
 
# 動作確認（curlで簡易テスト）
curl -s https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 50,
    "messages": [{"role": "user", "content": "Hello"}]
  }' | head -c 200
 
# 期待出力: {"id":"msg_...","type":"message","role":"assistant",...}

import anthropic
 
# ❌ 間違い: Authorization ヘッダーに直接渡す
# requests.post(url, headers={"Authorization": f"Bearer {api_key}"})
 
# ✅ 正しい: Anthropic SDK を使う（内部で x-api-key ヘッダーを自動設定）
client = anthropic.Anthropic()  # ANTHROPIC_API_KEY 環境変数を自動読み込み
 
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "こんにちは"}
    ]
)
print(message.content[0].text)
# 期待出力: こんにちは！何かお手伝いできることはありますか？

# 必須ヘッダー
-H "x-api-key: YOUR_API_KEY"
-H "anthropic-version: 2023-06-01"
-H "Content-Type: application/json"

# Step 1: 認証情報を完全クリア
rm -rf ~/.claude/auth* 2>/dev/null
rm -rf ~/.claude/.credentials 2>/dev/null
 
# Step 2: 既存の環境変数を解除（API キーと OAuth が競合する場合がある）
unset ANTHROPIC_API_KEY
 
# Step 3: 再ログイン
claude /login
 
# Step 4: ブラウザで認証を完了し、ターミナルに戻って動作確認
claude "Hello, this is a test"

# Claude Code のアップデート
npm install -g @anthropic-ai/claude-code@latest
 
# バージョン確認
claude --version

# プロキシ設定を確認
echo "HTTP_PROXY: $HTTP_PROXY"
echo "HTTPS_PROXY: $HTTPS_PROXY"
echo "NO_PROXY: $NO_PROXY"
 
# 直接接続テスト（プロキシをバイパス）
curl -v --noproxy '*' 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-sonnet-4-6","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}' \
  2>&1 | grep -E "HTTP/|error|auth"

# api.anthropic.com をプロキシバイパスに追加
export NO_PROXY="api.anthropic.com,$NO_PROXY"

import anthropic
import sys
 
def verify_authentication():
    """Claude API 認証の動作検証"""
    try:
        client = anthropic.Anthropic()
        
        # 最小限のリクエストで認証テスト
        response = client.messages.create(
            model="claude-sonnet-4-6",
            max_tokens=20,
            messages=[{"role": "user", "content": "Say OK"}]
        )
        
        print(f"✅ 認証成功")
        print(f"   Model: {response.model}")
        print(f"   Response: {response.content[0].text}")
        print(f"   Usage: input={response.usage.input_tokens}, output={response.usage.output_tokens}")
        return True
        
    except anthropic.AuthenticationError as e:
        print(f"❌ 認証エラー: {e}")
        print("   → API キーを確認してください")
        return False
    except anthropic.APIConnectionError as e:
        print(f"❌ 接続エラー: {e}")
        print("   → ネットワーク設定を確認してください")
        return False
    except Exception as e:
        print(f"❌ 予期しないエラー: {e}")
        return False
 
if __name__ == "__main__":
    success = verify_authentication()
    sys.exit(0 if success else 1)
 
# 期待出力:
# ✅ 認証成功
#    Model: claude-sonnet-4-6
#    Response: OK
#    Usage: input=10, output=3

import anthropic
import time
 
def call_with_auth_retry(client, max_retries=2, **kwargs):
    """認証エラー時にキーを再検証してリトライ"""
    for attempt in range(max_retries + 1):
        try:
            return client.messages.create(**kwargs)
        except anthropic.AuthenticationError:
            if attempt < max_retries:
                print(f"認証エラー（試行 {attempt + 1}/{max_retries + 1}）")
                print("API キーを再読み込みします...")
                # 環境変数から再読み込み
                import os
                os.environ.pop("ANTHROPIC_API_KEY", None)
                from dotenv import load_dotenv
                load_dotenv(override=True)
                client = anthropic.Anthropic()
                time.sleep(1)
            else:
                raise