Claude Code デプロイエラー：よくある問題と10分修復ガイド

Error: ANTHROPIC_API_KEY is not set
AuthenticationError: 401 {"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}
Error: Your API key is invalid.

# 1. 現在のシェルにキーが設定されているか確認
echo $ANTHROPIC_API_KEY
# 2. 一時的に設定（現在のセッションのみ有効）
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxx"
# 3. 設定ファイルに書き込み永続化（zsh: ~/.zshrc、bash: ~/.bashrc）
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc
# 4. 形式を確認：sk-ant-api で始まる必要がある
claude --version

SyntaxError: Unexpected token '?'
engine "node" is incompatible with this module. Expected version ">=18". Got "16.x.x"
Error [ERR_REQUIRE_ESM]: require() of ES Module ... not supported.

# 1. 現在のNodeバージョンを確認
node -v
# 2a. nvmでバージョンを切り替え（推奨）
nvm install 22
nvm use 22
nvm alias default 22
# 2b. macOSでHomebrewを使う場合
brew install node@22
brew link --overwrite node@22
# 3. Node升级后に Claude Code を再インストール
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

npm ERR! Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules'
Error: Permission denied (tool: bash)
EPERM: operation not permitted, unlink

# グローバルパッケージディレクトリをホームに変更（sudoが不要になる）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

# ツールを明示的に許可して起動
claude --allowedTools "bash,read,write,edit"
# CLAUDE.mdで設定（プロジェクト単位で永続化）
# CIサーバーでは --dangerously-skip-permissions で対話確認をスキップ
# ※信頼できる環境のみで使用
claude --dangerously-skip-permissions -p "your prompt here"

FetchError: request to https://api.anthropic.com/v1/messages failed, reason: connect ETIMEDOUT
Error: Network request failed: ENOTFOUND api.anthropic.com
ProxyError: tunneling socket could not be established, cause=connect ECONNREFUSED

# 1. 接続確認
curl -v 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-opus-4-5","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'
# 2. HTTPプロキシの設定
export HTTPS_PROXY="http://proxy.company.com:8080"
export HTTP_PROXY="http://proxy.company.com:8080"
export NO_PROXY="localhost,127.0.0.1"
# 3. 認証付きプロキシ
export HTTPS_PROXY="http://username:password@proxy.company.com:8080"
# 4. カスタムベースURL（企業内ゲートウェイ）
export ANTHROPIC_BASE_URL="https://your-internal-gateway.company.com"

FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory
Killed (signal 9)   ← Linux OOM Killerによる強制終了
RangeError: Maximum call stack size exceeded

# 1. Node.jsヒープメモリの上限を拡大（MB単位）
export NODE_OPTIONS="--max-old-space-size=4096"
claude
# 2. 現在のメモリ使用量を確認
free -h          # Linux
vm_stat          # macOS
# 3. 大規模コードベース用に .claudeignore を作成
# node_modules/
# dist/
# .next/
# *.lock
# 4. 長い会話では /clear でコンテキストをリセット