Конфигурация Claude Code

Claude Code использует JSON файлы конфигурации для настроек и одобрения API ключей. Конфигурация может быть на системном уровне (глобальной) или на уровне проекта (локальной).

Файлы конфигурации

Конфигурация системного уровня

Файл настроек: ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "sk-mega-your-api-key-here"
  }
}

Одобрение API ключей: ~/.claude.json

{
  "customApiKeyResponses": {
    "approved": ["last-20-chars-of-key"],
    "rejected": []
  }
}

Файл одобрения API ключа хранит последние 20 символов вашего API ключа, чтобы запомнить ваше решение об одобрении, когда Claude Code запрашивает его.

Конфигурация уровня проекта

Файл настроек: ./.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "sk-mega-your-api-key-here"
  }
}

Локальные настройки (Gitignored): ./.claude/settings.local.json

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-mega-your-personal-key"
  }
}

Используйте settings.local.json, чтобы хранить ваш личный API ключ вне системы контроля версий, одновременно делясь базовой конфигурацией с вашей командой.

Переменные окружения

CLI устанавливает эти переменные окружения в конфигурации вашей оболочки:

export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-your-api-key-here"

Они добавляются в:

~/.bashrc (bash)
~/.zshrc (zsh)
~/.config/fish/config.fish (fish)
Профиль PowerShell (Windows)

Проверка переменных окружения

echo $ANTHROPIC_BASE_URL
# Вывод: https://ai.megallm.io

echo $ANTHROPIC_API_KEY
# Вывод: sk-mega-your-api-key-here

Приоритет конфигурации

Claude Code загружает конфигурацию в следующем порядке (от наивысшего к низшему приоритету):

Переменные окружения

ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY из вашей оболочки

Локальные настройки уровня проекта

./.claude/settings.local.json в текущем каталоге

Настройки уровня проекта

./.claude/settings.json в текущем каталоге

Настройки системного уровня

~/.claude/settings.json в домашнем каталоге

Конфигурация строки состояния (Опционально)

Claude Code поддерживает улучшенную строку состояния для лучшего интерфейса терминала:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "sk-mega-your-api-key-here"
  },
  "statusline": {
    "enabled": true,
    "components": {
      "directory": true,
      "gitBranch": true,
      "model": true,
      "contextUsage": true,
      "cost": true,
      "sessionTimer": true,
      "tokenAnalytics": true
    }
  }
}

CLI предложит вам настроить это во время конфигурации.

Ручная настройка

Если вы предпочитаете не использовать CLI:

Ручная настройка системного уровня

# 1. Создать каталог
mkdir -p ~/.claude

# 2. Создать файл настроек
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "your-api-key"
  }
}
EOF

# 3. Создать файл одобрения API ключа
cat > ~/.claude.json << 'EOF'
{
  "customApiKeyResponses": {
    "approved": ["last-20-chars-of-your-key"],
    "rejected": []
  }
}
EOF

# 4. Добавить переменные окружения в конфигурацию оболочки
echo 'export ANTHROPIC_BASE_URL="https://ai.megallm.io"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.bashrc

# 5. Перезагрузить оболочку
source ~/.bashrc

Ручная настройка уровня проекта

# 1. Перейти к вашему проекту
cd ~/projects/my-project

# 2. Создать каталог
mkdir -p .claude

# 3. Создать файл настроек (без API ключа для контроля версий)
cat > .claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io"
  }
}
EOF

# 4. Создать файл локальных настроек (с API ключом, не коммитится)
cat > .claude/settings.local.json << 'EOF'
{
  "env": {
    "ANTHROPIC_API_KEY": "your-api-key"
  }
}
EOF

# 5. Добавить в .gitignore
echo ".claude/settings.local.json" >> .gitignore
echo ".claude.json" >> .gitignore

# 6. Закоммитить общую конфигурацию
git add .claude/settings.json .gitignore
git commit -m "Add MegaLLM configuration for Claude Code"

Конфигурация для команды

Для командных проектов отделите общую конфигурацию от личных API ключей: Общая конфигурация (.claude/settings.json - коммитится в git):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io"
  },
  "model": "gpt-5",
  "temperature": 0.7,
  "maxTokens": 4096
}

Личная конфигурация (.claude/settings.local.json - не коммитится):

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-mega-personal-key-here"
  }
}

Инструкции по настройке для команды (.claude/README.md):

# Настройка MegaLLM Claude Code

## Предварительные требования
1. Получите ваш API ключ MegaLLM на https://megallm.io/dashboard
2. Установите Claude Code: `npm install -g @anthropic-ai/claude-code`

## Настройка
1. Создайте `.claude/settings.local.json`:
   ```json
   {
     "env": {
       "ANTHROPIC_API_KEY": "your-key-here"
     }
   }

Или установите переменную окружения:
export ANTHROPIC_API_KEY="your-key-here"

## Опции конфигурации

### Доступные настройки

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "sk-mega-...",
    "ANTHROPIC_MODEL": "gpt-5"
  },
  "model": "gpt-5",
  "temperature": 0.7,
  "maxTokens": 4096,
  "streaming": true,
  "contextWindow": 8192,
  "autoSave": true,
  "fileWatcher": true,
  "gitIntegration": true
}

Выбор модели

Измените модель по умолчанию:

{
  "env": {
    "ANTHROPIC_MODEL": "claude-opus-4-1-20250805"
  }
}

Или укажите в переменной окружения:

export ANTHROPIC_MODEL="gpt-5"

Смотрите Каталог моделей для доступных моделей.

Проверка

Проверка файлов конфигурации

# Просмотр настроек
cat ~/.claude/settings.json | jq .

# Просмотр одобрения API ключа
cat ~/.claude.json | jq .

# Проверка конфигурации проекта
cat .claude/settings.json | jq .
cat .claude/settings.local.json | jq .

Проверка API подключения

# Проверить API с вашими учетными данными
curl -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
     -H "Content-Type: application/json" \
     $ANTHROPIC_BASE_URL/v1/models

# Должен вернуть список доступных моделей

Проверка Claude Code

# Запустить Claude Code
claude-code

# Или протестировать с простым запросом
echo "What is 2+2?" | claude-code

Устранение неполадок

Конфигурация не загружается

Проверьте расположение файлов:

ls -la ~/.claude/
ls -la .claude/

Проверьте синтаксис JSON:

jq . ~/.claude/settings.json
# Должен показать форматированный JSON или ошибку, если невалидный

Проверьте разрешения:

ls -la ~/.claude/settings.json
# Должен быть читаемым: -rw-r--r--

API ключ не распознается

Проверьте переменную окружения:

echo $ANTHROPIC_API_KEY

Если пусто, перезагрузите оболочку:

source ~/.bashrc  # или ~/.zshrc

Проверьте API ключ в конфигурации:

jq .env.ANTHROPIC_API_KEY ~/.claude/settings.json

Проверьте формат API ключа:

Должен начинаться с sk-mega-
Не менее 20 символов
Без лишних пробелов или кавычек

Используется неправильный базовый URL

Проверьте переменную окружения:

echo $ANTHROPIC_BASE_URL
# Должно быть: https://ai.megallm.io

Проверьте в конфигурации:

jq .env.ANTHROPIC_BASE_URL ~/.claude/settings.json

Частая ошибка - завершающая косая черта:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io"  // ✅ Правильно
    // "ANTHROPIC_BASE_URL": "https://ai.megallm.io/"  // ❌ Неправильно
  }
}

Конфигурация проекта не переопределяет системную конфигурацию

Проверьте, что вы в правильном каталоге:

pwd
ls -la .claude/

Проверьте приоритет конфигурации:

# Конфигурация проекта должна переопределять системную
cat .claude/settings.json
cat ~/.claude/settings.json

Проверьте наличие settings.local.json:

cat .claude/settings.local.json
# Это имеет наивысший приоритет

Расширенная конфигурация

Множественные профили

Используйте разные конфигурации для разных случаев использования:

# Профиль разработки
cat > ~/.claude/settings.dev.json << 'EOF'
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-mega-dev-key"
  },
  "model": "gpt-4o-mini",
  "temperature": 0.9
}
EOF

# Производственный профиль
cat > ~/.claude/settings.prod.json << 'EOF'
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-mega-prod-key"
  },
  "model": "gpt-5",
  "temperature": 0.5
}
EOF

# Переключить профили
cp ~/.claude/settings.dev.json ~/.claude/settings.json

Конфигурация специфичная для окружения

# Установить разные конфигурации в зависимости от окружения
if [ "$NODE_ENV" = "production" ]; then
  export ANTHROPIC_API_KEY="$PROD_API_KEY"
else
  export ANTHROPIC_API_KEY="$DEV_API_KEY"
fi

Лучшие практики

Разделяйте API ключи

Используйте .gitignore для settings.local.json, чтобы хранить API ключи в секрете

Уровень проекта для команд

Используйте конфигурацию уровня проекта для командных проектов с общими настройками

Переменные окружения

Предпочитайте переменные окружения в CI/CD окружениях

Регулярные обновления

Поддерживайте Claude Code обновленным для последних функций и исправлений

Следующие шаги

Конфигурация Codex

Настроить Codex/Windsurf

Конфигурация OpenCode

Настроить OpenCode

Примеры

Просмотр практических примеров

Конфигурация всех агентов

Настройка всех CLI и GUI агентов

Устранение неполадок

Распространенные проблемы и решения

Начало работы