Công cụ lập trình
OpenCode
Cấu hình OpenCode để sử dụng API TokenLab
Để agent của tôi thiết lập
Sao chép nhiệm vụ này cho một agent đã hoạt động trên máy tính của bạn:
Đọc hướng dẫn này và giúp tôi kết nối OpenCode với TokenLab:
https://tokenlab.sh/docs/vi/integrations/opencode
Trước tiên, kiểm tra phiên bản đã cài và cấu hình đang có hiệu lực.
Giữ nguyên các tài khoản, nhà cung cấp, quyền và những thiết lập khác hiện có.
Sao lưu các tệp cục bộ và trình bày những thay đổi dự kiến.
Để tôi nhập khóa API cần thiết trên máy của mình; không yêu cầu, hiển thị hoặc dán khóa trong cuộc trò chuyện.
Trước tiên, xác nhận cấu hình tải được bình thường.
Giải thích riêng chi phí của mọi phép thử có gửi yêu cầu trả phí trước khi chạy.Tổng quan
Loại: Công cụ coding
Đường chính: tương thích OpenAI
Mức hỗ trợ: Đường được hỗ trợ
OpenCode là một trợ lý lập trình AI mã nguồn mở chạy trong terminal của bạn. Công cụ này hỗ trợ nhiều nhà cung cấp LLM và có thể được cấu hình để sử dụng API của TokenLab nhằm truy cập hàng trăm mô hình.
Cài đặt
npm install -g opencode-ai@1.18.31Xác minh cài đặt:
opencode --versionCấu hình
Bước 1: Thiết lập biến môi trường
Làm theo bước terminal trong bắt đầu nhanh cho macOS, Linux, WSL hoặc Windows PowerShell để đặt TOKENLAB_API_KEY mà không ghi khóa vào lịch sử lệnh. Mở OpenCode từ terminal đó. Khi dùng lâu dài, hãy dùng trình quản lý bí mật cục bộ, không thêm khóa dạng văn bản vào hồ sơ shell.
Bước 2: Cấu hình OpenCode
Cấu hình dưới đây đã được kiểm tra với OpenCode 1.18.31. Các phiên bản khác cần được xác minh riêng theo tài liệu chính thức.
Lưu cấu hình vào tệp riêng ~/.config/opencode/tokenlab.jsonc. Nếu đã đặt XDG_CONFIG_HOME, dùng opencode/tokenlab.jsonc trong thư mục đó. Giữ nguyên opencode.json / opencode.jsonc thông thường, tài khoản, mô hình mặc định và quyền. Tệp riêng chỉ được tải khi lần khởi chạy đó chọn nó bằng OPENCODE_CONFIG. Nếu tệp hoặc tên nhà cung cấp đã được dùng, chọn tên khác và sửa lệnh tương ứng.
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"tokenlab": {
"npm": "@ai-sdk/openai-compatible",
"name": "TokenLab",
"options": {
"baseURL": "https://api.tokenlab.sh/v1",
"apiKey": "{env:TOKENLAB_API_KEY}"
},
"models": {
"gpt-5.6-terra": {
"name": "GPT-5.6 Terra"
},
"gpt-5.6-luna": {
"name": "GPT-5.6 Luna"
}
}
}
}
}Cấu hình này gửi Chat Completions qua @ai-sdk/openai-compatible. Kiểm tra hỗ trợ Chat Completions và công cụ cần dùng trong thông tin mô hình hiện tại. Ví dụ không chứng minh khả năng tương thích với giao thức hoặc phiên bản khác.
Tùy chọn: trình cấu hình OpenCode có thể khôi phục dùng Python 3.11+ để xem trước, áp dụng và khôi phục tệp gốc. Plugin TokenLab Skills 0.1.2 chứa các script này; Skill độc lập cũng dùng được sau khi cập nhật lên phiên bản có chúng. Nếu đã cài plugin hoặc Skill độc lập, làm theo hướng dẫn cập nhật README và kiểm tra script đã có. Các bước thủ công trên trang vẫn dùng được mà không cần trình cấu hình.
Cách dùng cơ bản
Đặt khóa theo phần bắt đầu nhanh, rồi chỉ tải tệp cho lần khởi chạy này và chọn rõ mô hình. Thay đường dẫn và tên nhà cung cấp tùy chỉnh nếu có. Giữ thiết lập OPENCODE_CONFIG hoặc OPENCODE_CONFIG_CONTENT có sẵn trong môi trường khởi chạy riêng; cấu hình dự án hoặc được quản lý vẫn có thể được ưu tiên.
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terraDanh sách mô hình kiểm tra việc tải cục bộ, không chứng minh khóa hợp lệ hay yêu cầu thực tế thành công. Prompt dùng số dư TokenLab; OpenCode có thể gửi thêm yêu cầu phụ được tính phí riêng, như tạo tiêu đề. Kiểm tra phản hồi và các bản ghi tương ứng.
Khởi chạy không tải tệp này để dùng thiết lập thông thường. Không lưu OPENCODE_CONFIG vào hồ sơ shell chỉ để làm theo hướng dẫn. Khi hoàn tác cấu hình thủ công, chỉ xóa tệp riêng vừa tạo hoặc khôi phục bản sao lưu nếu tệp đã có từ trước.
Các model khả dụng
| Mô hình | Phù hợp nhất cho |
|---|---|
gpt-5.6-terra | Tác vụ phức tạp, kiến trúc code |
gpt-5.6-luna | Sửa lỗi nhanh, truy vấn đơn giản |
claude-sonnet-4-6 | Review code, tài liệu |
claude-opus-4-6 | Suy luận phức tạp |
gemini-3.5-flash | Phản hồi nhanh |
Các lệnh phổ biến
Phân tích code:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.tsSinh code:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"Review thay đổi:
git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"Sửa lỗi:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"Các lệnh tương tác
| Command | Mô tả |
|---|---|
/help | Hiển thị các lệnh khả dụng |
/models | Chuyển sang một model khác |
/clear | Xóa lịch sử hội thoại |
/exit | Thoát OpenCode |