# Amp

Nguồn: https://docs.aicentos.com/vi/clients/amp

Language: vi

> Dùng aicentos trong Amp —— ghi đè địa chỉ backend qua file cấu hình

Amp là agent lập trình do Sourcegraph phát hành, CLI và extension IDE dùng chung một bộ tài khoản và thiết lập. Nó không có ô nhập "Base URL tương thích OpenAI" thông thường, mà qua mục cấu hình `amp.url` trỏ toàn bộ backend về endpoint tùy chỉnh, credentials lưu riêng trong file secrets.

## Chuẩn bị

Trước tiên, tạo một Key riêng cho Amp tại trang "API Key" trong Console (khuyến nghị đặt tên `amp-cli` để dễ theo dõi mức sử dụng):

* Console: [https://aicentos.com](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền khi hết số dư: [https://aicentos.com/wallet](https://aicentos.com/wallet)

## Cấu hình cần điền

| Trường   | Giá trị                                      |
| -------- | -------------------------------------------- |
| API Key  | Key tạo trong Console                        |
| Base URL | `https://aicentos.com/v1`                    |
| Mô hình  | tên mô hình trong "Model Square" của Console |

## Các bước thiết lập

Các mục thiết lập của Amp đều có tiền tố `amp.`, file cấu hình cấp người dùng nằm tại:

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

Tạo thư mục trước, rồi ghi địa chỉ backend vào:

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

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

API Key không ghi trong file này, mà đặt riêng trong file secrets, tên khoá là `apiKey@<URL-của-bạn>`:

```json
{
  "apiKey@https://aicentos.com/v1": "sk-API-Key-của-bạn"
}
```

Sau khi cấu hình có hiệu lực, không cần chạy `amp login` nữa, yêu cầu sẽ đi thẳng endpoint bạn chỉ định. Nếu trước đó từng đăng nhập, khuyến nghị `amp logout` thoát trước rồi khởi động lại `amp`, tránh trạng thái đăng nhập còn sót ghi đè cấu hình.

Cũng có thể dùng biến môi trường để ghi đè tạm thời, phù hợp để xác minh một lần trước:

```bash
export AMP_URL="https://aicentos.com/v1"
export AMP_API_KEY="sk-API-Key-của-bạn"
```

**Lưu ý:** một khi đặt hai biến này, Amp sẽ bỏ qua quy trình đăng nhập, độ ưu tiên cao hơn file cấu hình.

## Kiểm tra

Trước gửi một yêu cầu nhẹ, xác nhận endpoint đã chuyển qua:

```bash
amp -x "Trả lời trong một câu: 1+1 bằng mấy"
```

Trả về bình thường nghĩa là cấu hình có hiệu lực. Nếu trả về 401, nhiều khả năng tên khoá trong file secrets không khớp hoàn toàn với `amp.url` (kể cả phần cuối có `/v1` hay không).

## Lưu ý

* Giao thức backend của Amp là giao diện quản lý riêng của nó, không phải giao thức tương thích OpenAI thông dụng, do đó `amp.url` bắt buộc trỏ đến endpoint đồng thời cung cấp giao diện phong cách Anthropic Messages (`/v1/messages`).
* aicentos cung cấp giao diện định dạng Claude gốc (xem [Định dạng Claude gốc](https://docs.aicentos.com/vi/api/chat/claude)) và giao diện tương thích OpenAI (xem [Chat Completions](https://docs.aicentos.com/vi/api/chat/openai/chat-completions)); Amp đi theo cái trước.
* Amp sẽ yêu cầu model ID cố định, nếu phía endpoint không có mô hình cùng tên, sẽ xảy ra fallback hoặc báo lỗi. Khi gặp trường hợp này, hãy lấy "Model Square" của Console làm chuẩn để đối chiếu tên mô hình.
* Thiết lập của extension IDE (VS Code / Cursor / Windsurf) được bảo trì tách riêng với CLI, cần điền riêng Amp URL và Amp API Key.
* `.amp/settings.json` trong workspace sẽ ghi đè thiết lập cấp người dùng; khi xử lý sự cố, trước tiên xác nhận trong thư mục hiện tại không có file cùng tên.

## Liên kết liên quan

* Tài liệu thiết lập chính thức: [https://ampcode.com/docs/cli/settings](https://ampcode.com/docs/cli/settings)