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

OpenCode использует формат конфигурации JSON и поддерживает как системный (глобальный), так и проектный (локальный) уровни конфигурации.

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

Системная конфигурация

Расположение: ~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  },
  "autoupdate": true,
  "tools": {
    "bash": true,
    "edit": true,
    "write": true,
    "read": true
  }
}

CLI автоматически получает доступные модели из MegaLLM и добавляет их в раздел provider.anthropic.models.

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

Расположение: ./opencode.json (в корне проекта)

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  },
  "tools": {
    "bash": true,
    "edit": true,
    "write": true,
    "read": true
  }
}

Используйте конфигурацию на уровне проекта для настройки параметров для каждого проекта, сохраняя глобальные значения по умолчанию. Синтаксис {env:MEGALLM_API_KEY} ссылается на переменную окружения.

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

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

# 1. Создайте каталог
mkdir -p ~/.config/opencode

# 2. Создайте файл конфигурации
cat > ~/.config/opencode/opencode.json << 'EOF'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  },
  "autoupdate": true,
  "tools": {
    "bash": true,
    "edit": true,
    "write": true,
    "read": true
  }
}
EOF

# 3. Установите переменную окружения
echo 'export MEGALLM_API_KEY="ваш-api-ключ"' >> ~/.bashrc
source ~/.bashrc

# 4. Проверьте
cat ~/.config/opencode/opencode.json | jq .

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

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

# 2. Создайте файл конфигурации
cat > opencode.json << 'EOF'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  },
  "tools": {
    "bash": true,
    "edit": true,
    "write": true,
    "read": true
  }
}
EOF

# 3. Установите переменную окружения (если еще не установлена)
echo 'export MEGALLM_API_KEY="ваш-api-ключ"' >> ~/.bashrc
source ~/.bashrc

# 4. Добавьте в .gitignore
echo "opencode.json" >> .gitignore

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

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

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

Переменная окружения MEGALLM_API_KEY (ссылка через {env:MEGALLM_API_KEY} в конфигурации)

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

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

Системная конфигурация

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

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

Настройки провайдера

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "models": {
        "gpt-5": {
          "id": "gpt-5",
          "name": "GPT-5 (Via MegaLLM)"
        },
        "claude-sonnet-4": {
          "id": "claude-sonnet-4",
          "name": "Claude Sonnet 4 (Via MegaLLM)"
        }
      },
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  }
}

CLI автоматически получает и заполняет объект models из MegaLLM API. Вы также можете вручную добавлять или переопределять конкретные модели.

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

{
  "tools": {
    "bash": true,
    "edit": true,
    "write": true,
    "read": true
  },
  "autoupdate": true
}

Доступные модели:

gpt-5 - Последняя модель GPT
gpt-4 - GPT-4
claude-opus-4-1-20250805 - Claude Opus
claude-sonnet-4 - Claude Sonnet
gemini-2.5-pro - Gemini Pro
См. Каталог моделей для полного списка

Полный пример

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "models": {
        "gpt-5": {
          "id": "gpt-5",
          "name": "GPT-5 (Via MegaLLM)"
        },
        "gpt-4": {
          "id": "gpt-4",
          "name": "GPT-4 (Via MegaLLM)"
        },
        "claude-sonnet-4": {
          "id": "claude-sonnet-4",
          "name": "Claude Sonnet 4 (Via MegaLLM)"
        }
      },
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  },
  "autoupdate": true,
  "tools": {
    "bash": true,
    "edit": true,
    "write": true,
    "read": true
  }
}

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  },
  "autoupdate": true,
  "tools": {
    "bash": true,
    "edit": true,
    "write": true,
    "read": true
  }
}

Добавьте в .gitignore:

opencode.json

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

# Настройка OpenCode

## Требования
1. Получите API-ключ MegaLLM на https://megallm.io/dashboard
2. Установите OpenCode: `npm install -g opencode-ai`

## Настройка
Установите переменную окружения MEGALLM_API_KEY:
```bash
export MEGALLM_API_KEY="ваш-api-ключ-здесь"

Добавьте в конфигурацию вашей оболочки (~/.bashrc или ~/.zshrc), чтобы сделать постоянной.

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

MegaLLM CLI устанавливает переменную окружения `MEGALLM_API_KEY` для OpenCode:

```bash
# Устанавливается автоматически CLI
export MEGALLM_API_KEY="sk-mega-your-api-key-here"

На эту переменную окружения ссылаются в конфигурации OpenCode с помощью {env:MEGALLM_API_KEY}. Добавьте в конфигурацию вашей оболочки:

# ~/.bashrc или ~/.zshrc
export MEGALLM_API_KEY="sk-mega-ваш-api-ключ-здесь"

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

echo $MEGALLM_API_KEY
# Вывод: sk-mega-ваш-api-ключ-здесь

Проверка

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

# Системная конфигурация
cat ~/.config/opencode/opencode.json | jq .

# Проектная конфигурация
cat opencode.json | jq .
cat opencode.local.json | jq .

# Проверьте права доступа к файлам
ls -la ~/.config/opencode/opencode.json
ls -la opencode.json

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

# Проверка JSON
jq . ~/.config/opencode/opencode.json

# Должен показать отформатированный JSON или ошибку, если недействителен

Тестирование соединения с API

# Тестирование с MEGALLM_API_KEY
curl -H "Authorization: Bearer $MEGALLM_API_KEY" \
     -H "Content-Type: application/json" \
     https://ai.megallm.io/v1/models

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

Тестирование OpenCode

# Запуск OpenCode
opencode

# Проверка версии
opencode --version

# Тестирование с файлом
echo "console.log('test')" > test.js
opencode test.js

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

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

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

# Системная конфигурация
ls -la ~/.config/opencode/opencode.json

# Проектная конфигурация
ls -la opencode.json

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

jq . ~/.config/opencode/opencode.json
# Должен показать отформатированный JSON

Убедитесь, что вы находитесь в правильном каталоге:

pwd
# Должен быть каталог вашего проекта для конфигурации на уровне проекта

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

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

echo $MEGALLM_API_KEY

Если пусто, установите её:

export MEGALLM_API_KEY="ваш-api-ключ"
echo 'export MEGALLM_API_KEY="ваш-api-ключ"' >> ~/.bashrc
source ~/.bashrc

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

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

Протестируйте ключ:

curl -H "Authorization: Bearer $MEGALLM_API_KEY" \
     -H "Content-Type: application/json" \
     https://ai.megallm.io/v1/models

Неправильный базовый URL

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

jq '.provider.anthropic.options.baseURL' ~/.config/opencode/opencode.json
# Должен показать: "https://ai.megallm.io/v1"

Распространенные ошибки:

{
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://ai.megallm.io/v1"  // <Icon icon="check" /> Правильно
        // "baseURL": "https://ai.megallm.io/v1/"  // <Icon icon="xmark" /> Неправильно (завершающий слэш)
        // "baseURL": "https://ai.megallm.io"  // <Icon icon="xmark" /> Неправильно (отсутствует /v1)
      }
    }
  }
}

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

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

ls -la opencode.json

Убедитесь в правильной структуре JSON: Проектная конфигурация должна использовать ту же структуру, что и системная, с provider.anthropic.options.

Ошибки синтаксиса JSON

Распространенные ошибки JSON:

// <Icon icon="xmark" /> Неправильно - завершающая запятая
{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}",
      }
    }
  }
}

// <Icon icon="check" /> Правильно
{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}"
      }
    }
  }
}

// <Icon icon="xmark" /> Неправильно - одинарные кавычки
{
  'provider': {
    'anthropic': {
      'options': {
        'apiKey': '{env:MEGALLM_API_KEY}'
      }
    }
  }
}

// <Icon icon="check" /> Правильно - двойные кавычки
{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY}"
      }
    }
  }
}

Валидация:

jq . ~/.config/opencode/opencode.json
# Покажет ошибку, если невалидный

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

Используйте локальную конфигурацию для API-ключей

Храните API-ключи в opencode.local.json и добавьте в .gitignore

Делитесь базовой конфигурацией

Коммитьте opencode.json без API-ключей для согласованности команды

Настройки для конкретного проекта

Используйте проектную конфигурацию для контекста и настроек конкретного проекта

Валидируйте JSON

Всегда валидируйте синтаксис JSON после ручного редактирования

Продвинутое использование

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

# Создайте разные профили
cat > ~/.config/opencode/opencode.dev.json << 'EOF'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY_DEV}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  }
}
EOF

cat > ~/.config/opencode/opencode.prod.json << 'EOF'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:MEGALLM_API_KEY_PROD}",
        "baseURL": "https://ai.megallm.io/v1"
      }
    }
  }
}
EOF

# Установите переменные окружения
export MEGALLM_API_KEY_DEV="sk-mega-dev-key"
export MEGALLM_API_KEY_PROD="sk-mega-prod-key"

# Переключайте профили
alias opencode-dev='cp ~/.config/opencode/opencode.dev.json ~/.config/opencode/opencode.json && opencode'
alias opencode-prod='cp ~/.config/opencode/opencode.prod.json ~/.config/opencode/opencode.json && opencode'

Конфигурация CI/CD

# Пример GitHub Actions
- name: Настройка OpenCode
  env:
    MEGALLM_API_KEY: ${{ secrets.MEGALLM_API_KEY }}
  run: |
    mkdir -p ~/.config/opencode
    cat > ~/.config/opencode/opencode.json << 'EOF'
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "anthropic": {
          "options": {
            "apiKey": "{env:MEGALLM_API_KEY}",
            "baseURL": "https://ai.megallm.io/v1"
          }
        }
      }
    }
    EOF

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

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

Настройте Claude Code

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

Настройте Codex/Windsurf

Примеры

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

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

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

Каталог моделей

Просмотрите доступные модели

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

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

Руководства

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

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

Системная конфигурация

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

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

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

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

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

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

Настройки провайдера

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

Полный пример

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

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

Проверка

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

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

Тестирование соединения с API

Тестирование OpenCode

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

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

Используйте локальную конфигурацию для API-ключей

Делитесь базовой конфигурацией

Настройки для конкретного проекта

Валидируйте JSON

Продвинутое использование

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

Конфигурация CI/CD

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

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

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

Примеры

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

Каталог моделей

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

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

Руководства

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

​Системная конфигурация

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

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

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

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

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

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

​Настройки провайдера

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

​Полный пример

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

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

​Проверка

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

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

​Тестирование соединения с API

​Тестирование OpenCode

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

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

Используйте локальную конфигурацию для API-ключей

Делитесь базовой конфигурацией

Настройки для конкретного проекта

Валидируйте JSON

​Продвинутое использование

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

​Конфигурация CI/CD

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

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

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

Примеры

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

Каталог моделей

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

Системная конфигурация

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

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

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

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

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

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

Настройки провайдера

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

Полный пример

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

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

Проверка

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

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

Тестирование соединения с API

Тестирование OpenCode

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

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

Продвинутое использование

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

Конфигурация CI/CD

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