Перейти к основному содержанию
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 загружает конфигурацию в следующем порядке (от наивысшего к низшему приоритету):
1

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

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

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

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

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

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

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

~/.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"
     }
   }
  1. Или установите переменную окружения: 
    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--
Проверьте переменную окружения:
echo $ANTHROPIC_API_KEY
Если пусто, перезагрузите оболочку:
source ~/.bashrc  # или ~/.zshrc
Проверьте API ключ в конфигурации:
jq .env.ANTHROPIC_API_KEY ~/.claude/settings.json
Проверьте формат API ключа:
  • Должен начинаться с sk-mega-
  • Не менее 20 символов
  • Без лишних пробелов или кавычек
Проверьте переменную окружения:
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 агентов

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

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