Hướng dẫn tích hợp OpenCode: Cách truy cập Claude 4.5, GPT-5.2 & Gemini 3 Pro qua API EvoLink (2026)

Lưu ý: Bài viết này được đăng lại từ Blog chính thức của EvoLink.

Giới thiệu: Kỷ nguyên mới của AI dựa trên Terminal

Trong bối cảnh phát triển nhanh chóng của năm 2026, terminal của nhà phát triển đã chuyển đổi từ một dòng lệnh đơn giản thành một trung tâm chỉ huy tinh vi cho Trí tuệ Nhân tạo. Những ngày chuyển đổi ngữ cảnh giữa IDE, chatbot dựa trên trình duyệt và tài liệu API đã qua. Ngày nay, các nhà phát triển hiệu quả nhất đang tích hợp các tác nhân AI trực tiếp vào quy trình làm việc CLI của họ.

Tuy nhiên, một thách thức mới đã xuất hiện: Sự phân mảnh mô hình. Bạn cần Claude 4.5 cho khả năng viết mã vượt trội, GPT-5.2 cho lý luận phức tạp và Gemini 3 Pro cho cửa sổ ngữ cảnh khổng lồ của nó. Việc quản lý ba đăng ký và khóa API riêng biệt là không hiệu quả và tốn kém.

Hướng dẫn này trình bày giải pháp tối ưu: Tích hợp OpenCode, tác nhân mã hóa terminal mã nguồn mở hàng đầu, với EvoLink, cổng API thống nhất. Bằng cách làm theo hướng dẫn "nhà chọc trời" này, bạn sẽ học cách xây dựng một môi trường phát triển mạnh mẽ, tiết kiệm chi phí, cung cấp cho bạn quyền truy cập theo yêu cầu vào các mô hình AI tốt nhất thế giới — tiết kiệm tới 70% chi phí API trong khi tăng tốc độ viết mã của bạn.

Phần 1: Các thành phần trong AI Stack của bạn

OpenCode là gì?

OpenCode là một công cụ lập trình dòng lệnh (CLI) mã nguồn mở dựa trên Go đã gây bão cộng đồng nhà phát triển, thu về hơn 45.000 sao trên GitHub. Không giống như các tiện ích mở rộng tự động hoàn thành tiêu chuẩn, OpenCode hoạt động như một tác nhân tự trị. Nó có Giao diện Người dùng Terminal (TUI) hiện đại cho phép bạn:

• Trò chuyện với cơ sở mã của bạn bằng ngôn ngữ tự nhiên.
• Thực hiện các lệnh terminal một cách tự chủ (với sự cho phép).
• Chỉnh sửa các tệp trên toàn bộ cấu trúc dự án của bạn.
• Gỡ lỗi bằng cách đọc dấu vết ngăn xếp trực tiếp từ đầu ra.

Sức mạnh thực sự của nó nằm ở thiết kế bất khả tri với nhà cung cấp. OpenCode không buộc bạn phải sử dụng một mô hình cụ thể; nó hoạt động như một vật chứa cho bất kỳ trí thông minh nào bạn chọn để cắm vào.

EvoLink là gì?

EvoLink là lớp cơ sở hạ tầng cung cấp năng lượng cho thiết lập này. Nó là một cổng API thông minh tập hợp hơn 40 mô hình AI chính thống vào một giao diện duy nhất.

• Truy cập thống nhất: Một khóa API cung cấp cho bạn quyền truy cập vào các mô hình từ OpenAI, Anthropic, Google, Alibaba và ByteDance.
• Hiệu quả chi phí: Thông qua Smart Routing, EvoLink tự động định tuyến các yêu cầu đến nhà cung cấp hiệu quả nhất về chi phí cho một mô hình cụ thể, mang lại mức tiết kiệm 20-70% so với việc sử dụng trực tiếp nhà cung cấp.
• Độ tin cậy: Với kiến trúc tác vụ không đồng bộ và tự động chuyển đổi dự phòng, EvoLink đảm bảo thời gian hoạt động 99,9%, đảm bảo tác nhân mã hóa của bạn không bao giờ bị "treo" trong phiên gỡ lỗi quan trọng.

Phần 2: Tại sao tích hợp OpenCode với EvoLink?

Sự tích hợp giữa OpenCode và EvoLink đại diện cho "Nguyên tắc Nhà chọc trời" của phát triển phần mềm — xây dựng trên nền tảng vững chắc để đạt đến những tầm cao mới.

• Sự linh hoạt của mô hình: Bạn có thể chuyển từ sử dụng Claude 4.5 Opus để viết các lớp phức tạp sang Gemini 3 Pro để phân tích tài liệu PDF dài 500 trang mà không cần thay đổi cấu hình hoặc khóa API.
• Di chuyển Zero-Code: EvoLink hoàn toàn tương thích với định dạng API của OpenAI. Điều này có nghĩa là OpenCode "nghĩ" rằng nó đang nói chuyện với một nhà cung cấp tiêu chuẩn, trong khi EvoLink xử lý việc định tuyến phức tạp ở chế độ nền.
• Luồng thông tin mật độ cao: Bằng cách kết hợp khả năng đọc các tệp cục bộ của OpenCode với quyền truy cập của EvoLink vào các mô hình ngữ cảnh cao, bạn có thể đưa toàn bộ kho lưu trữ vào cửa sổ ngữ cảnh để phân tích.

Phần 3: Hiểu về Bộ ba Mô hình Quyền lực (Phiên bản 2026)

Trước khi cấu hình tích hợp, điều quan trọng là phải hiểu những gì bạn đang tích hợp. Tính đến đầu năm 2026, ba mô hình đang thống trị cảnh quan. Thông qua EvoLink, bạn có quyền truy cập vào tất cả chúng.

1. Claude 4.5 (Sonnet & Opus) - Kiến trúc sư Mã nguồn

• Tốt nhất cho: Viết mã sạch, dễ bảo trì, cấu trúc lại và lập kế hoạch kiến trúc.
• Số liệu thống kê: Claude 4.5 Opus giữ vương miện trên bảng xếp hạng SWE-bench Verified với điểm số 80,9%, nghĩa là nó giải quyết các vấn đề GitHub thực tế tốt hơn bất kỳ mô hình nào khác.
• Tại sao sử dụng trong OpenCode: Nó tạo ra cấu trúc mã "giống con người" nhất và ít có xu hướng ảo giác các thư viện không tồn tại. Nó vượt trội trong việc làm theo các hướng dẫn phức tạp, gồm nhiều bước.

2. GPT-5.2 - Động cơ Suy luận

• Tốt nhất cho: Logic phức tạp, thuật toán toán học và "suy nghĩ thấu đáo" về các lỗi khó hiểu.
• Số liệu thống kê: GPT-5.2 đạt điểm tuyệt đối 100% trên điểm chuẩn AIME 2025 (toán học) và 52,9% trên ARC-AGI-2, vượt xa các đối thủ cạnh tranh về suy luận trừu tượng.
• Tại sao sử dụng trong OpenCode: Khi bạn bị mắc kẹt trong một lỗi logic bất chấp sự giải thích, hoặc cần tạo các biểu thức chính quy phức tạp hoặc các truy vấn SQL, GPT-5.2 là sự lựa chọn vượt trội.

3. Gemini 3 Pro - Vua Ngữ cảnh & Đa phương thức

• Tốt nhất cho: Phân tích các cơ sở mã khổng lồ, đọc hình ảnh tài liệu và lặp lại tốc độ cao.
• Số liệu thống kê: Tự hào có cửa sổ ngữ cảnh khổng lồ 1 Triệu Token và tốc độ hàng đầu trong ngành (khoảng 180 token/giây).
• Tại sao sử dụng trong OpenCode: Sử dụng Gemini 3 Pro khi bạn cần đưa toàn bộ thư mục dự án của mình vào lời nhắc để kiểm tra tính nhất quán toàn cầu. Đây cũng là tùy chọn hiệu quả nhất về chi phí cho các tác vụ khối lượng lớn.

Phần 4: Hướng dẫn tích hợp từng bước

Hướng dẫn này giả định bạn đang làm việc trong môi trường giống Unix (macOS/Linux) hoặc WSL cho Windows.

Điều kiện tiên quyết

1. Trình giả lập Terminal: iTerm2 (macOS), Windows Terminal hoặc Hyper.
2. Tài khoản EvoLink: Một tài khoản hợp lệ tại evolink.ai.
3. Git: Đã cài đặt trên máy của bạn.

Bước 1: Cài đặt OpenCode

Nếu bạn chưa cài đặt OpenCode, hãy chạy lệnh sau trong terminal của bạn. Tập lệnh này tự động phát hiện hệ điều hành của bạn và cài đặt các tệp nhị phân cần thiết.

curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/main/install | bash

Xác minh cài đặt:

opencode --version

Bước 2: Nhận Khóa API EvoLink của bạn

1. Đăng nhập vào Bảng điều khiển EvoLink.
2. Điều hướng đến phần API Keys.
3. Nhấp vào Create New Key.
4. Sao chép chuỗi khóa (bắt đầu bằng sk-evo...). Không chia sẻ khóa này.

Bước 2.5: Khởi tạo Nhà cung cấp OpenCode

Trước khi định cấu hình tệp JSON, bạn cần đăng ký EvoLink làm nhà cung cấp tùy chỉnh trong trình quản lý thông tin xác thực của OpenCode. Đây là thiết lập một lần cho phép OpenCode nhận ra EvoLink là một nhà cung cấp hợp lệ.

1. Khởi chạy OpenCode lần đầu tiên:

opencode

2. Khi OpenCode khởi động, nó sẽ nhắc bạn kết nối một nhà cung cấp. Trong danh sách nhà cung cấp, cuộn xuống và chọn other (bạn có thể tìm kiếm bằng cách nhập).

3. Nhập ID Nhà cung cấp: Khi được nhắc, nhập evolink làm mã định danh nhà cung cấp. Điều này tạo ra một mục nhập nhà cung cấp tùy chỉnh trong hệ thống của OpenCode.

4. Nhập Khóa API: Bạn có thể nhập bất kỳ giá trị giữ chỗ nào ở đây (ví dụ: admin hoặc temp). Khóa API EvoLink thực tế sẽ được tham chiếu thông qua tệp cấu hình trong bước tiếp theo.

Quan trọng: Bước khởi tạo này đăng ký evolink trong trình quản lý thông tin xác thực cục bộ của OpenCode. Tệp cấu hình chúng ta tạo tiếp theo sẽ cung cấp các chi tiết kết nối thực tế.

Bước 3: Định cấu hình OpenCode

1. Xác định vị trí/Tạo thư mục cấu hình:

   • macOS/Linux: ~/.config/opencode/
   • Windows: %AppData%\opencode\

   Đối với người dùng Windows: Nhấn Win + R, dán %AppData%\opencode\ và nhấn Enter để mở thư mục:

   

2. Tạo tệp opencode.json:

mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json

3. Dán cấu hình sau:
   Lưu ý: Thay thế YOUR_EVOLINK_API_KEY bằng khóa bạn đã tạo ở Bước 2.

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "evolink": {
            "npm": "@ai-sdk/anthropic",
            "name": "Evolink",
            "options": {
                "baseURL": "https://code.evolink.ai/v1",
                "apiKey": "your-evolink-api-key"
            },
            "models": {
                "claude-opus-4-5-20251101": {
                    "name": "Claude-4.5-Opus"
                },
                "claude-sonnet-4-5-20250929": {
                    "name": "Claude-4.5-Sonnet"
                },
                "claude-haiku-4-5-20251001": {
                    "name": "Claude-4.5-Haiku"
                }
            }
        }
    }
}

Lưu ý kỹ thuật: Mặc dù chúng ta đang sử dụng các mô hình Claude và Gemini, chúng ta đặt provider thành "openai" trong JSON. Điều này là do EvoLink dịch liền mạch định dạng API OpenAI sang các định dạng gốc của Anthropic và Google. "Thủ thuật" này cho phép OpenCode giao tiếp với các mô hình không phải GPT bằng các giao thức tiêu chuẩn.

Bước 4: Xác minh kết nối

Khởi chạy OpenCode trong terminal của bạn:

opencode

Trong hộp nhập liệu, hãy nhập:

"Hello, which model are you and who is your provider?"

Nếu được định cấu hình chính xác, phản hồi sẽ xác nhận mô hình bạn đã xác định (ví dụ: "I am GPT-5.2...").

Phần 5: Cấu hình nâng cao & Chuyển đổi mô hình

Khi đã vào trong OpenCode, bạn không bị khóa ở một mô hình duy nhất. Bạn có thể chuyển đổi các mô hình một cách linh hoạt dựa trên nhiệm vụ hiện tại.

Chuyển đổi mô hình qua CLI

Bạn có thể chỉ định mô hình trực tiếp khi khởi chạy công cụ:

# Để kiểm tra logic nhanh
opencode --model gpt-5.2

# Cho một phiên viết mã nặng
opencode --model claude-3-5-sonnet-20240620

Chuyển đổi mô hình qua TUI

Trong giao diện OpenCode, bạn có thể sử dụng lệnh /models để xem các cấu hình có sẵn.

1. Gõ /models và nhấn Enter.
2. Chọn ID mô hình từ danh sách opencode.json của bạn.
3. Nhấn Enter để chuyển đổi ngữ cảnh ngay lập tức.

Phần 6: Các phương pháp hay nhất cho phát triển mật độ cao

Để thực sự tận dụng tiềm năng "Nhà chọc trời" của sự tích hợp này, hãy tuân theo các phương pháp hay nhất sau:

1. Chiến lược ngữ cảnh

• Khi sử dụng Gemini 3 Pro: Đừng ngần ngại chạy các lệnh như /add src/ để thêm toàn bộ thư mục nguồn của bạn. Cửa sổ ngữ cảnh 1 Triệu của Gemini có thể xử lý tải, cho phép nó hiểu toàn bộ biểu đồ phụ thuộc dự án của bạn.
• Khi sử dụng GPT-5.2: Hãy chọn lọc hơn. Chỉ thêm các tệp có liên quan (/add src/utils/helper.ts) để đảm bảo động cơ suy luận tập trung nghiêm ngặt vào logic hiện tại mà không bị phân tâm.

2. Định tuyến thông minh để kiểm soát chi phí

Smart Routing của EvoLink hoạt động theo mặc định. Tuy nhiên, bạn có thể tối ưu hóa hơn nữa bằng cách sử dụng các phiên bản "Turbo" hoặc "Flash" của các mô hình cho các tác vụ đơn giản.

• Định cấu hình mục nhập gpt-4o-mini hoặc gemini-3-flash trong opencode.json của bạn để viết các bài kiểm tra đơn vị hoặc nhận xét đơn giản. Các mô hình này có chi phí chỉ bằng một phần nhỏ so với các mô hình biên giới nhưng đủ cho các tác vụ cơ bản.

3. An toàn là trên hết

Không bao giờ commit tệp opencode.json của bạn vào kho lưu trữ công khai. Thêm .config/opencode/ vào tệp .gitignore global của bạn.

echo ".config/opencode/" >> ~/.gitignore_global
git config --global core.excludesfile ~/.gitignore_global

Phần 7: Khắc phục sự cố thường gặp

H: Tôi nhận được Lỗi 401 Unauthorized.

• Khắc phục: Kiểm tra khóa API EvoLink của bạn. Đảm bảo bạn đã sao chép chuỗi đầy đủ sk-evo.... Ngoài ra, hãy xác minh rằng bạn có số dư tín dụng dương trong tài khoản EvoLink của mình.

H: OpenCode báo "Model not found".

• Khắc phục: Đảm bảo tên model trong JSON của bạn khớp chính xác với ID mô hình được EvoLink hỗ trợ (ví dụ: gpt-4o, claude-3-opus-20240229). Kiểm tra Danh sách mô hình EvoLink để biết chuỗi ID chính xác.

H: Phản hồi đang phát trực tuyến rất chậm.

• Khắc phục: Mặc dù EvoLink nhanh, độ trễ mạng sẽ thay đổi. Kiểm tra xem bạn có đang sử dụng một mô hình rất lớn (như Opus) cho một truy vấn đơn giản hay không. Chuyển sang gpt-5.2 hoặc gemini-3-flash để tương tác nhanh hơn.

Kết luận

Bằng cách tích hợp OpenCode với EvoLink, bạn đã xây dựng một môi trường phát triển tuân thủ các tiêu chuẩn cao nhất về hiệu quả và sức mạnh. Bạn không còn bị hạn chế bởi các giới hạn của một nhà cung cấp AI duy nhất. Thay vào đó, bạn có một trung tâm chỉ huy điều phối các mô hình thông minh nhất thế giới — Claude cho kiến trúc, GPT cho suy luận và Gemini cho ngữ cảnh — tất cả thông qua một đường ống hiệu quả về chi phí.

Sẵn sàng nâng cấp terminal của bạn chưa?

1. Nhận Khóa API của bạn từ EvoLink
2. Tải xuống OpenCode
3. Bắt đầu viết mã với tương lai ngay hôm nay.