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

Tổng quan

OpenCode là một trợ lý lập trình AI mã nguồn mở chạy trong terminal của bạn. Nó hỗ trợ nhiều nhà cung cấp LLM và có thể được cấu hình để sử dụng LemonData API 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"
export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"
Để cấu hình vĩnh viễn, hãy thêm vào ~/.bashrc hoặc ~/.zshrc:
echo 'export OPENAI_API_KEY="sk-your-lemondata-key"' >> ~/.zshrc
echo 'export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"' >> ~/.zshrc
source ~/.zshrc

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

Tạo hoặc chỉnh sửa ~/.config/opencode/opencode.json (toàn cục) hoặc opencode.json trong thư mục gốc của dự án:
{
  "provider": {
    "openai": {
      "options": {
        "apiKey": "sk-your-lemondata-key",
        "baseURL": "https://api.lemondata.cc/v1"
      }
    }
  },
  "model": "gpt-4o",
  "agent": {
    "coder": {
      "model": "gpt-4o"
    }
  }
}

Cách sử dụng cơ bản

Bắt đầu chế độ tương tác:
opencode
Chạy với một prompt:
opencode "Explain this codebase"
Chỉ định mô hình:
opencode --model gpt-4o "Fix the bugs in main.py"

Các mô hình hiện có

Mô hìnhPhù hợp nhất cho
gpt-4oCác tác vụ phức tạp, kiến trúc mã nguồn
gpt-4o-miniSửa lỗi nhanh, các truy vấn đơn giản
claude-sonnet-4-5Review mã nguồn, tài liệu
claude-opus-4-5Suy 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 mã nguồn:
opencode "What does this function do?" < src/utils.ts
Tạo mã nguồn:
opencode "Create a REST API with Express"
Xem lại các 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

LệnhMô tả
/helpHiển thị các lệnh hiện có
/model <name>Chuyển sang một mô hình khác
/clearXóa lịch sử hội thoại
/exitThoát OpenCode

Xử lý sự cố

  • Xác minh LOCAL_ENDPOINT đã được thiết lập 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
  • Kiểm tra xem key có bắt đầu bằng sk- hay không
  • Đảm bảo key đang hoạt động trong dashboard của LemonData
  • Kiểm tra tên mô hình trong cấu hình có khớp chính xác hay không
  • Xác minh tính khả dụng của mô hình tại lemondata.cc/en/models

Các thực hành tốt nhất

Chạy OpenCode từ thư mục gốc của dự án để hiểu rõ hơn về mã nguồn của bạn.
Sử dụng các mô hình nhanh hơn (gpt-4o-mini) cho các tác vụ đơn giản, các mô hình mạnh mẽ (gpt-4o, claude) cho các tác vụ phức tạp.
Luôn xem lại mã nguồn do AI tạo ra trước khi áp dụng các thay đổi vào dự án của bạn.