Công cụ lập trình
GitHub Copilot CLI
Kết nối GitHub Copilot CLI với TokenLab bằng BYOK
Tổng quan
GitHub Copilot CLI có thể kết nối với bất kỳ endpoint nào tương thích với OpenAI Chat Completions. TokenLab hoạt động thông qua các biến môi trường BYOK của Copilot CLI.
Cài đặt
Với Node.js 22 trở lên, hãy cài đặt thông qua npm:
npm install -g @github/copilot@1.0.85Trên macOS hoặc Linux, bạn có thể sử dụng Homebrew:
brew install --cask copilot-cliXác minh cài đặt:
copilot --versionCấu hình TokenLab
Thiết lập các biến nhà cung cấp trước khi khởi chạy Copilot CLI:
Sử dụng các hướng dẫn trong terminal tại Bắt đầu nhanh cho macOS, Linux, WSL hoặc Windows PowerShell để thiết lập TOKENLAB_API_KEY mà không lưu khóa vào lịch sử lệnh. Khởi chạy Copilot CLI từ terminal đó. Để sử dụng lâu dài, hãy dùng trình quản lý bí mật (secret manager) cục bộ của bạn; không thêm khóa dạng văn bản thuần túy vào shell profile.
Các biến này chỉ áp dụng cho lần khởi chạy này; tài khoản đã lưu, mô hình mặc định và cài đặt quyền của bạn vẫn được giữ nguyên. Hãy khởi chạy bình thường mà không cần các biến này để sử dụng thiết lập trước đó của bạn. Không lưu chúng vĩnh viễn trong shell profile.
COPILOT_PROVIDER_TYPE=openai COPILOT_PROVIDER_BASE_URL=https://api.tokenlab.sh/v1 COPILOT_PROVIDER_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" copilot --model claude-sonnet-5-5| Biến | Giá trị TokenLab |
|---|---|
COPILOT_PROVIDER_TYPE | openai |
COPILOT_PROVIDER_BASE_URL | https://api.tokenlab.sh/v1 |
COPILOT_PROVIDER_API_KEY | Khóa API TokenLab của bạn |
COPILOT_MODEL | ID mô hình đang hoạt động, ví dụ claude-sonnet-5-5 |
GitHub yêu cầu mô hình được chọn phải hỗ trợ cả streaming và gọi công cụ (tool calling). claude-sonnet-5-5 hỗ trợ gọi công cụ và có cửa sổ ngữ cảnh lớn hơn mức tối thiểu 128K mà GitHub khuyến nghị.
Xác minh
Bên trong Copilot CLI, trước tiên hãy yêu cầu một hành động chỉ đọc (read-only), ví dụ:
Inspect this repository and summarize its top-level structure. Do not modify files.Việc lưu cài đặt hoặc liệt kê các mô hình không xác minh khóa hoặc một yêu cầu đã hoàn tất. Một câu lệnh (prompt) sẽ sử dụng số dư TokenLab. Hãy kiểm tra phản hồi và bản ghi yêu cầu tương ứng trước khi thử các công cụ; các yêu cầu phụ trợ cũng có thể bị tính phí.
Để xem các cài đặt nhà cung cấp mà Copilot CLI ghi lại, hãy chạy:
copilot help providersTạo hình ảnh và video trong cùng một agent
Copilot CLI cũng có thể tạo hình ảnh và video ngắn với TokenLab MCP server. Mỗi lần tạo đều được thanh toán từ cùng một số dư TokenLab. Hợp nhất mục này vào ~/.copilot/mcp-config.json. Copilot CLI chỉ chuyển PATH đến server, vì vậy cả hai biến đều nằm trong env:
{
"mcpServers": {
"tokenlab": {
"type": "local",
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
},
"tools": ["*"]
}
}
}Thay thế <TOKENLAB_API_KEY> bằng khóa của bạn chỉ trong tệp cục bộ này. Khởi động Copilot CLI và chạy /mcp show tokenlab để kiểm tra kết nối. Sau đó thử:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video trả về một ID tác vụ. Agent sẽ gọi get_task_status cho đến khi video sẵn sàng. Xem Thêm MCP servers vào Copilot CLI để biết các cài đặt khác.
Khắc phục sự cố
Không commit các khóa API vào các tập lệnh shell hoặc các tệp dotfile được theo dõi bởi Git. Hãy xoay vòng (rotate) bất kỳ khóa nào đã bị lộ trong lịch sử terminal, ảnh chụp màn hình hoặc nhật ký.