Chuyển đến nội dung chính
OpenCode có thể kết nối với 4096bytes thông qua Provider tương thích OpenAI. Hãy ghi cấu hình opencode.json do bảng điều khiển tạo vào tệp cấu hình OpenCode. Nên sao chép cấu hình từ hộp thoại Use key trong bảng điều khiển. Tab OpenCode sẽ chèn API Key, Base URL và tên mô hình hiện tại theo định dạng OpenCode.

​
Điều kiện trước

  • Bạn đã hoàn thành Tạo tài khoản.
  • Bạn đã hoàn thành Lấy API Key.
  • OpenCode đã được cài và opencode --version chạy được.
  • Hộp thoại Use key đã mở cho API Key bạn muốn dùng.
API Key trong opencode.json được lưu cục bộ dạng văn bản rõ. Không đưa tệp cấu hình, ảnh chụp hoặc đầu ra terminal có chứa API Key đầy đủ vào repository hoặc cuộc trò chuyện.

​
Cài đặt

Nếu chưa cài OpenCode, xem hướng dẫn mới nhất trong tài liệu OpenCode. macOS hoặc Linux: 
curl -fsSL https://opencode.ai/install | bash
Nếu bạn dùng npm để quản lý CLI toàn cục: 
npm install -g opencode-ai
Sau khi cài, mở lại terminal và kiểm tra: 
opencode --version

​
Sao chép cấu hình từ bảng điều khiển

1

Mở API Keys

Mở bảng điều khiển và vào API Keys.
2

Chọn OpenCode

Tìm key muốn dùng cho OpenCode, nhấn Use key, rồi chọn OpenCode.
3

Sao chép cấu hình

Sao chép nội dung opencode.json được tạo. Ví dụ chỉ để tham khảo. Hãy dùng Base URL, API Key và tên mô hình được hiển thị trong bảng điều khiển của bạn.
4

Ghi tệp cấu hình

Để dùng toàn cục, ghi vào ~/.config/opencode/opencode.json. Để chỉ dùng trong dự án, ghi opencode.json ở thư mục gốc của dự án.

​
Đường dẫn cấu hình

Phạm viĐường dẫnKhi dùng
Cấu hình toàn cục~/.config/opencode/opencode.jsonDùng 4096bytes mặc định trong mọi dự án.
Cấu hình dự ánopencode.jsonChỉ dùng cấu hình này trong dự án hiện tại.
Nếu tệp chưa tồn tại, hãy tạo thủ công. Cấu hình dự án có độ ưu tiên cao hơn cấu hình toàn cục.

​
Kiểm tra

Lưu cấu hình, vào thư mục một dự án và chạy: 
opencode
Sau khi OpenCode mở, hãy bắt đầu bằng một yêu cầu rủi ro thấp: 
Mô tả mục đích của thư mục hiện tại trong một câu. Không sửa tệp.
Nếu OpenCode phản hồi mà không báo lỗi xác thực hoặc lỗi mô hình, cấu hình đã có hiệu lực.

​
Vấn đề thường gặp

Kiểm tra opencode.json là JSON hợp lệ. Xác nhận apiKey không thiếu ký tự, không có xuống dòng hoặc khoảng trắng thừa.
ID mô hình phải khớp với tên được hiển thị trong bảng điều khiển. Không sao chép từ ảnh của người khác.
Xác nhận bạn đã sửa đúng tệp mà OpenCode đang đọc. opencode.json ở thư mục gốc dự án sẽ ghi đè các trường tương ứng trong cấu hình toàn cục.
Có, nhưng /connect chỉ lưu thông tin xác thực. Provider, Base URL và danh sách mô hình vẫn nên lấy từ opencode.json do bảng điều khiển tạo.