Конфигурация 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"
  }
}

Локальные настройки (игнорируются Git): ./.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

Если пусто:

# Добавьте в конфигурацию оболочки
echo 'export ANTHROPIC_API_KEY="your-key"' >> ~/.bashrc
source ~/.bashrc

Проверьте 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"  // <Icon icon="check" /> Правильно
    // "ANTHROPIC_BASE_URL": "https://ai.megallm.io/"  // <Icon icon="xmark" /> Неправильно
  }
}

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

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

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 агенты

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

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

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

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

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

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

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

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

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

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

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

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

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

​Выбор модели

​Проверка

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

​Тест подключения к API

​Тест Claude Code

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

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

​Несколько профилей

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

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

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

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

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

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

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

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

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

Примеры

Другие агенты

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

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

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

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

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

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

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

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

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

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

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

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

Выбор модели

Проверка

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

Тест подключения к API

Тест Claude Code

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

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

Несколько профилей

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

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

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