TokenLab

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

OpenCode

npm install -g opencode-ai@1.18.31

Xác minh cài đặt:

opencode --version

Cấ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-terra

Danh 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ìnhPhù hợp nhất cho
gpt-5.6-terraTác vụ phức tạp, kiến trúc code
gpt-5.6-lunaSửa lỗi nhanh, truy vấn đơn giản
claude-sonnet-4-6Review code, tài liệu
claude-opus-4-6Suy luận phức tạp
gemini-3.5-flashPhả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.ts

Sinh 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

CommandMô tả
/helpHiển thị các lệnh khả dụng
/modelsChuyển sang một model khác
/clearXóa lịch sử hội thoại
/exitThoát OpenCode

Khắc phục sự cố

Thực tiễn tốt nhất

Trên trang này