# Amp

Источник: https://docs.aicentos.com/ru/clients/amp

Language: ru

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

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

## Подготовка

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

* Консоль: [https://aicentos.com](https://aicentos.com)
* Создание ключа: [https://aicentos.com/keys](https://aicentos.com/keys)
* Пополнение при нехватке баланса: [https://aicentos.com/wallet](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`

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

```bash
mkdir -p ~/.config/amp ~/.local/share/amp
```

```json
{
  "amp.url": "https://aicentos.com/v1"
}
```

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

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

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

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

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

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

## Проверка

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

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

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

## Примечания

* Протокол бэкенда Amp — его собственный управляющий интерфейс, а не универсальный OpenAI-совместимый протокол, поэтому `amp.url` должен указывать на эндпоинт, который одновременно предоставляет интерфейс в стиле Anthropic Messages (`/v1/messages`).
* aicentos предоставляет нативный интерфейс формата Claude (см. [Нативный формат Claude](https://docs.aicentos.com/ru/api/chat/claude)) и OpenAI-совместимый интерфейс (см. [Chat Completions](https://docs.aicentos.com/ru/api/chat/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](https://ampcode.com/docs/cli/settings)