Amp
Использование aicentos в Amp — переопределение адреса бэкенда через файл конфигурации
Обновлено:
Amp — кодинг-агент от Sourcegraph; CLI и расширение для IDE используют одни и те же аккаунты и настройки. Привычного поля ввода «OpenAI-совместимый Base URL» у него нет: весь бэкенд направляется на кастомный эндпоинт через параметр конфигурации amp.url, а учётные данные хранятся отдельно в файле secrets.
Подготовка
Сначала создайте на странице «API Key» в консоли отдельный ключ для Amp (рекомендуемое имя amp-cli — так проще отслеживать расход):
- Консоль: https://aicentos.com
- Создание ключа: https://aicentos.com/keys
- Пополнение при нехватке баланса: https://aicentos.com/wallet
Конфигурация для заполнения
| Поле | Значение |
|---|---|
| API Key | ключ, созданный в консоли |
| Base URL | https://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в рабочем каталоге перекрывает пользовательские настройки; при диагностике проблем сначала убедитесь, что в текущем каталоге нет одноимённого файла.
Полезные ссылки
- Официальная документация по настройкам: https://ampcode.com/docs/cli/settings