Amp

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ịSao chép liên kết neo

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
• Tạo Key: https://aicentos.com/keys
• Nạp tiền khi hết số dư: https://aicentos.com/wallet

Cấu hình cần điềnSao chép liên kết neo

Các bước thiết lậpSao chép liên kết neo

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:

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

{
  "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>:

{
  "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:

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 traSao chép liên kết neo

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

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 ýSao chép liên kết neo

• 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) và giao diện tương thích OpenAI (xem 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 quanSao chép liên kết neo

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