Claude Code ошибки деплоя: частые проблемы и руководство по исправлению за 10 минут

# Любое из этих сообщений означает проблему с API-ключом
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. Обновить через Homebrew на macOS
brew install node@22
brew link --overwrite node@22

# 3. Переустановить Claude Code после обновления Node
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'

# Добавить в PATH
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 (постоянная конфигурация на уровне проекта):
# allowed_tools: ["bash", "read", "write", "edit", "glob", "grep"]

# Для 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 (в МБ, в зависимости от RAM)
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 для освобождения памяти контекста