GitHub Copilot Chat với Claude qua cổng API: thiết lập Custom Endpoint, chế độ tác tử và cách khắc phục lỗi

Tính năng trò chuyện của VS Code có thể chạy trên các mô hình do bạn tự cung cấp. Nhà cung cấp Anthropic tích hợp chỉ chấp nhận khóa API, không có trường để nhập địa chỉ khác, nên cổng kết nối được thêm thông qua nhà cung cấp Điểm cuối tùy chỉnh. Chọn loại API Messages và liệt kê các mô hình trong chatLanguageModels.json. Tính năng này đã có trong bản VS Code ổn định từ phiên bản 1.122.

Phạm vi hỗ trợ khi dùng khóa riêng

Kể từ VS Code 1.122, các mô hình này hoạt động mà không cần đăng nhập GitHub và không cần gói Copilot. Trên Copilot Business và Enterprise, BYOK được bật theo mặc định, và quản trị viên có thể tắt bằng chính sách **Dùng khóa mô hình ngôn ngữ riêng**.

Thêm cổng kết nối dưới dạng Điểm cuối tùy chỉnh

1. Mở chế độ xem trò chuyện, mở bộ chọn mô hình rồi chọn **Quản lý mô hình ngôn ngữ**, hoặc chạy **Trò chuyện: Quản lý mô hình ngôn ngữ** từ Bảng lệnh.
2. Chọn **Thêm mô hình**, rồi chọn nhà cung cấp **Điểm cuối tùy chỉnh**.
3. Nhập tên hiển thị và khóa API của cổng.
4. Chọn loại API **Messages**. Sau đó, VS Code mở chatLanguageModels.json để xem danh sách mô hình.

chatLanguageModels.json

[
  {
    "name": "AI Prime Tech",
    "vendor": "customendpoint",
    "apiKey": "${input:aiprimeApiKey}",
    "apiType": "messages",
    "models": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "claude-opus-5-5",
        "name": "Claude Opus 5.5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "claude-haiku-4-5",
        "name": "Claude Haiku 4.5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 168000,
        "maxOutputTokens": 32000
      }
    ]
  }
]

Với loại Messages, VS Code gửi khóa trong header x-api-key , đúng như cổng yêu cầu. ID mô hình phải khớp chính xác với ID trên cổng.

Các mô hình GPT trên cùng một khóa

Nhà cung cấp Custom Endpoint cũng hỗ trợ các định dạng OpenAI. Để thêm các mô hình GPT bằng khóa thuộc nhóm Codex của cổng, hãy thêm nhà cung cấp thứ hai với "apiType": "chat-completions" và các URL mô hình là https://aiprimetech.io/v1/chat/completions. Một khóa chỉ truy cập được các mô hình trong nhóm của chính nó, nên Claude và GPT thường cần các mục riêng với khóa riêng.

Thiết lập cũ github.copilot.chat.customOAIModels và nhà cung cấp **OpenAI Compatible** đã bị ngừng khuyến nghị sử dụng để chuyển sang Custom Endpoint. Chuyển các mục cũ vào chatLanguageModels.json.

Khắc phục sự cố

Để xem chi tiết, chạy **Nhà phát triển: Đặt mức nhật ký**, chọn **Trace**, sau đó mở **Đầu ra** và chọn **GitHub Copilot Chat**. Chế độ xem Gỡ lỗi trò chuyện hiển thị chính xác các yêu cầu. Dòng nhật ký cho biết các nhà cung cấp BYOK đã bị hủy đăng ký do chính sách không cho phép là dấu hiệu của chính sách tổ chức.

Bạn thích dùng terminal hơn? Cùng khóa đó có thể chạy Claude Code trong VS Code thông qua tiện ích mở rộng riêng.

Câu hỏi thường gặp

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.