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

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

1. Безопасно сохраните ваш API-ключ

  • Linux/macOS
  • Windows
  • Файл .env
Добавьте в файл конфигурации вашей оболочки:
# ~/.bashrc или ~/.zshrc
export MEGALLM_API_KEY="your-api-key-here"
Затем перезагрузите:
source ~/.bashrc
# или
source ~/.zshrc
Или используйте файл .env:
echo "MEGALLM_API_KEY=your-api-key-here" >> .env

2. Установите SDK

  • Python
  • JavaScript/TypeScript
  • Go
  • Другие языки
# OpenAI SDK (рекомендуется)
pip install openai

# Или Anthropic SDK
pip install anthropic

# Для переменных окружения
pip install python-dotenv

3. Настройте свой клиент

  • Python - формат OpenAI
  • Python - формат Anthropic
  • JavaScript - формат OpenAI
  • JavaScript - формат Anthropic
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=os.getenv("MEGALLM_API_KEY")
)

# Проверьте соединение
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

Настройка проекта

Для новых проектов

  1. Создайте каталог проекта:
    mkdir my-ai-project
    cd my-ai-project
    
  2. Инициализируйте проект:
    # Python
    python -m venv venv
    source venv/bin/activate
    pip install openai python-dotenv
    
    # JavaScript
    npm init -y
    npm install openai dotenv
    
  3. Создайте файл .env:
    echo "MEGALLM_API_KEY=your-key-here" > .env
    echo ".env" >> .gitignore
    
  4. Создайте первый скрипт: См. Руководство по первому запросу

Для существующих проектов

Если вы уже используете OpenAI или Anthropic:
  1. Обновите базовый URL:
    # До
    client = OpenAI(api_key="sk-...")
    
    # После
    client = OpenAI(
        base_url="https://ai.megallm.io/v1",
        api_key="your-megallm-key"
    )
    
  2. Вот и всё! Весь ваш существующий код работает.

Настройка IDE

VS Code

Установите рекомендуемые расширения:
  • Python extension (для Python)
  • ESLint (для JavaScript)
  • REST Client (для тестирования API)

PyCharm / IntelliJ

Настройте переменные окружения в Run Configurations.

AI-ассистенты для кодирования

MegaLLM предоставляет CLI для настройки инструментов AI-кодирования:
npx megallm@latest
Это настраивает:
  • Claude Code
  • Codex/Windsurf
  • OpenCode
См. Документация CLI для подробностей.

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

Проверьте вашу конфигурацию:
  • Python
  • JavaScript
  • cURL
import os
from openai import OpenAI

# Проверьте API-ключ
api_key = os.getenv("MEGALLM_API_KEY")
if not api_key:
    print("❌ API-ключ не установлен!")
    exit(1)
print("✅ API-ключ найден")

# Проверьте соединение
client = OpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=api_key
)

try:
    response = client.chat.completions.create(
        model="gpt-4",
        messages=[{"role": "user", "content": "Say 'Setup successful!'"}],
        max_tokens=10
    )
    print("✅ Соединение успешно!")
    print(f"Ответ: {response.choices[0].message.content}")
except Exception as e:
    print(f"❌ Ошибка: {e}")

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

Проблема: Переменная окружения не установленаРешение:
  • Проверьте имя переменной: MEGALLM_API_KEY
  • Перезагрузите оболочку: source ~/.bashrc
  • Проверьте: echo $MEGALLM_API_KEY
Проблема: Недействительный API-ключРешение:
  • Убедитесь, что ключ начинается с sk-mega-
  • Проверьте на наличие лишних пробелов
  • Сгенерируйте новый ключ на панели управления
Проблема: Проблемы с сетью или брандмауэромРешение:
  • Проверьте интернет-соединение
  • Проверьте настройки брандмауэра
  • Попробуйте без VPN
Проблема: SDK не установленРешение:
pip install openai  # Python
npm install openai  # JavaScript

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