Làm Chủ OpenCode: Hướng Dẫn Toàn Diện Về Lập Trình AI Ưu Tiên Cục Bộ (Local-First)

OpenCode không chỉ là một trợ lý lập trình AI khác. Nó là một tác nhân lập trình tự chủ ưu tiên cục bộ (local-first) được thiết kế để hoạt động như một lập trình viên cặp thực thụ. Không giống như các công cụ tự động hoàn thành đơn giản, OpenCode hiểu toàn bộ kho lưu trữ (repository) của bạn, lập kế hoạch tái cấu trúc phức tạp và thực thi các lệnh terminal — tất cả trong khi giữ mã của bạn an toàn trên máy của bạn.

Trong hướng dẫn toàn diện này, chúng tôi sẽ đề cập đến mọi thứ bạn cần biết để đi từ con số 0 đến làm chủ các tính năng tiên tiến nhất của OpenCode.

1. Cài Đặt: Cổng Vào Lập Trình Tự Chủ

Việc bắt đầu được thiết kế để không gặp trở ngại. OpenCode chạy nguyên bản trong terminal của bạn, nghĩa là nó hoạt động ở bất cứ đâu bạn làm việc — cho dù đó là VS Code, JetBrains hay một shell độc lập.

Cài Đặt Nhanh (Mac, Linux, Windows WSL)

Cách nhanh nhất để cài đặt là thông qua tập lệnh chính thức của chúng tôi:

curl -fsSL "https://opencode.ai/install" | bash

Cách Khác: Gói npm

Nếu bạn thích quản lý các công cụ qua Node.js, bạn có thể cài đặt OpenCode trên toàn hệ thống:

npm install -g opencode-ai

Sau khi cài đặt, chỉ cần gõ opencode để xác minh cài đặt và khởi chạy giao diện người dùng.

2. Mô Hình & Nhà Cung Cấp: Lựa Chọn Không Giới Hạn (BYOK)

Một trong những triết lý cốt lõi của OpenCode là Trung Lập Về Mô Hình. Chúng tôi không khóa bạn vào một mô hình "hộp đen" duy nhất. Thay vào đó, chúng tôi cho phép bạn mang theo khóa riêng (BYOK) hoặc kết nối với các đăng ký AI hiện có của bạn.

Xác Thực (Authenticating)

Để kết nối nhà cung cấp mô hình ưa thích của bạn, hãy chạy:

opencode auth login

Lệnh tương tác này sẽ hướng dẫn bạn đăng nhập với:

• Anthropic (Claude 4.5 Sonnet, Opus)
• OpenAI (GPT-5, o1-preview)
• Google (Gemini 3 Pro, 1.5 Pro)
• Models.dev (Truy cập vào hơn 75 mô hình mã nguồn mở & được lưu trữ)

Quản Lý Mô Hình

Bạn có thể chuyển đổi mô hình nhanh chóng tùy thuộc vào nhiệm vụ. Sử dụng mô hình nhanh hơn cho các sửa lỗi đơn giản và mô hình suy luận mạnh hơn cho việc lập kế hoạch kiến trúc.

# Liệt kê tất cả các mô hình có sẵn
opencode models

# Làm mới danh sách mô hình sau khi thêm nhà cung cấp mới
opencode models --refresh

Chạy Cục Bộ với Ollama

Để có quyền riêng tư tối đa và khả năng ngoại tuyến, OpenCode hỗ trợ các mô hình cục bộ thông qua Ollama. Trỏ OpenCode đến phiên bản cục bộ của bạn để lập trình mà không có bất kỳ dữ liệu nào rời khỏi mạng của bạn — hoàn hảo cho môi trường doanh nghiệp hoặc làm việc trên tài sản trí tuệ nhạy cảm.

3. Quy Trình Làm Việc Cốt Lõi: Tương Tác vs. Một Lần

OpenCode thích ứng với cách bạn muốn làm việc.

Phiên Tương Tác (Interactive Session)

Cách mạnh mẽ nhất để sử dụng OpenCode là Phiên Tương Tác. Chạy opencode trong thư mục gốc dự án của bạn để vào môi trường trò chuyện liên tục.

• Nhận Biết Ngữ Cảnh: Tác nhân đọc cấu trúc tệp và tín hiệu LSP của bạn.
• Đa Lượt (Multi-Turn): Bạn có thể tinh chỉnh kế hoạch, yêu cầu sửa lỗi và lặp lại.
• Sử Dụng Công Cụ: Tác nhân có thể đọc tệp, chỉnh sửa mã và chạy thử nghiệm một cách tự chủ.

Lệnh Một Lần (One-Off Command)

Đối với các nhiệm vụ nhanh chóng mà bạn không cần một cuộc trò chuyện đầy đủ, hãy sử dụng opencode run. Điều này hoàn hảo cho các hướng dẫn "bắn và quên" (fire and forget).

# Tóm tắt codebase và đề xuất cải tiến
opencode run "Analyze this codebase and propose a refactoring plan for performance"

# Sửa nhanh
opencode run "Fix the type error in src/utils/helper.ts"

4. Tác Nhân & Quyền: An Toàn Là Trên Hết

Cấp cho AI quyền truy cập vào terminal và hệ thống tệp của bạn đòi hỏi sự tin tưởng. OpenCode giải quyết điều này bằng Hệ Thống Quyền mạnh mẽ và các Tác Nhân chuyên biệt.

Quyền Chi Tiết

Bạn kiểm soát chính xác những gì tác nhân có thể làm. Thiết lập quyền trên toàn hệ thống hoặc theo từng phiên:

• Cho Phép (Allow): Tác nhân thực thi các lệnh và chỉnh sửa tệp tự động.
• Hỏi (Ask): Tác nhân phải yêu cầu sự chấp thuận của bạn cho mọi hành động (mặc định cho các hoạt động nhạy cảm).
• Từ Chối (Deny): Tác nhân bị nghiêm cấm thực hiện hành động.

Tác Nhân Chuyên Biệt: Lập Kế Hoạch vs. Xây Dựng

Để giảm thiểu rủi ro, chúng tôi khuyên bạn nên chia nhỏ quy trình làm việc:

1. Tác Nhân Lập Kế Hoạch (Plan Agent): Sử dụng mô hình "Người Lập Kế Hoạch" để phân tích mã và soạn thảo chiến lược. Giữ tác nhân này ở chế độ Chỉ Đọc hoặc Hỏi.
2. Tác Nhân Xây Dựng (Build Agent): Sau khi kế hoạch được phê duyệt, hãy chuyển sang tác nhân "Người Xây Dựng" với quyền Cho Phép để thực thi các thay đổi nhanh chóng.

5. Tính Năng Nâng Cao: Đa Phiên & Chia Sẻ

Kỹ thuật trong thế giới thực không phải là tuyến tính. OpenCode hỗ trợ các quy trình làm việc nâng cao để phù hợp với nhu cầu đa nhiệm của bạn.

Phiên Song Song

Đừng để việc tái cấu trúc chạy lâu chặn việc sửa lỗi nhanh của bạn. OpenCode cho phép bạn chạy nhiều phiên song song.

• Phiên A: "Tái cấu trúc middleware xác thực."
• Phiên B: "Sửa lỗi CSS z-index trên trang chủ."

Các phiên này hoạt động độc lập, đảm bảo ngữ cảnh không bị lẫn lộn giữa các nhiệm vụ.

Liên Kết Có Thể Chia Sẻ

Cần cho đồng đội xem AI đã làm gì? Sử dụng /share để tạo nhật ký chỉ đọc, chặt chẽ về phiên của bạn.

• Hợp Tác: Gửi liên kết cho người đánh giá PR để họ có thể xem tại sao các thay đổi được thực hiện.
• Tài Liệu: Lưu các phiên thành công làm "công thức" cho các nhiệm vụ trong tương lai.
• Kiểm Soát Quyền Riêng Tư: Chia sẻ bị tắt theo mặc định. Bạn kiểm soát rõ ràng những gì được công bố.

Kết Luận

OpenCode được xây dựng cho các nhà phát triển muốn sức mạnh của AI mà không phải hy sinh quyền kiểm soát hoặc quyền riêng tư. Bằng cách làm chủ các quy trình làm việc này — chọn đúng mô hình, tận dụng quyền chi tiết và sử dụng các phiên song song — bạn có thể biến OpenCode từ một người trợ giúp đơn giản thành một đối tác tự chủ không mệt mỏi.

Sẵn sàng bắt đầu? Cài đặt OpenCode ngay và trải nghiệm tương lai của kỹ thuật ưu tiên cục bộ.