Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Hướng dẫn cấu hình OpenCode

Hướng dẫn cài đặt và chuyển đổi model cho OpenCode, áp dụng cho cả terminal và desktop.

Tình huống phù hợp: OpenCode là công cụ lập trình AI mã nguồn mở, hỗ trợ dùng trên terminal và desktop. Bài này được sắp xếp theo trình tự “cài OpenCode → cấu hình model Guishu Token → chuyển model trên terminal/desktop → xác minh”.

Mục cấu hìnhGiá trị khuyến nghịGiải thích
Base URLhttps://api.llm-token.cn/v1Ưu tiên dùng đường dẫn gốc có /v1, nếu báo lỗi thì bỏ phần đó đi
API Keysk-xxxxxxxxĐiền đầy đủ Guishu Token Key của bạn.
Model IDĐầy đủ tên model trong danh sách modelPhải khớp từng ký tự.

I. Cài đặt OpenCode

Chọn một trong các cách sau để cài đặt. Sau khi cài xong, chỉ cần gõ opencode trong terminal và khởi chạy được là đủ.

Hệ thống / Cách thứcLệnh
npm
npm install -g opencode-ai
macOS / Linux Homebrew
brew install anomalyco/tap/opencode
Script cài đặt
curl -fsSL https://opencode.ai/install | bash

Khuyến nghị tải bản desktop từ trang chính thức: https://opencode.ai/. Bản dòng lệnh và bản desktop có thể dùng chung một bộ cấu hình model.

II. Dùng CC Switch để thêm nhà cung cấp Guishu Token

Nếu bạn đã quen dùng CC Switch, có thể làm theo ảnh chụp màn hình dưới đây để thêm nhà cung cấp tùy chỉnh.

  1. Mở CC Switch, chú ý vị trí vào và chọn thêm nhà cung cấp tùy chỉnh.
  2. Điền tên nhà cung cấp, ví dụ “Guishu Token”.
  3. Điền Base URL là https://api.llm-token.cn/v1.
  4. Điền API Key bằng Key đầy đủ của bạn.
  5. Điền Model ID bằng đầy đủ tên model trong danh sách model.

Hình ảnh hiển thị giao diện CC Switch trong terminal OpenCode. Phía trên giao diện có nhãn “CC Switch” cùng nhiều biểu tượng. Ở giữa màn hình có dòng nhắc “chưa thêm bất kỳ nhà cung cấp nào”, kèm các nút “nhập cấu hình hiện tại” và “thêm nhà cung cấp”. Mũi tên đỏ trong hình chỉ vào biểu tượng dấu “+” ở góc trên bên phải giao diện. Hình này liên quan tới bước “chuyển đổi model trong terminal” trong tài liệu, tương ứng với bước 4 chọn model vừa cấu hình sau khi kéo xuống danh sách model tùy chỉnh. Nó thể hiện trực quan vị trí để thêm nhà cung cấp trong giao diện terminal.Hình ảnh hiển thị giao diện CC Switch trong terminal OpenCode. Phía trên…

Hình ảnh hiển thị giao diện thêm nhà cung cấp mới khi chuyển model trong terminal của OpenCode. Trong giao diện có nhiều ô nhập như tên nhà cung cấp, API Key, Base URL, tất cả đều được mũi tên đỏ chỉ vào những nội dung cần điền, lần lượt tương ứng với “my - provider”, API Key, Base URL và các thông tin khác trong bước “thêm nhà cung cấp mới”. Ngoài ra, bên dưới giao diện còn có nút “thêm model”, cho biết bạn có thể thêm model muốn sử dụng. Hình ảnh này thể hiện trực quan giao diện thao tác và các mục nhập quan trọng khi thêm nhà cung cấp trong bước chuyển model trên terminal.Hình ảnh hiển thị giao diện thêm nhà cung cấp mới khi chuyển model trong…

III. Chuyển model trong terminal

  1. Mở terminal và chạy opencode.
  2. Sau khi vào OpenCode, nhấn Ctrl + P.
  3. Tìm Switch Model rồi nhấn Enter.
  4. Kéo xuống danh sách model tùy chỉnh và chọn model bạn vừa cấu hình.
opencode

Đây là ảnh chụp giao diện terminal của phần mềm OpenCode. Phía trên giao diện hiển thị các nhãn liên quan tới “OpenCode”; trong ô nhập có câu gợi ý “Ask anything... 'Fix a TODO in the codebase'”. Giao diện cũng hiển thị rõ model hiện đang chọn là “GPT-5.5 OpenAI”, cùng các nội dung gợi ý thao tác như “Tip:/themes or Ctrl+X T to switch between 33 built-in themes”, và ở góc dưới bên phải có số phiên bản “1.14.30”. Giao diện này tương ứng với ngữ cảnh thao tác chuyển model trong terminal của tài liệu, là màn hình mà người dùng có thể thực hiện đổi model sau khi vào OpenCode.Đây là ảnh chụp giao diện terminal của phần mềm OpenCode. Phía trên giao…

Ctrl + P

Hình ảnh hiển thị giao diện terminal của OpenCode với dấu nhắc lệnh và một phần mã. Trên màn hình có một menu lệnh bật lên, trong đó lệnh “Switch model” được tô sáng màu cam, và ở bên phải tương ứng với phím tắt “ctrl+x m”. Hình này liên quan tới mục “Ba, chuyển model trong terminal” của tài liệu, dùng để thể hiện trực quan giao diện khi tìm lệnh “Switch Model” rồi nhấn Enter trong terminal, giúp người dùng hiểu thao tác chuyển model trong terminal.Hình ảnh hiển thị giao diện terminal của OpenCode với dấu nhắc lệnh và m…

Hình ảnh này là giao diện terminal của công cụ OpenCode, hiển thị trang chọn model với tiêu đề “Select model”. Trang này bao gồm nhiều lựa chọn model tích hợp sẵn, phía dưới còn có mục “custom” và tùy chọn model tùy chỉnh “gpt-5.5”; mục này được tô sáng màu cam để thể hiện đang được chọn. Phần đáy giao diện còn hiển thị các phím tắt thao tác như Connect provider tương ứng ctrl+a, Favorite tương ứng ctrl+f. Hình này tương ứng với bước kéo xuống danh sách model tùy chỉnh và chọn model đã cấu hình trong hướng dẫn chuyển model ở terminal.Hình ảnh này là giao diện terminal của công cụ OpenCode, hiển thị trang…

IV. Sử dụng trên desktop

Mở OpenCode bản desktop, tìm model đã cấu hình trong CC Switch tại vị trí chọn model, chọn xong là có thể bắt đầu sử dụng.

Hình ảnh này hiển thị giao diện thao tác của OpenCode bản desktop với phong cách tổng thể nền tối. Khu vực bên trái hiển thị nội dung liên quan tới “xây dựng bất cứ thứ gì”, trong đó mục “Big Pickle” ở phía dưới được mũi tên đỏ nhấn mạnh rõ ràng; khu vực bên phải hiển thị các tùy chọn chức năng liên quan tới “tạo kho Git”. Hình này tương ứng với phần sử dụng trên desktop trong tài liệu, dùng để minh họa vị trí thao tác quan trọng trên giao diện OpenCode bản desktop, hỗ trợ người dùng cấu hình ở phần này.Hình ảnh này hiển thị giao diện thao tác của OpenCode bản desktop với ph…

Hình ảnh này cho thấy giao diện thao tác của OpenCode bản desktop, dùng để hướng dẫn người dùng thêm model tùy chỉnh. Khu vực chọn model ở bên trái đã mở menu thả xuống, hiển thị các tùy chọn như GPT-4 nano, GPT-4.5, trong đó mũi tên đỏ chỉ vào mục “gpt-5.5”. Ở giữa giao diện có dòng gợi ý màu xanh nổi bật, cho biết sau đó có thể nhấn vào khu vực tương ứng để thêm model lớn, và khi thêm cần chọn model tùy chỉnh. Hình này liên quan tới phần sử dụng trên desktop, là ảnh hướng dẫn thao tác để giúp người dùng hoàn tất bước thêm model quan trọng.Hình ảnh này cho thấy giao diện thao tác của OpenCode bản desktop, dùng…

V. Xác minh và câu hỏi thường gặp

Hiện tượngCách xử lý
Không khởi động được opencodeMở lại terminal và xác nhận đường dẫn cài đặt của npm / brew đã được thêm vào PATH.
Danh sách model không có model tùy chỉnhXác nhận CC Switch đã được lưu, sau đó khởi động lại OpenCode.
Yêu cầu thất bạiKiểm tra Base URL, API Key, model ID; ưu tiên dùng https://api.llm-token.cn/v1 trước.
Model phản hồi chậmHãy đổi sang model phản hồi nhanh để kiểm tra, ví dụ claude-sonnet-4-6 hoặc MiniMax-M3-highspeed.

Hướng dẫn cấu hình WorkBuddy

Ba yếu tố cốt lõi để kết nối model tùy chỉnh: Base URL, API Key và model ID.

Hướng dẫn cấu hình VS Code

Dùng Guishu Token qua OpenAI Compatible trong VS Code + Cline.

Các mục trên trang này

I. Cài đặt OpenCodeII. Dùng CC Switch để thêm nhà cung cấp Guishu TokenIII. Chuyển model trong terminalIV. Sử dụng trên desktopV. Xác minh và câu hỏi thường gặp