Перейти к основному содержанию

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

Уровни конфигурации

Системный уровень (Глобальный)

Применяется ко всем проектам на вашей машине.
ИнструментРасположение
Claude Code~/.claude/settings.json
~/.claude.json
Codex/Windsurf~/.codex/config.toml
OpenCode~/.config/opencode/opencode.json

Уровень проекта (Локальный)

Применяется только к текущему каталогу проекта.
ИнструментРасположение
Claude Code./.claude/settings.json
./.claude/settings.local.json
Codex/Windsurf Не поддерживается
OpenCode./opencode.json
Codex/Windsurf поддерживает только конфигурацию системного уровня

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

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

Claude Code

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

Codex/Windsurf

export MEGALLM_API_KEY="sk-mega-your-api-key-here"

OpenCode

export MEGALLM_API_KEY="sk-mega-your-api-key-here"
Примечание: Codex/Windsurf и OpenCode используют одну и ту же переменную окружения MEGALLM_API_KEY.

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

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

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

# Codex/Windsurf & OpenCode
echo $MEGALLM_API_KEY
# Вывод: sk-mega-your-api-key-here

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

Когда существует несколько конфигураций, они применяются в следующем порядке (от высшего к низшему):
1

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

Наивысший приоритет - переопределяет все конфигурации на основе файлов
2

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

Второй приоритет - применяется только к текущему проекту
3

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

По умолчанию - применяется глобально ко всем проектам

Резервные файлы

CLI автоматически создает резервные копии файлов перед изменением конфигураций:
~/.claude/settings.json.backup
~/.codex/config.toml.backup
~/.config/opencode/opencode.json.backup
Для восстановления из резервной копии:
mv ~/.claude/settings.json.backup ~/.claude/settings.json

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

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

Быстрые проверки конфигурации

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

# Проверить Claude Code
ls -la ~/.claude/
cat ~/.claude/settings.json

# Проверить Codex
ls -la ~/.codex/
cat ~/.codex/config.toml

# Проверить OpenCode
ls -la ~/.config/opencode/
cat ~/.config/opencode/opencode.json

# Проверить переменные окружения
env | grep -E "ANTHROPIC|MEGALLM"

Проверить API подключение

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

# Проверить с учетными данными Codex/OpenCode
curl -H "Authorization: Bearer $MEGALLM_API_KEY" \
     -H "Content-Type: application/json" \
     https://ai.megallm.io/v1/models

Ручная конфигурация

Если вы предпочитаете не использовать CLI, вы можете настроить вручную:
  • Claude Code
  • Codex/Windsurf
  • OpenCode
# Создать каталог
mkdir -p ~/.claude

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

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

Лучшие практики конфигурации

Используйте уровень проекта для команд

Храните конфигурации конкретных проектов в системе контроля версий (без API ключей)

Защищайте API ключи

Никогда не коммитьте API ключи. Используйте .gitignore и переменные окружения

Регулярные резервные копии

CLI создает автоматические резервные копии, но храните свои собственные копии важных конфигураций

Тестируйте после изменений

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

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