Công cụ lập trình
OpenCode
Cấu hình OpenCode để sử dụng TokenLab API
Để agent của tôi thiết lập việc này
Sao chép tác vụ này vào một agent đang chạy trên máy tính của bạn:
Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/vi/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Tổng quan
OpenCode có thể sử dụng TokenLab thông qua một nhà cung cấp tương thích với OpenAI tùy chỉnh. Hãy thêm TokenLab API key, Base URL và ID model hiện tại.
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
Sử dụng các hướng dẫn terminal trong Bắt đầu nhanh cho macOS, Linux, WSL hoặc Windows PowerShell để thiết lập TOKENLAB_API_KEY mà không cần lưu key vào lịch sử lệnh. Khởi chạy OpenCode 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 key dạng văn bản thuần túy vào profile shell của bạn.
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 dựa trên tài liệu chính thức.
Tạo một tệp riêng biệt ~/.config/opencode/tokenlab.jsonc với cấu hình dưới đây. Nếu XDG_CONFIG_HOME đã được thiết lập, hãy sử dụng opencode/tokenlab.jsonc trong thư mục đó. Giữ nguyên các tệp opencode.json / opencode.jsonc, tài khoản, model mặc định và quyền hạn hiện tại: tệp riêng biệt này chỉ được tải khi có lệnh gọi chọn nó bằng OPENCODE_CONFIG. Nếu tên tệp hoặc nhà cung cấp đã thuộc về một thiết lập khác, hãy chọn tên tệp/tên nhà cung cấp khác và điều chỉnh các lệnh.
{
"$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 sử dụng @ai-sdk/openai-compatible cho Chat Completions. Hãy chọn một model hiện tại có chi tiết hỗ trợ Chat Completions và các công cụ bạn cần; đừng tự suy diễn khả năng hỗ trợ cho giao thức hoặc phiên bản khác từ ví dụ này.
Tùy chọn: trình hỗ trợ thiết lập OpenCode có thể đảo ngược cung cấp khả năng xem trước, áp dụng và khôi phục tệp gốc với Python 3.11+. Plugin TokenLab Skills 0.1.2 bao gồm các tập lệnh này; một bản cài đặt Skill độc lập cũng có thể được sử dụng sau khi cập nhật lên phiên bản chứa chúng. Đối với plugin hiện có hoặc bản cài đặt Skill độc lập, hãy làm theo hướng dẫn cập nhật README và xác nhận tập lệnh đã có mặt. Cấu hình thủ công ở đây vẫn có thể sử dụng được mà không cần trình hỗ trợ.
Sử dụng cơ bản
Thiết lập key bằng Quickstart, sau đó tải tệp này và chọn model một cách rõ ràng cho lệnh gọi này. Thay thế đường dẫn và tên nhà cung cấp thực tế của bạn nếu đã tùy chỉnh. Giữ nguyên mọi thiết lập OPENCODE_CONFIG hoặc OPENCODE_CONFIG_CONTENT nội dòng hiện có trong một môi trường khởi chạy riêng biệt; các thiết lập dự án và thiết lập được quản lý có thể vẫn đượ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-terraViệc khám phá model kiểm tra khả năng tải cục bộ, không phải tính hợp lệ của key hay yêu cầu trực tiếp thành công. Một prompt sẽ sử dụng số dư TokenLab và OpenCode có thể gửi các yêu cầu phụ được tính phí riêng, chẳng hạn như tạo tiêu đề. Hãy kiểm tra phản hồi và hồ sơ yêu cầu tương ứng.
Để sử dụng thiết lập thông thường của bạn, hãy khởi chạy mà không có lớp này. Không lưu OPENCODE_CONFIG trong profile shell của bạn cho hướng dẫn này. Để hoàn tác thiết lập thủ công, chỉ cần xóa tệp riêng biệt bạn đã tạo hoặc khôi phục bản sao lưu của nó nếu nó tồn tại trước đó.
Tạo hình ảnh và video trong cùng một agent
OpenCode 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 mcp này vào cùng tệp tokenlab.jsonc, bên cạnh provider. OpenCode thay thế {env:TOKENLAB_API_KEY} bằng biến từ terminal của bạn, vì vậy key không bị ghi vào tệp:
{
"mcp": {
"tokenlab": {
"type": "local",
"command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
"environment": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
},
"timeout": 30000
}
}
}Thời gian timeout dài hơn giúp npx có thời gian tải xuống gói trong lần khởi động đầu tiên. Chạy opencode mcp list với cùng OPENCODE_CONFIG và kiểm tra xem tokenlab đã được kết nối chưa. 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 OpenCode MCP servers để biết các thiết lập khác.
Chọn Model
Sao chép ID model lập trình hiện tại từ trang Models. Hãy so sánh các model trên kho lưu trữ của riêng bạn trước khi đặt làm mặc định.
Các lệnh phổ biến
Phân tích mã nguồn:
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.tsTạo mã nguồn:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"Xem lại các 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
| Lệnh | Mô tả |
|---|---|
/help | Hiển thị các lệnh khả dụng |
/models | Chuyển sang model khác |
/clear | Xóa lịch sử trò chuyện |
/exit | Thoát OpenCode |