Skip to Content
aicentos

Amp

Использование aicentos в Amp — переопределение адреса бэкенда через файл конфигурации

Обновлено:

Amp — кодинг-агент от Sourcegraph; CLI и расширение для IDE используют одни и те же аккаунты и настройки. Привычного поля ввода «OpenAI-совместимый Base URL» у него нет: весь бэкенд направляется на кастомный эндпоинт через параметр конфигурации amp.url, а учётные данные хранятся отдельно в файле secrets.

Подготовка

Сначала создайте на странице «API Key» в консоли отдельный ключ для Amp (рекомендуемое имя amp-cli — так проще отслеживать расход):

Конфигурация для заполнения

ПолеЗначение
API Keyключ, созданный в консоли
Base URLhttps://aicentos.com/v1
Модельимя модели из «витрины моделей» в консоли

Шаги настройки

Все параметры Amp имеют префикс amp., пользовательский файл конфигурации находится здесь:

  • macOS / Linux: ~/.config/amp/settings.json
  • Windows: %USERPROFILE%\.config\amp\settings.json

Сначала создайте каталоги, затем запишите адрес бэкенда:

mkdir -p ~/.config/amp ~/.local/share/amp
{
  "amp.url": "https://aicentos.com/v1"
}

API Key пишется не в этом файле, а отдельно в файле secrets, под именем ключа apiKey@<ваш URL>:

{
  "apiKey@https://aicentos.com/v1": "sk-ваш-API-ключ"
}

Когда конфигурация действует, выполнять amp login не нужно: запросы пойдут прямо на указанный вами эндпоинт. Если раньше выполняли вход, рекомендуем сначала выйти через amp logout, затем перезапустить amp, чтобы остаточное состояние входа не перекрыло конфигурацию.

Можно и временно переопределить через переменные окружения — удобно для разовой проверки:

export AMP_URL="https://aicentos.com/v1"
export AMP_API_KEY="sk-ваш-API-ключ"

Внимание: как только эти две переменные заданы, Amp пропускает процесс входа, и их приоритет выше файла конфигурации.

Проверка

Сначала отправьте лёгкий запрос, чтобы убедиться, что эндпоинт переключился:

amp -x "Ответь одним предложением: сколько будет 1+1"

Нормальный ответ означает, что конфигурация действует. При ответе 401 чаще всего имя ключа в файле secrets не совпадает с amp.url дословно (в том числе — есть ли /v1 на конце).

Примечания

  • Протокол бэкенда Amp — его собственный управляющий интерфейс, а не универсальный OpenAI-совместимый протокол, поэтому amp.url должен указывать на эндпоинт, который одновременно предоставляет интерфейс в стиле Anthropic Messages (/v1/messages).
  • aicentos предоставляет нативный интерфейс формата Claude (см. Нативный формат Claude) и OpenAI-совместимый интерфейс (см. Chat Completions); Amp идёт первым путём.
  • Amp запрашивает фиксированные ID моделей; если на стороне эндпоинта модели с таким именем нет, произойдёт откат или ошибка. В таком случае сверьте имена моделей с «витриной моделей» в консоли.
  • Настройки расширения IDE (VS Code / Cursor / Windsurf) ведутся отдельно от CLI: Amp URL и Amp API Key нужно заполнить отдельно.
  • Файл .amp/settings.json в рабочем каталоге перекрывает пользовательские настройки; при диагностике проблем сначала убедитесь, что в текущем каталоге нет одноимённого файла.

Полезные ссылки