Chuyển đến nội dung chính

Tổng quan

Loại: Công cụ codingĐường chính: OpenAI-compatibleMứ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 LemonData nhằm truy cập hơn 300 mô hình.

Cài đặt

curl -fsSL https://opencode.ai/install | bash
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-lemondata-key"
Để cấu hình vĩnh viễn, thêm vào ~/.bashrc hoặc ~/.zshrc:
echo 'export OPENAI_API_KEY="sk-your-lemondata-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 LemonData, 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": {
    "lemondata": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LemonData",
      "options": {
        "baseURL": "https://api.lemondata.cc/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "lemondata/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 lemondata/gpt-5.4 "Fix the bugs in main.py"

Các model khả dụng

ModelPhù hợp nhất cho
gpt-5.4Tác vụ phức tạp, kiến trúc code
gpt-5-miniSử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-2.5-flashPhản hồi nhanh
deepseek-r1Thiế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

CommandMô tả
/helpHiển thị các lệnh khả dụng
/model <name>Chuyể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ố

  • Xác minh options.baseURL được đặt thành https://api.lemondata.cc/v1
  • Kiểm tra kết nối mạng
  • Thử curl https://api.lemondata.cc/v1/models để kiểm tra
  • 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 LemonData
  • 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 lemondata.cc/en/models

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

Chạy OpenCode từ thư mục gốc của dự án để hiểu codebase của bạn tốt hơn.
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.
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.