OpenCode

Tổng quan

Loại: Công cụ codingĐường chính: tương thích OpenAIMứ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

Script cài đặt
Homebrew
Go

curl -fsSL https://opencode.ai/install | bash

brew install opencode-ai/tap/opencode

Hoặc sử dụng tap từ cộng đồng (cập nhật thường xuyên hơn):

brew install anomalyco/tap/opencode

go install github.com/opencode-ai/opencode@latest

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

export OPENAI_API_KEY="sk-your-tokenlab-key"

Để cấu hình vĩnh viễn, thêm vào ~/.bashrc hoặc ~/.zshrc:

echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

Bước 2: Cấu hình OpenCode

Tài liệu hiện tại của OpenCode khuyến nghị cấu hình các nhà cung cấp thông qua opencode.json hoặc opencode.jsonc. Với TokenLab, hãy sử dụng một nhà cung cấp tùy chỉnh thay vì ghi đè nhà cung cấp openai tích hợp sẵn:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "tokenlab/gpt-5.4"
}

Sử dụng @ai-sdk/openai-compatible để tương thích theo kiểu chat-completions. Nếu bạn cần cụ thể một đường dẫn nhà cung cấp được xây dựng trên /v1/responses, tài liệu OpenCode khuyến nghị chuyển package sang @ai-sdk/openai.

Cách dùng cơ bản

Khởi động chế độ tương tác:

opencode

Chạy với một prompt:

opencode "Explain this codebase"

Chỉ định model:

opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"

Các model khả dụng

Mô hình	Phù hợp nhất cho
`gpt-5.4`	Tác vụ phức tạp, kiến trúc code
`gpt-5-mini`	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
`deepseek-r1`	Thiết kế thuật toán

Các lệnh phổ biến

Phân tích code:

opencode "What does this function do?" < src/utils.ts

Sinh code:

opencode "Create a REST API with Express"

Review thay đổi:

git diff | opencode "Review these changes"

Sửa lỗi:

opencode "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
`/model <name>`	Chuyển sang một model khác
`/clear`	Xóa lịch sử hội thoại
`/exit`	Thoát OpenCode

Khắc phục sự cố

Lỗi kết nối

Xác minh options.baseURL được đặt thành https://api.tokenlab.sh/v1
Kiểm tra kết nối mạng
Thử curl https://api.tokenlab.sh/v1/models để kiểm tra

Xác thực thất bại

Xác minh biến môi trường OPENAI_API_KEY đã được thiết lập
Xác minh options.apiKey tham chiếu đến {env:OPENAI_API_KEY} hoặc một nguồn secret hợp lệ khác
Kiểm tra khóa bắt đầu bằng sk-
Đảm bảo khóa đang hoạt động trong dashboard TokenLab

Không tìm thấy model

Kiểm tra tên model trong config có khớp chính xác hay không
Xác minh tính khả dụng của model tại tokenlab.sh/en/models

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

Sử dụng ngữ cảnh dự án

Chạy OpenCode từ thư mục gốc của dự án để hiểu codebase của bạn tốt hơn.

Chọn model phù hợp

Sử dụng các model nhanh hơn (gpt-5-mini) cho tác vụ đơn giản và các model mạnh hơn (gpt-5.4, claude-sonnet-4-6) cho tác vụ phức tạp.

Review code được sinh ra

Luôn review code do AI sinh ra trước khi áp dụng các thay đổi vào dự án của bạn.

Ma trận tương thích

Công cụ lập trình

SDK gốc

Framework và nền tảng

Ứng dụng chat

Tổng quan

Cài đặt

Cấu hình

Bước 1: Thiết lập biến môi trường

Bước 2: Cấu hình OpenCode

Cách dùng cơ bản

Các model khả dụng

Các lệnh phổ biến

Các lệnh tương tác

Khắc phục sự cố

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

​Tổng quan

​Cài đặt

​Cấu hình

​Bước 1: Thiết lập biến môi trường

​Bước 2: Cấu hình OpenCode

​Cách dùng cơ bản

​Các model khả dụng

​Các lệnh phổ biến

​Các lệnh tương tác

​Khắc phục sự cố

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

Tổng quan

Cài đặt

Cấu hình

Bước 1: Thiết lập biến môi trường

Bước 2: Cấu hình OpenCode

Cách dùng cơ bản

Các model khả dụng

Các lệnh phổ biến

Các lệnh tương tác

Khắc phục sự cố

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