Hướng dẫn thiết lập nhà cung cấp AI

Cấu hình OpenCode

OpenCode là trợ lý lập trình AI chạy trên terminal mã nguồn mở. Công cụ này thích hợp cho việc hỏi đáp mã nguồn, chỉnh sửa tệp và chuyển đổi mô hình trong thư mục dự án. Người mới bắt đầu nên sử dụng trình hướng dẫn kết nối có sẵn trước và tránh tự tay viết toàn bộ tệp JSON ngay từ đầu.

Thông tin chính thức Tải xuống và tài liệu hướng dẫn căn cứ theo trang web chính thức.

Trang web chính thức OpenCode Trợ lý lập trình AI mã nguồn mở trên terminal Tài liệu hướng dẫn Hướng dẫn cài đặt, xác thực và các lệnh Tham khảo cấu hình nhà cung cấp AI Tham khảo hướng dẫn cấu hình trong opencode.json

Công cụ này là gì và dùng để làm gì

Vị trí tệp cấu hình

Hệ điều hành	Vị trí tệp cấu hình	Mô tả
Windows	`C: \Users\YourUsername\. config\opencode\opencode.json`	Nếu tệp chưa tồn tại, hãy tạo tệp mới
macOS / Linux	`~/. config/opencode/opencode.json`	Nếu tệp chưa tồn tại, hãy tạo tệp mới

Bắt đầu với trình hướng dẫn kết nối

Trình hướng dẫn kết nối OpenCode

cd YOUR_TEST_PROJECT opencode /connect

Kiểm tra mô hình OpenCode

cd YOUR_TEST_PROJECT opencode /models

Những lưu ý khi cấu hình thủ công

Chỉ chỉnh sửa tệp cấu hình khi tài liệu của nhà cung cấp nêu rõ trường Provider của OpenCode, vị trí điền Base URL và Key. Các trường có thể khác nhau giữa các phiên bản, không sao chép trực tiếp ví dụ JSON từ các công cụ khác vào OpenCode.

Mục cần kiểm tra	Mô tả
Loại Provider	Không trộn lẫn các giao thức OpenAI, Claude, Gemini hoặc các giao thức khác
Base URL	Sử dụng địa chỉ đầy đủ do nhà cung cấp cung cấp cho OpenCode hoặc giao thức tương ứng
Key	Sử dụng Key tương ứng với Provider hiện tại
Tên mô hình	Sao chép danh sách mô hình từ trang quản trị của nhà cung cấp

Cách kiểm tra sau khi lưu

Sau khi vào thư mục dự án thử nghiệm, hãy chạy opencode.
Trước tiên dùng /models để xác nhận mô hình vừa cấu hình đã hiển thị.
Sau khi chọn mô hình, hãy gửi 'Please only reply: OpenCode configuration successful'.
Lần đầu tiên, không nên để nó sửa đổi tệp; chỉ yêu cầu nó giải thích thư mục hiện tại hoặc tệp hiện tại.
Nếu thất bại, trước tiên hãy quay lại /connect hoặc đối chiếu provider, base URL, key và tên mô hình theo tài liệu của nhà cung cấp.

Hiện tượng	Ưu tiên kiểm tra	Cách xử lý
Trong `/models` không có mô hình nào	Provider đã lưu thành công chưa, có thể lấy được danh sách mô hình không	Thêm thủ công ID mô hình / tên mô hình từ trang quản trị nhà cung cấp
Kết nối thất bại	Base URL có thuộc giao thức của Provider hiện tại không	Không trộn lẫn địa chỉ của Claude, Gemini và OpenAI
Tệp cấu hình không hợp lệ	Định dạng JSON, dấu phẩy, dấu ngoặc kép	Ưu tiên dùng trình hướng dẫn kết nối để tạo cấu hình, sau đó mới chỉnh sửa thủ công một số chi tiết nhỏ.

Trang web chính thức OpenCode Xem hướng dẫn cài đặt, xác thực và các lệnh.

Tham khảo cấu hình nhà cung cấp AI cho OpenCode Tham khảo hướng dẫn cấu hình opencode.json.