Cách kết nối Codex, Claude Agent và OpenCode với Devin Desktop qua ACP vào năm 2026

ACP là gì trong 2 phút?#

Vào tháng 8 năm 2025, Zed Industries công bố Agent Client Protocol dưới dạng một đặc tả mở. Đến cuối năm 2025, JetBrains chính thức tham gia phát triển và vào tháng 12 thông báo hỗ trợ trong IDE 25.3 RC. Ý tưởng rất đơn giản: có hàng chục trình biên tập tích hợp AI và hàng chục tác nhân, nhưng trước đây mỗi cặp trình biên tập–tác nhân cần một lớp tích hợp riêng. ACP chuẩn hóa lớp kết nối giữa chúng.

Một phép so sánh phổ biến là ACP dành cho tác nhân AI giống như LSP dành cho máy chủ ngôn ngữ. Khi Microsoft công bố LSP, người ta không còn cần viết một tích hợp VS Code riêng cho Python, một tích hợp khác cho Rust và một tích hợp nữa cho Go. Mỗi ngôn ngữ chạy một máy chủ LSP theo tiêu chuẩn, và bất kỳ trình biên tập nào hỗ trợ LSP đều có thể tích hợp với máy chủ đó.

Tính đến tháng 6 năm 2026, đặc tả đã ổn định ở phiên bản 1. SDK chính thức đã được phát hành cho TypeScript, Python, Rust, Java và Kotlin. Mười hai sản phẩm đã thông báo hỗ trợ ACP trong trình biên tập: Zed (tích hợp sẵn và là bên tạo ra giao thức), JetBrains IDE từ phiên bản 2025.3, VS Code, Neovim, Emacs, marimo và năm sản phẩm chuyên biệt khác. Devin Desktop, trình biên tập của Cognition, là trường hợp riêng: sản phẩm ra mắt ngày 2 tháng 6 năm 2026 và đưa ACP thành một phần cốt lõi trong giao diện ngay từ đầu.

Thông tin về cách làm việc với Ailoot có trong tài liệu.

Cần cài đặt gì trước khi bắt đầu?#

ACP trong Devin Desktop phụ thuộc vào gói đăng ký. Ở gói miễn phí Free, quyền truy cập tác nhân bên thứ ba qua ACP bị tắt. Tài liệu nêu rõ:

Pro có giá $20 mỗi tháng. Mức này đủ cho một người viết mã theo phong cách vibe coding muốn thử thiết lập với ba tác nhân. Max, giá $200 mỗi tháng, chỉ cần thiết nếu bạn chạy Devin Cloud liên tục ở chế độ nền. Teams, giá $80 cho mỗi nhóm cộng thêm $40 cho mỗi thành viên, dành cho các nhóm cần dùng chung Spaces.

Hạn chế chính của ACP trong Devin Desktop hiện nay là trình biên tập không tự tải tác nhân từ registry.

Điều đó có nghĩa là bạn cần tự cài đặt trước cả ba CLI—Codex, Claude và OpenCode. Trình biên tập chỉ nhận diện chúng là các tác nhân có thể kết nối sau khi cài đặt các tệp nhị phân.

Cách cài đặt nhanh nhất trên macOS và Linux:

# Codex CLI từ OpenAI
npm install -g @openai/codex

# Claude Code từ Anthropic (bộ điều hợp ACP được cung cấp bởi bộ điều hợp cộng đồng claude-agent-acp bên dưới)
npm install -g @anthropic-ai/claude-code

# OpenCode (mã nguồn mở)
curl -fsSL https://opencode.ai/install | bash

Sau mỗi lệnh, hãy kiểm tra xem tệp nhị phân có sẵn trong PATH hay không:

codex --version
claude --version
opencode --version

Nếu lệnh không phản hồi, npm có thể đã đặt tệp nhị phân bên ngoài PATH hoặc curl có thể đã thất bại do hết thời gian chờ mạng. Đừng tiếp tục; hãy khắc phục việc cài đặt trước.

Devin Desktop tìm tác nhân ở đâu?#

Cognition giữ nguyên đường dẫn quen thuộc của Windsurf thay vì đổi .windsurf thành .devin. Điều này thuận tiện: các cấu hình cũ của bạn tiếp tục hoạt động như trước.

Một mục cho một tác nhân trong registry trông như sau:

{
  "id": "codex-cli",
  "name": "Codex",
  "version": "0.42.0",
  "description": "OpenAI's coding agent",
  "authors": ["OpenAI"],
  "license": "Apache-2.0",
  "distribution": {
    "binary": {
      "darwin-arm64": {
        "path": "/opt/homebrew/bin/codex",
        "args": ["--acp"]
      },
      "darwin-x64": {
        "path": "/usr/local/bin/codex",
        "args": ["--acp"]
      },
      "linux-x64": {
        "path": "/usr/local/bin/codex",
        "args": ["--acp"]
      },
      "win32-x64": {
        "path": "C:\\Program Files\\codex\\codex.exe",
        "args": ["--acp"]
      }
    }
  }
}

Trường quan trọng là path. Đây là vị trí tệp CLI thực thi trên đĩa của bạn. Nếu cài đặt qua npm, đường dẫn thường là ~/.nvm/.../node/.../bin/codex hoặc /usr/local/bin/codex. Bạn có thể tìm bằng lệnh which codex.

Trường args chỉ định những gì Devin Desktop sẽ thêm vào lệnh khởi chạy. Cần có cờ --acp để khởi chạy CLI ở chế độ máy chủ ACP và giao tiếp với trình biên tập qua JSON-RPC bằng stdin/stdout. Nếu không có cờ này, CLI khởi chạy ở chế độ tương tác thông thường và Devin Desktop sẽ không nhận diện được.

Hãy sao lưu registry.json trước khi chỉnh sửa. Chỉ một tệp JSON sai định dạng ở đây cũng chặn tất cả tác nhân ACP:

cp ~/.windsurf/acp/registry.json ~/.windsurf/acp/registry.json.backup

Sau đó mở tệp bằng trình biên tập và thêm khối tác nhân vào mảng agents.

Kết nối OpenAI Codex CLI#

Bước một: xác thực. Không có xác thực, CLI không thể gọi API:

codex auth login

Lệnh này mở trình duyệt. Nếu bạn có ChatGPT Plus hoặc Team, quá trình xác thực diễn ra qua tài khoản của bạn và không cần khóa API riêng. Nếu không có gói đăng ký ChatGPT, hệ thống sẽ yêu cầu khóa API từ platform.openai.com.

Bước hai: kiểm tra xem công cụ hoạt động ở chế độ thông thường hay không:

codex run "viết hello world bằng python"

Nếu nhận được phản hồi và có mục xuất hiện trong ~/.codex/sessions/, CLI đang hoạt động đúng. Giờ bạn có thể kết nối nó với trình biên tập.

Bước ba: thêm một khối vào ~/.windsurf/acp/registry.json. Dùng cấu trúc từ phần trên và điền path bằng kết quả của which codex:

which codex
# /opt/homebrew/bin/codex

Bước bốn: bật tác nhân trong trình biên tập. Mở bảng lệnh trong Devin Desktop:

• Cmd+Shift+P trên macOS
• Ctrl+Shift+P trên Windows và Linux

Chạy lệnh này từ bảng: Devin User Settings. Trong cửa sổ mở ra, chuyển sang tab Agents. Codex sẽ xuất hiện trong danh sách sau khi bạn chỉnh sửa registry. Bật công tắc bên cạnh nó.

Sau khi kích hoạt, một cột mới sẽ xuất hiện trong Agent Command Center. Bạn có thể giao việc cho cột đó và Codex sẽ hoàn thành.

In the test described here, Codex answered fastest among the three agents—about 8 seconds for the “add logging to this function” task. Claude took 16 seconds for the same task, while OpenCode took 22 seconds.

Codex phù hợp khi:

• Bạn cần mã tiêu chuẩn nhanh chóng, không cần suy luận dài dòng
• Bạn đang tạo bộ khung bằng script và muốn thực hiện nhiều chỉnh sửa nhỏ liên tiếp
• Bạn làm theo một đặc tả có sẵn và giải pháp đã rõ ràng

Codex không phù hợp khi:

• Nhiệm vụ kiến trúc phức tạp có nhiều đánh đổi: Codex thường đi đường tắt
• Mã nhạy cảm về pháp lý cần câu trả lời cân bằng: Claude là lựa chọn tốt hơn
• Bạn quen tinh chỉnh prompt và dùng các quy tắc riêng: công cụ của Claude linh hoạt hơn

Kết nối Claude Agent của Anthropic#

Anthropic chưa phát hành tệp nhị phân ACP của riêng mình với tên “Claude Agent”. Devin Desktop dùng cùng Claude Code thông thường, nhưng thông qua một lớp chuyển tiếp: bộ điều hợp claude-agent-acp từ kho lưu trữ của giao thức, được cấp phép theo Apache 2.0.

Bước một: xác thực Claude Code:

claude auth login

Nếu bạn có gói đăng ký Claude Pro hoặc Max, quá trình xác thực diễn ra qua tài khoản của bạn. Nếu không, hệ thống sẽ yêu cầu khóa API từ console.anthropic.com.

Bước hai: kiểm tra:

claude "viết lại hàm này để trả về Result<T, E>"

Nếu CLI phản hồi, bạn có thể cài đặt bộ điều hợp và kết nối nó với trình biên tập.

Bước ba: cài đặt bộ điều hợp:

npm install -g @agentclientprotocol/claude-agent-acp

Bước bốn: thêm một khối vào registry.json. Trường path trỏ đến tệp nhị phân của bộ điều hợp, không phải chính claude:

{
  "id": "claude-agent",
  "name": "Claude Agent",
  "version": "0.4.0",
  "description": "Anthropic's coding agent (community ACP adapter)",
  "authors": ["Anthropic", "ACP community"],
  "license": "Apache-2.0",
  "distribution": {
    "binary": {
      "darwin-arm64": {
        "path": "/opt/homebrew/bin/claude-agent-acp",
        "args": []
      }
    }
  }
}

Bước năm: bật công cụ trong Devin Settings, tại tab Agents.

In the tests described here, Claude Agent handled the largest tasks best. For the task “split this 600-line component into three files, preserving all imports and tests,” Codex twice forgot the component rendered in three places. Claude caught everything on the first attempt.

Claude Agent có những nhược điểm giống Claude Code:

• Chậm hơn Codex với các nhiệm vụ đơn giản
• Mỗi lần gọi tốn kém hơn nếu bạn dùng API thay vì gói đăng ký

Bạn muốn thiết lập để một số tác nhân AI cùng làm việc trên nhiệm vụ thay vì biến thành một sở thú các tệp nhị phân? Kết nối chúng là phần kỹ thuật. Điều quan trọng hơn là biết cách phân phối ngữ cảnh để mỗi tác nhân biết những tác nhân khác đã làm gì. Đó là một phần của kỹ thuật ngữ cảnh: một trong ba thành phần của hệ thống—bản sao AI của bạn, Bộ não thứ hai của dự án và kỹ thuật ngữ cảnh cho từng nhiệm vụ. Sau đó, các tác nhân dùng giao thức nào để giao tiếp cũng không còn quan trọng; chúng hoạt động theo cùng một cách.

Kết nối OpenCode: một lựa chọn miễn phí#

OpenCode bắt đầu xuất hiện vào đầu năm 2026 như một lựa chọn mã nguồn mở thay thế Claude Code. Đến tháng 6, kho lưu trữ của dự án đã có hơn 30,000 sao, tài liệu được dịch sang hàng chục ngôn ngữ và có sẵn cấu hình dựng sẵn cho Ollama và vLLM.

Cài đặt bằng script:

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

Kiểm tra:

opencode --version

Tiếp theo, cấu hình mô hình OpenCode sẽ dùng. Để chạy hoàn toàn cục bộ, hãy khởi chạy Ollama và trỏ OpenCode tới Ollama:

opencode config set provider ollama
opencode config set base_url http://localhost:11434
opencode config set model qwen3.5-coder:32b

Tìm hướng dẫn về các công cụ trong tài liệu Ailoot

Sau đó thêm một khối vào registry.json:

{
  "id": "opencode",
  "name": "OpenCode",
  "version": "0.18.1",
  "description": "Open source coding agent",
  "authors": ["OpenCode community"],
  "license": "MIT",
  "distribution": {
    "binary": {
      "darwin-arm64": {
        "path": "/usr/local/bin/opencode",
        "args": ["acp"]
      }
    }
  }
}

Bật công cụ trong Devin Settings. Xong.

In the tests described here, OpenCode on Qwen 3.5 Coder responded significantly more slowly than Codex and Claude—an average of 22–25 seconds per task, compared with 8–16 seconds for its competitors. On the other hand, it is free and no team behind it can revoke your access.

OpenCode phù hợp khi:

• Bạn có GPU cục bộ và muốn chạy các nhiệm vụ lập trình ngoại tuyến

• Bạn đang làm dự án học tập và chưa muốn chi tiền cho API

• Bạn muốn so sánh mức độ tụt hậu của các mô hình mã nguồn mở so với mô hình đóng

OpenCode không phù hợp khi:

• Bạn cần chất lượng gần với Claude; các mô hình mã nguồn mở vẫn chưa bắt kịp
• Nhiệm vụ kiến trúc lớn với ngữ cảnh 50K+ token; các mô hình cục bộ thường mất dấu vấn đề
• Tốc độ là yếu tố then chốt; ngay cả trên 4090, OpenCode vẫn chậm hơn Codex chạy trên đám mây

Spaces: chia sẻ ngữ cảnh giữa các tác nhân#

Trước đây, mỗi tác nhân trong Windsurf hoạt động trong phiên riêng. Bạn khởi chạy Cascade rồi đến Codex, và chúng không biết về nhau. Cognition giải quyết điều này bằng Spaces.

Trong một Space, các tác nhân có thể xem:

• Thay đổi tệp do các tác nhân khác thực hiện
• Lịch sử các nhiệm vụ và quyết định gần đây
• Ngữ cảnh prompt dùng chung (ví dụ: CLAUDE.md hoặc AGENTS.md của bạn)
• Các pull request đang xử lý và bình luận của chúng

Cách tạo Space:

1. Mở Agent Command Center (nút trên thanh trên cùng của Devin Desktop)
2. Nhấp “New Space” ở góc trên bên phải
3. Liên kết thư mục dự án với Space
4. Thêm các tác nhân cần thiết trong số những tác nhân đã bật trong Settings

Quy trình làm việc với thiết lập gồm ba tác nhân:

1. Codex viết bản nháp triển khai đầu tiên trong Space
2. Claude Agent xem những gì Codex đã làm rồi rà soát mã, tái cấu trúc và dọn dẹp các phần phức tạp
3. OpenCode viết bài kiểm thử cho phiên bản cuối

Cả ba cùng dùng một AGENTS.md (tệp quy tắc dự án dùng chung) và cùng một tệp nhiệm vụ. Bạn không cần lặp lại ngữ cảnh.

Tests across three projects showed two things. First, the time from starting a task to completing a PR fell by about a third because the agents did not need to repeat information to each other. Second, more manual intervention was needed because Codex and Claude sometimes took the code in different directions. It is a good idea to write a precise AGENTS.md.

Nếu bạn chưa có AGENTS.md riêng, hãy xem hướng dẫn cách dùng AGENTS.md và CLAUDE.md cùng nhau: hướng dẫn này mô tả một tệp chỉ dẫn duy nhất mà cả ba tác nhân cùng đọc.

Khi nào nên dùng từng tác nhân?#

Mẫu 1. Một tính năng tiêu chuẩn trong 30 phút

CRUD cho bảng mới, biểu mẫu có hai trường, trang web đơn giản. Chọn Codex. Công cụ sẽ viết xong trong 5 phút, rồi bạn có thể rà soát và triển khai. Claude sẽ mất quá nhiều thời gian suy nghĩ. OpenCode sẽ không đủ nhanh.

Mẫu 2. Nhiệm vụ kiến trúc có nhiều đánh đổi

Bạn cần quyết định có nên tách phần này thành một dịch vụ riêng hay giữ lại trong monolith. Hoặc chọn giữa Redux và Zustand cho một dự án hiện có. Chọn Claude. Công cụ có thể cân nhắc các lập luận. Codex sẽ đưa ra một “giải pháp” mà không thảo luận, và rất có thể giải pháp đó sai.

Mẫu 3. Bổ sung độ bao phủ kiểm thử cho mã đã viết

Sau khi một tác nhân viết mã, hãy chuyển sang Claude hoặc OpenCode để viết bài kiểm thử. Codex không nhạy với việc trường hợp biên nào quan trọng. Claude giỏi hơn các tác nhân khác trong việc kiểm thử logic nghiệp vụ phức tạp, còn OpenCode viết tốt các bài kiểm thử tích hợp API.

Mẫu 4. Phát triển cục bộ ngoại tuyến

Trên máy bay, tàu hỏa, hoặc ở nhà nghỉ không có Internet. Codex và Claude không hoạt động—chúng cần API. OpenCode với Ollama và một mô hình cục bộ là lựa chọn duy nhất. Chất lượng thấp hơn, nhưng bạn vẫn có thể viết mã.

Mẫu 5. So sánh ba câu trả lời

Khi chưa chắc cách tiếp cận nào đúng, hãy giao cùng một nhiệm vụ cho cả ba tác nhân thông qua Spaces. So sánh ba câu trả lời rồi chọn phương án tốt nhất hoặc kết hợp chúng. Cách này tốn thêm token nhưng hữu ích với các nhiệm vụ quan trọng.

In the working rhythm described here, 60% of tasks are assigned to Codex (speed), 30% to Claude (quality), and 10% to OpenCode (offline). In this example, all three are launched in Spaces each week for a difficult task to compare their suggestions.

Các gói Devin Desktop và đăng ký tác nhân#

Sau khi trả phí cho Devin Desktop, mỗi tác nhân ACP cần gói đăng ký riêng:

• Codex — ChatGPT Plus hoặc Team (từ $20), hoặc khóa API OpenAI tính phí theo mức sử dụng
• Claude Agent — Claude Pro ($20) hoặc Max, hoặc khóa API Anthropic.
• OpenCode — miễn phí khi dùng mô hình cục bộ qua Ollama.

Nguyên tắc tối thiểu về đạo đức là không chia sẻ tài khoản cho nhiều người; một tài khoản được đăng ký cho một người.

Tính đến tháng 6 năm 2026, các gói đăng ký cơ bản cho thiết lập có cả ba tác nhân có tổng chi phí khoảng $60 mỗi tháng: Devin Pro ($20), ChatGPT Plus ($20) và Claude Pro ($20). Nếu rút gọn thiết lập còn Codex và OpenCode, không dùng Claude, chi phí là $40.

ACP khác MCP như thế nào?#

Mọi người thường nhầm lẫn hai giao thức vì cả hai đều là “giao thức dành cho tác nhân” và đều dùng JSON-RPC. Khác biệt nằm ở những gì chúng kết nối.

MCP—Model Context Protocol của Anthropic kết nối tác nhân với nguồn dữ liệu và công cụ. Thông qua máy chủ MCP, tác nhân có thể xem cơ sở dữ liệu của bạn, đọc tệp, gọi GitHub API và truy cập Notion. Tác nhân phân tích dữ liệu đầu vào rồi quyết định dùng công cụ nào.

ACP—Agent Client Protocol của Zed và JetBrains kết nối trình biên tập với tác nhân. Qua ACP, IDE gửi cho tác nhân đoạn mã bạn đã chọn, các tệp bạn đã mở và lệnh bạn chạy từ bảng lệnh. Đổi lại, IDE nhận về các chỉnh sửa tệp, yêu cầu xác nhận và tiến độ nhiệm vụ.

Tác nhân giao tiếp với trình biên tập qua ACP và với các công cụ qua MCP. Cấu trúc như sau:

┌─────────────────┐
│ Devin Desktop   │ ← trình biên tập
└────────┬────────┘
         │ ACP (Apache 2.0, JSON-RPC over stdio)
┌────────▼────────┐
│ Claude Agent    │ ← tác nhân
└────────┬────────┘
         │ MCP (Anthropic, JSON-RPC over HTTP or stdio)
┌────────▼────────┐
│ MCP server      │ ← công cụ (cơ sở dữ liệu, tệp, API)
└─────────────────┘

Để tìm hiểu thêm về MCP, hãy xem hướng dẫn riêng MCP Servers for Claude Code, có ví dụ kết nối bảy máy chủ dựng sẵn.

Điều gì chưa hoạt động vào tháng 6 năm 2026?#

Three notable limitations identified during two weeks of testing:

Registry không tải tác nhân. Như đã đề cập ở đầu hướng dẫn, Devin Desktop yêu cầu bạn tự cài đặt các tệp nhị phân CLI. Có script cài đặt để xử lý việc này, nhưng các hướng dẫn thường quên nhắc đến.

Không phải tính năng nào của trình biên tập cũng được chuyển đến mọi tác nhân. Hiện tại, chức năng chỉnh sửa nhiều tệp trong một giao dịch chỉ hoạt động đầy đủ với Devin Local. Codex và Claude qua ACP nhận lệnh chỉnh sửa từng tệp một. Điều này không cản trở hầu hết nhiệm vụ, nhưng với các lần tái cấu trúc trải rộng trên 5+ tệp trong một thao tác, bạn cần chuyển lại sang Devin Local.

Xung đột khi làm việc song song. Nếu hai tác nhân cùng chỉnh sửa một tệp trong cùng một Space, tác nhân ghi sau sẽ ghi đè phiên bản của tác nhân kia. Devin Desktop hiện chưa hiển thị diff xung đột. Giải pháp là giao cho mỗi tác nhân một tệp khác nhau trong nhiệm vụ, hoặc làm việc qua PR rồi tự xử lý xung đột hợp nhất.

JetBrains ghi nhận các hạn chế beta tương tự trong cách triển khai ACP ở IDE 25.3 RC:

Đây cũng là cách hoạt động của Devin Desktop: tự cài CLI rồi kết nối nó trong trình biên tập.

Hệ sinh thái sẽ phát triển theo hướng nào?#

Hiện nay ACP là một trong những tiêu chuẩn hàng đầu, nhưng không phải tiêu chuẩn duy nhất. Ba tiêu chuẩn đang phát triển song song:

• MCP (Anthropic)—từ tác nhân đến công cụ. Đã trở thành tiêu chuẩn trên thực tế.
• A2A (Google, tháng 4 năm 2025)—từ tác nhân đến tác nhân. Giao tiếp giữa các tác nhân độc lập không cần bộ điều phối trung tâm.
• ACP (Zed, JetBrains, cuối năm 2025)—từ trình biên tập đến tác nhân.

Trong những tháng tới, dự kiến Cursor và Replit Agent cũng sẽ tích hợp ACP vào giao diện của mình. Hiện tại, họ dùng API độc quyền. Khi hai đối thủ lớn áp dụng ACP, tiêu chuẩn này sẽ trở thành chuẩn chung. Khi đó, “tác nhân của bạn trong mọi trình biên tập” sẽ trở thành thông lệ.

Với người viết mã theo phong cách vibe coding, điều này có hai ý nghĩa. Thứ nhất, bạn không cần cài năm ứng dụng khác nhau để thử mô hình mới. Thứ hai, nếu ngày mai một nhà cung cấp thay đổi mô hình định giá hoặc ngừng hoạt động, bạn có thể chuyển tác nhân của họ sang bất kỳ trình biên tập ACP nào và tiếp tục làm việc.

Thiết lập bộ ba tác nhân là phần kỹ thuật. Hiểu cách các lựa chọn kỹ thuật ảnh hưởng đến sản phẩm của bạn là một kỹ năng khác. Nhiệm vụ chính là xây dựng một hệ thống trong đó AI tái tạo phong cách tư duy của bạn (bản sao AI), ghi nhớ ngữ cảnh dự án (Bộ não thứ hai) và đọc các quy tắc nhiệm vụ (kỹ thuật ngữ cảnh). Ba thành phần này tạo nên một hệ thống hoạt động hiệu quả. Sau đó, bạn có thể đổi công cụ chỉ trong một buổi tối.

Hãy tìm hiểu Ailoot.