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

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

Claude Code

JSON файлы в ~/.claude/ или ./.claude/

Codex/Windsurf

TOML файл в ~/.codex/

OpenCode

JSON файл в ~/.config/opencode/ или ./

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

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

Применяется ко всем проектам на вашей машине.
ИнструментРасположение
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

JSON конфигурация, переменные окружения и настройка строки состояния

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

TOML конфигурация и настройка провайдера модели

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

JSON конфигурация и настройки API

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

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

# Проверить 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, вы можете настроить вручную:
# Создать каталог
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 создает автоматические резервные копии, но храните свои собственные копии важных конфигураций

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

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

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

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

Детальная конфигурация Claude Code

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

Детальная конфигурация Codex/Windsurf

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

Детальная конфигурация OpenCode

Примеры

Практические примеры конфигурации