GitHub Copilot CLI

Bốn biến môi trường — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY và COPILOT_MODEL — chuyển Copilot CLI sang endpoint riêng của bạn, và GitHub ghi rõ BYOK không cần đăng nhập GitHub.

# Set before you start Copilot CLI. Variable names and order are GitHub's;
# COPILOT_PROVIDER_BASE_URL and COPILOT_MODEL are the two marked Required.
export COPILOT_PROVIDER_BASE_URL=https://api.kunavo.com/v1   # see the note below
export COPILOT_PROVIDER_TYPE=openai                          # the default, shown for clarity
export COPILOT_PROVIDER_API_KEY=sk-kn-...
export COPILOT_MODEL=claude-sonnet-5

copilot

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Kiểm tra xem có ~/.copilot/providers.json cũ nào không (hoặc tệp mà COPILOT_PROVIDERS_CONFIG trỏ đến). Nếu tệp đó khai báo nhà cung cấp hoặc model, cấu hình trong bước 3 sẽ bị ghi đè hoàn toàn.
3. Export COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_API_KEY và COPILOT_MODEL như trên. Mặc định, COPILOT_PROVIDER_TYPE là openai, mà GitHub mô tả là hỗ trợ “mọi endpoint khác tương thích với API OpenAI Chat Completions”.
4. Khởi chạy copilot từ cùng shell đó — các giá trị này được đọc lúc khởi động, vì vậy một terminal đã mở trước đó vẫn giữ các giá trị cũ.
5. Giao cho CLI một tác vụ đọc và chỉnh sửa tệp. Copilot CLI cần model hỗ trợ gọi công cụ và truyền phát dữ liệu; lần chạy đầu tiên kiểm tra cả hai điều này sẽ cho bạn biết nhiều hơn một lời chào. --model ghi đè COPILOT_MODEL trong một lần chạy nếu bạn muốn so sánh hai id.

Đã kiểm tra đối chiếu với “Dùng model LLM của riêng bạn trong GitHub Copilot CLI” của GitHub vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong GitHub Copilot CLI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Lựa chọn khác: COPILOT_PROVIDER_TYPE=anthropic

GitHub ghi rõ có ba loại nhà cung cấp, và Kunavo hỗ trợ hai trong số các định dạng truyền tải này: /v1/chat/completions dành cho openai và /v1/messages dành cho anthropic. Ví dụ Anthropic trên trang GitHub gồm bốn lệnh export, với URL cơ sở là origin thuần https://api.anthropic.com:

1. COPILOT_PROVIDER_TYPE=anthropic
2. COPILOT_PROVIDER_BASE_URL — theo cấu trúc ví dụ của GitHub, hãy dùng https://api.kunavo.com không có hậu tố, vì route riêng của Anthropic nằm tại /v1/messages bên dưới origin đó và Kunavo cũng dùng cấu trúc này. Lưu ý tương tự như trên: GitHub đưa ra một ví dụ, không phải quy tắc.
3. COPILOT_PROVIDER_API_KEY — khóa sk-kn- của bạn. Bề mặt Messages của Kunavo chấp nhận khóa này trong x-api-key hoặc Authorization: Bearer, vì vậy CLI chọn header nào thì khóa cũng được nhận diện.
4. COPILOT_MODEL — id mà nhà cung cấp của bạn yêu cầu. Ví dụ của GitHub dùng cách viết kiểu Anthropic có dấu gạch nối, trong khi danh sách model được hỗ trợ của chính GitHub ghi cùng các họ model với dấu chấm; với BYOK, id được gửi đến endpoint của bạn, vì vậy hãy dùng cách viết trong bảng ở trên.

Vì sao trang này ưu tiên loại openai: tài liệu của GitHub không cho biết liệu luồng BYOK của Anthropic có chuyển tiếp cache_control, anthropic-beta hay một anthropic-version cụ thể nào hay không. Điều này ảnh hưởng đến hóa đơn khi ngữ cảnh lặp lại — xem bộ nhớ đệm prompt — và trang này không thể giả định một câu trả lời chưa được tài liệu hóa. Loại openai không có câu hỏi bỏ ngỏ như vậy, nên đây là loại có khối cấu hình hoàn chỉnh.