Настройка AI-моделей, провайдеров и API-ключей
Полный справочник по ~/.andromity/config.toml, переменным окружения, моделям и настройкам конфиденциальности.
Andromity хранит пользовательские настройки, активные профили и учётные данные провайдеров в локальном файле конфигурации ~/.andromity/config.toml (или %APPDATA%\andromity\config.toml в Windows).
Этот файл автоматически инициализируется при первом запуске.
Пример config.toml
[default]
provider = "anthropic"
model = "claude-3-7-sonnet"
profile = "builder"
permission_mode = "safe"
telemetry = true # Задайте false, чтобы отключить анонимные метрики
[[providers]]
name = "anthropic"
type = "anthropic"
api_key = "sk-ant-api03-..."
[[providers]]
name = "openai"
type = "openai"
api_key = "sk-proj-..."
[[providers]]
name = "gemini"
type = "google"
api_key = "AIzaSy..."
[[providers]]
name = "groq"
type = "groq"
api_key = "gsk_..."
[[providers]]
name = "openrouter"
type = "openrouter"
api_key = "sk-or-v1-..."
[[providers]]
name = "ollama"
type = "ollama"
base_url = "http://localhost:11434"Поддерживаемые переменные окружения
Помимо config.toml, Andromity автоматически распознаёт стандартные переменные окружения провайдеров:
| Переменная | Провайдер | Пример |
|---|---|---|
ANTHROPIC_API_KEY | Anthropic | sk-ant-api03-... |
OPENAI_API_KEY | OpenAI | sk-proj-... |
GEMINI_API_KEY | Google Gemini | AIzaSy... |
GROQ_API_KEY | Groq | gsk_... |
OPENROUTER_API_KEY | OpenRouter | sk-or-v1-... |
CEREBRAS_API_KEY | Cerebras | csk-... |
MISTRAL_API_KEY | Mistral AI | ... |
OLLAMA_HOST | Ollama (локально) | http://localhost:11434 |
DO_NOT_TRACK | Флаг конфиденциальности | 1 (отключает всю телеметрию) |
Управление ключами через команды чата
Вы можете просматривать и обновлять ключи, не редактируя файлы .toml вручную:
/keys
/keys set anthropic sk-ant-...
/keys set openai sk-proj-...
/keys set gemini AIzaSy...Выбор модели и переключение на лету
Andromity работает на базе LiteLLM и поддерживает 396+ моделей облачных и локальных провайдеров. Активную модель можно сменить на лету в любой момент диалога:
Откройте выбор модели командой /model в терминале или с помощью элемента выбора модели в VS Code. Выберите провайдера и точный идентификатор его модели. Команда в терминале открывает окно выбора; она не переключает модель по аргументу, указанному после команды.
Сочетание клавиш: нажмите Ctrl + L (или Cmd + L в macOS), чтобы сразу открыть переключатель моделей.
Конфиденциальность данных и телеметрия
Andromity работает по принципам zero-PII (без персональных данных):
- Маршрутизация через провайдеров: запросы идут по маршруту выбранного провайдера. Провайдеры, подключённые напрямую по модели BYOK, получают промпт и контекст кода, необходимые для инференса; маршрут через шлюз Andromity пересылает запросы через edge-прокси без сохранения состояния. Шлюз не сохраняет промпты, ответы модели и исходный код. Локальный эндпоинт Ollama выполняет инференс на той машине, где он запущен. Ознакомьтесь с политикой обработки данных вашего провайдера и проверьте, какие сетевые инструменты включены.
- Локальное хранение: сеансы диалогов и история шагов хранятся только на вашем локальном компьютере в
~/.andromity/sessions/. - Управление телеметрией: для оптимизации edge-маршрутизации отправляются анонимные метрики задержки и коды ошибок. Вы можете отказаться от этого в любой момент:
- задайте
telemetry = falseв~/.andromity/config.toml; - или экспортируйте
DO_NOT_TRACK=1в профиле вашей командной оболочки.
- задайте
Остальные страницы документации доступны на английском языке. Открыть документацию на английском
Установка AI-агента Andromity для VS Code и терминала
Установите AI-агента для программирования Andromity из VS Code Marketplace, через pipx или с помощью установочного скрипта в Windows, macOS и Linux, а затем проверьте установку.
Локальный AI-агент для программирования с Ollama
Подключите локальные модели Ollama к Andromity в VS Code или терминале, настройте эндпоинт и устраните проблемы с моделью и вызовом инструментов.