Hướng dẫn cài đặt

Hướng dẫn cài đặt nhà cung cấp

Xem các bước cài đặt và cách khắc phục sự cố theo công cụ.

Cấu hình VS Code

VS Code là một trình biên tập mã nguồn, không phải là nhà cung cấp mô hình. Khi bạn sử dụng Claude, GPT, Gemini hoặc mô hình từ provider trong VS Code, việc này thường được thực hiện thông qua các tiện ích mở rộng như Cline, Continue hoặc GitHub Copilot; nơi thực sự bạn cần nhập Key, Base URL và tên mô hình nằm trong phần cài đặt của tiện ích mở rộng cụ thể đó.

Trước tiên, hãy phân biệt ba khái niệm

VS CodeChỉ là nơi để viết mã, chịu trách nhiệm mở dự án, chỉnh sửa tệp và cài đặt tiện ích mở rộng.
Tiện ích mở rộng AICác tiện ích mở rộng như Cline, Continue, Copilot, v.v., chịu trách nhiệm gửi câu hỏi và ngữ cảnh mã nguồn của bạn tới mô hình rồi hiển thị kết quả phản hồi lại trong VS Code.
Nguồn mô hìnhClaude, GPT, Gemini, các provider AI tương thích OpenAI, mô hình cục bộ, v.v., đều thuộc về nguồn mô hình; việc có sử dụng được hay không phụ thuộc vào tiện ích mở rộng bạn chọn có hỗ trợ hay không.
Vì vậy, trang này không phải là "chỉ có thể cấu hình với Cline / Roo Code." Cách diễn đạt chính xác hơn là: trong VS Code, hãy chọn một tiện ích mở rộng AI, rồi bên trong tiện ích mở rộng đó, chọn Claude, GPT, Gemini hoặc các dịch vụ tương thích với OpenAI.

Cách chọn nguồn mô hình

Bạn muốn sử dụng gì?Thường chọn provider như thế nào?Cách điền Key / Base URLTình huống phù hợp
ClaudeAnthropic / ClaudeĐiền Key của Anthropic; nếu bạn đang dùng provider, hãy làm theo hướng dẫn của provider để chọn OpenAI Compatible hoặc mục tùy chỉnh.Phù hợp cho việc đọc hiểu mã nguồn, sửa đổi mã và hỏi đáp với ngữ cảnh dài.
GPT / OpenAIOpenAINhập OpenAI Key; thông thường bạn không cần đổi Base URL nếu kết nối trực tiếp chính thức, chỉ khi dùng proxy/trung chuyển mới cần điền liên kết API do provider cung cấp.Phù hợp cho việc hỏi đáp chung, giải thích mã và sửa đổi nhỏ.
AI provider / Dịch vụ tổng hợpOpenAI Compatible / Custom ProviderSao chép chính xác Key, Base URL và Model ID theo hiển thị trong trang quản trị của provider; một số Base URL có kèm /v1, số khác thì không, hãy làm theo đúng những gì hiển thị trong trang quản trị.Phù hợp cho người mới bắt đầu cần truy cập thống nhất nhiều mô hình khác nhau.
Gemini / Các mô hình khácGoogle Gemini hoặc Provider tương ứngĐiền Key của nền tảng tương ứng; Base URL chỉ cần điền khi tiện ích mở rộng cung cấp giao diện tùy chỉnh.Phù hợp để so sánh nhiều mô hình, việc có dùng được hay không phụ thuộc vào phiên bản tiện ích mở rộng hiện tại.
GitHub CopilotGitHub / Đăng nhập CopilotThông thường, thay vì điền Key và Base URL, bạn đăng nhập vào tài khoản GitHub của mình và bật các quyền tương ứng.Phù hợp cho những ai chỉ muốn dùng một trợ lý lập trình tiện lợi, đỡ tốn công thiết lập trong hệ sinh thái chính thức của VS Code.

Mục cấu hình và các bước thực hiện

  1. Trước tiên hãy cài đặt VS Code, sau đó mở Extensions Marketplace ở thanh bên trái.
  2. Chọn một tiện ích mở rộng AI: người mới bắt đầu có thể bắt đầu với Cline; nếu bạn đã dùng Continue, bạn có thể tham khảo trang riêng về Continue trên trang này; Roo Code phù hợp hơn cho người dùng có kinh nghiệm và không khuyến nghị người mới cài đặt trước.
  3. Mở cài đặt của tiện ích mở rộng và trước tiên tìm kiếm các mục dạng Provider, Model Provider, API Provider.
  4. Nếu bạn muốn dùng Claude, chọn Anthropic / Claude; nếu muốn dùng GPT, chọn OpenAI; nếu muốn dùng provider, hãy chọn OpenAI Compatible hoặc Custom Provider.
  5. Điền Key. Khi sử dụng nền tảng mô hình chính thức, thường chỉ cần Key chính thức; khi sử dụng provider, cần sao chép cả Key và Base URL từ trang quản trị của provider.
  6. Chọn mô hình hoặc tự điền tên mô hình thủ công. Không tự ý viết lại tên mô hình; hãy điền chính xác theo những gì hiển thị trong trang quản trị của provider.
  7. Đặt các tùy chọn tự động thực thi lệnh, tự động chỉnh sửa tệp và tự động áp dụng thay đổi thành tắt hoặc yêu cầu xác nhận mỗi lần.

Hướng dẫn kiểm tra an toàn

Nên hỏi như thế này trong lần kiểm tra đầu tiên
Read only the currently open file. Do not modify files or run commands. Explain what this code does in beginner-friendly language.
Khi liên quan đến việc thực thi lệnh hoặc sửa đổi tệp, trước tiên hãy xác nhận xem mô hình định làm gì. Người mới bắt đầu không nên bật chế độ hoàn toàn tự động.