Thiết lập agent đầu tiên của bạn

Từ một bản cài đặt mới đến một agent AI đang chạy. Hai phần mà phần lớn người mới bỏ lỡ nằm ngay ở đầu: AgentsRoom liên hệ thế nào với các CLI AI, và cách đăng nhập.

AgentsRoom hoạt động như thế nào (hãy đọc phần này trước)

AgentsRoom là buồng lái. Các AI CLI (Claude, Codex, GitHub Copilot CLI, Cursor và 15 CLI agent khác) là động cơ. Bạn đăng nhập vào các động cơ một lần thông qua lệnh riêng của chúng, sau đó AgentsRoom điều khiển chúng một cách trực quan. AgentsRoom không bao giờ lưu trữ hoặc nhìn thấy token, khóa API hoặc mật khẩu ChatGPT của bạn: những thứ đó được giữ bên trong bộ nhớ bảo mật riêng của từng CLI trên máy của bạn.

Không có nút "Đăng nhập vào ChatGPT" hoặc "Đăng nhập vào Anthropic" bên trong AgentsRoom theo thiết kế. Việc đăng nhập nằm trong CLI bạn cài đặt ở bước 0 dưới đây.

Trước khi bắt đầu

✓Windows 10+, macOS 14+ (Sonoma) hoặc một bản phân phối Linux 64-bit hiện đại
✓
Ít nhất một AI coding CLI được cài đặt (Claude, Codex, GitHub Copilot CLI, Cursor hoặc bất kỳ CLI agent nào trong 15 CLI agent còn lại mà AgentsRoom hỗ trợ)
ví dụ: curl -fsSL https://claude.ai/install.sh | bash
✓Một gói đăng ký đang hoạt động hoặc API key cho nhà cung cấp đã chọn của bạn

Bước 0: cài đặt và đăng nhập vào công cụ AI của bạn

Chọn một nhà cung cấp để bắt đầu (bạn có thể thêm sau). Đối với mỗi cái: cài đặt CLI, chạy nó một lần để đăng nhập, kiểm tra xem nó hoạt động. Rồi chuyển sang bước 1.

Nhấn vào một nhà cung cấp để mở rộng các bước thiết lập của nó.

Claude (Anthropic)Khuyên dùng cho người mới bắt đầu

Làm việc với

Claude Pro, Claude Max, hoặc một khóa API Anthropic.

1. Cài đặt

curl -fsSL https://claude.ai/install.sh | bash

2. Đăng nhập

Chạy claude một lần trong terminal bất kỳ. Một cửa sổ trình duyệt mở ra để đăng nhập bằng tài khoản Anthropic của bạn.

3. Kiểm tra

Chạy lệnh cài đặt ở trên, rồi chạy riêng tên của CLI trong terminal (ví dụ gõ "claude" và nhấn Enter). Bạn sẽ thấy một lời chào. Gõ "xin chào" và nhấn Enter: nếu nhận được câu trả lời, bạn đã sẵn sàng dùng nó trong AgentsRoom.

Codex (OpenAI / ChatGPT)Dùng tài khoản ChatGPT

Làm việc với

ChatGPT Plus, Pro, Team hoặc Enterprise, hoặc một khóa API OpenAI.

1. Cài đặt

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. Đăng nhập

Chạy codex một lần trong terminal bất kỳ. Một cửa sổ trình duyệt sẽ mở ra. Đăng nhập bằng tài khoản ChatGPT của bạn, chính là tài khoản bạn dùng trên chatgpt.com.

3. Kiểm tra

Antigravity (Google)Có gói miễn phí

Làm việc với

Một tài khoản Google (đăng nhập qua trình duyệt). Có sẵn một gói miễn phí hào phóng.

1. Cài đặt

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. Đăng nhập

Chạy antigravity một lần trong bất kỳ terminal nào. Một cửa sổ trình duyệt mở ra để đăng nhập Google.

3. Kiểm tra

OpenCodeMang theo nhà cung cấp của riêng bạn

Làm việc với

Bất kỳ nhà cung cấp nào bạn cấu hình: Anthropic, OpenAI, OpenRouter và nhiều hơn nữa.

1. Cài đặt

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

2. Đăng nhập

Chạy opencode, rồi dùng lệnh /connect của nó để thêm khóa nhà cung cấp hoặc gói thuê bao OpenCode Go.

3. Kiểm tra

Grok Build (xAI)Ngữ cảnh 256K

Làm việc với

Một tài khoản xAI (đăng nhập qua trình duyệt) hoặc một Grok API key để dùng headless.

1. Cài đặt

curl -fsSL https://x.ai/cli/install.sh | bash

2. Đăng nhập

Chạy grok một lần trong bất kỳ terminal nào. Một cửa sổ trình duyệt mở ra để đăng nhập xAI. Để dùng headless, thay vào đó hãy đặt biến môi trường GROK_CODE_XAI_API_KEY.

3. Kiểm tra

CursorTrình soạn thảo của bạn, ngay trong terminal

Làm việc với

Một tài khoản Cursor. Gói bạn đang dùng đã bao gồm CLI; gói miễn phí chỉ dùng được một tập model nhỏ hơn.

1. Cài đặt

curl https://cursor.com/install -fsS | bash

2. Đăng nhập

Chạy cursor-agent login để đăng nhập qua trình duyệt. Cấu hình nằm ở ~/.cursor.

3. Kiểm tra

Kimi (Moonshot AI)Ngữ cảnh tới 1M

Làm việc với

Một tài khoản Kimi (đăng nhập qua trình duyệt) hoặc khóa API của Moonshot AI Open Platform.

1. Cài đặt

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. Đăng nhập

Chạy kimi một lần trong terminal bất kỳ, sau đó gõ /login để đăng nhập bằng tài khoản Kimi. Cấu hình nằm ở ~/.kimi-code.

3. Kiểm tra

FreebuffKhông cần khóa

Làm việc với

Không cần. Dịch vụ miễn phí và được tài trợ bằng quảng cáo văn bản hiển thị giữa các lượt.

1. Cài đặt

npm install -g freebuff

2. Đăng nhập

Chạy freebuff trong dự án của bạn. Có lệnh freebuff login nếu bạn muốn gắn một tài khoản Codebuff.

3. Kiểm tra

oh-my-piHơn 60 backend

Làm việc với

Những gì bạn đã trả tiền: nó đăng nhập vào Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek và nhiều dịch vụ khác, hoặc nhận một khóa API thông thường.

1. Cài đặt

curl -fsSL https://omp.sh/install | sh

2. Đăng nhập

Chạy omp một lần, sau đó dùng /login để kết nối một nhà cung cấp. Cấu hình nằm ở ~/.omp.

3. Kiểm tra

Pi (Earendil)Tối giản và dễ mở rộng

Làm việc với

Những gì bạn đã trả tiền: Pi đăng nhập vào Anthropic, OpenAI, Google, GitHub Copilot và nhiều nhà cung cấp khác, hoặc nhận một khóa API thông thường.

1. Cài đặt

curl -fsSL https://pi.dev/install.sh | sh

2. Đăng nhập

Chạy pi một lần, sau đó dùng /login để kết nối một nhà cung cấp. Cấu hình nằm ở ~/.pi/agent.

3. Kiểm tra

DevinMột gói, nhiều model

Làm việc với

Một gói Devin hoặc Windsurf, có cả gói miễn phí. Cùng gói đăng ký đó dùng được Claude, GPT, Gemini và các model SWE của Cognition.

1. Cài đặt

curl -fsSL https://cli.devin.ai/install.sh | bash

2. Đăng nhập

Chạy devin auth login để đăng nhập qua trình duyệt. Cấu hình nằm ở ~/.config/devin.

3. Kiểm tra

Command CodeChọn giữa các mô hình mở và mô hình độc quyền

Làm việc với

Tài khoản Command Code hoặc khóa API trong COMMAND_CODE_API_KEY. Quyền truy cập mô hình và giới hạn sử dụng phụ thuộc vào tài khoản của bạn tại nhà cung cấp.

1. Cài đặt

npm install -g command-code@latest

2. Đăng nhập

Chạy command-code login để đăng nhập, hoặc đặt COMMAND_CODE_API_KEY trong môi trường của bạn. Sau đó chạy command-code trong dự án.

3. Kiểm tra

Mistral VibeMô hình châu Âu

Làm việc với

Một tài khoản Mistral (Pro hoặc Team) hoặc một Mistral API key.

1. Cài đặt

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 mistral-vibe

2. Đăng nhập

Chạy vibe --setup một lần để lưu Mistral API key của bạn, sau đó chạy vibe để bắt đầu. Cấu hình nằm trong ~/.vibe/config.toml.

3. Kiểm tra

Muse Code (Meta)Muse Spark trong terminal của bạn

Làm việc với

Tài khoản Meta có quyền truy cập Muse Code, hoặc khóa API trong META_API_KEY. Meta quy định quyền truy cập và giới hạn sử dụng.

1. Cài đặt

curl -fsSL https://dev.meta.ai/install.sh | sh

2. Đăng nhập

Chạy muse login để đăng nhập, hoặc đặt META_API_KEY trong môi trường của bạn. Sau đó chạy muse trong dự án.

3. Kiểm tra

AiderNgười dùng chuyên sâu

Làm việc với

Bất kỳ nhà cung cấp nào thông qua khóa API (Anthropic, OpenAI, DeepSeek và nhiều hơn nữa).

1. Cài đặt

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. Đăng nhập

Không có lệnh đăng nhập. Đặt API key là một biến môi trường trong hồ sơ trình bao của bạn, chẳng hạn: export ANTHROPIC_API_KEY=sk-...

3. Kiểm tra

Amp (Sourcegraph)Chế độ, không phải model

Làm việc với

Một tài khoản Amp (đăng nhập qua trình duyệt) hoặc một token AMP_API_KEY.

1. Cài đặt

curl -fsSL https://ampcode.com/install.sh | bash

2. Đăng nhập

Chạy amp login một lần trong terminal bất kỳ để đăng nhập. Cài đặt nằm ở ~/.config/amp.

3. Kiểm tra

MiniMax Code (MiniMax)Mô hình dòng M

Làm việc với

Tài khoản MiniMax (đăng nhập trên trình duyệt) hoặc khóa API MiniMax.

1. Cài đặt

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. Đăng nhập

Chạy mcode login --region global (hoặc mcode login cho tài khoản Trung Quốc đại lục) trong terminal bất kỳ. Cấu hình nằm ở ~/.minimax.

3. Kiểm tra

ZCode (trình khách cộng đồng)Mô hình GLM, không phải của Z.ai

Làm việc với

Gói Z.ai hoặc BigModel, hoặc khóa API. Trình khách cộng đồng này không do Z.ai phát hành hay xác nhận.

1. Cài đặt

npm install -g zcode-app-cli@latest

2. Đăng nhập

Chạy zcode một lần trong terminal bất kỳ, rồi gõ /login để đăng nhập bằng tài khoản Z.ai hoặc BigModel. Cần Node.js 22.19 trở lên. Cấu hình nằm ở ~/.zcode.

3. Kiểm tra

Bị kẹt ở bước này? Xem phần khắc phục sự cố ở cuối trang này.

Tải và cài đặt AgentsRoom

Tải trình cài đặt cho hệ điều hành của bạn: tệp .dmg trên macOS, tệp .exe trên Windows hoặc AppImage trên Linux. Mở tệp đó, làm theo các bước cài đặt, rồi khởi chạy AgentsRoom.

Tip: AgentsRoom tự động kiểm tra các bản cập nhật. Bạn sẽ được thông báo khi có phiên bản mới.

Tạo dự án đầu tiên

Nhấn nút + trên thanh bên. Chọn bất kỳ thư mục nào trên máy của bạn. Đây là nơi các agent AI của bạn sẽ làm việc. Đặt tên cho dự án và gán nó vào một vùng.

Tip: Mỗi dự án ánh xạ tới một thư mục thật. Các agent chạy CLI của nhà cung cấp bạn đã chọn ngay trong thư mục đó, đúng như khi bạn tự chạy trong terminal.

Thêm agent đầu tiên của bạn

Bên trong dự án của bạn, nhấp vào Thêm Tác Nhân. Chọn một vai trò (Fullstack là một khởi đầu tốt), sau đó là một nhà cung cấp (động cơ bạn đã thiết lập ở bước 0), sau đó là một mô hình (Sonnet được khuyến nghị cho Claude). Tùy chọn viết một lời nhắc ban đầu và nhấp vào Khởi chạy. Terminal mở ra và chạy CLI cho bạn.

Tip: Nếu terminal trông trống hoặc hiển thị màn hình đăng nhập, thì CLI ở bước 0 chưa được đăng nhập. Mở một terminal thông thường, chạy claude hoặc codex (hoặc lệnh của nhà cung cấp của bạn) một lần, hoàn tất đăng nhập, rồi quay lại.

Xem nó hoạt động

Thiết bị cuối hiển thị kết xuất trực tiếp: mỗi tập tin đọc, mỗi chỉnh sửa. Thay đổi trạng thái: đang làm việc, rồi xong. Bạn nhận được một thông báo desktop khi nó hoàn tất.

Tip: Bạn có thể khởi chạy nhiều agent cùng lúc. Mỗi agent có terminal riêng và làm việc độc lập.

Tùy chỉnh thiết lập của bạn

Sửa CLAUDE.md trực tiếp từ AgentsRoom để cung cấp cho các tác nhân văn cảnh tốt hơn. Thay đổi mô hình, điều chỉnh quyền hạn, cấu hình hook. Thêm nhiều tác nhân với vai trò hoặc nhà cung cấp khác nhau.

Tip: Opus cho kiến trúc. Sonnet cho dev. Haiku cho các công việc nhanh như kiểm tra.

Mẹo và thủ thuật

1.Sử dụng Opus cho các quyết định kiến trúc, Sonnet cho lập trình hằng ngày, Haiku cho các công việc nhanh

2.Nhóm các dự án theo vùng (Công việc, Cá nhân, Dự án phụ) để sắp xếp gọn gàng hơn

3.Sửa CLAUDE.md từ AgentsRoom để cung cấp cho các tác nhân tốt hơn ngữ cảnh dự án

4.Bật thông báo desktop để bạn làm việc khác trong khi các agent làm việc

5.Bắt đầu với một tác nhân mỗi dự án, thêm nữa khi bạn cảm thấy thoải mái

Khắc phục sự cố

Terminal của agent trông trống trơn hoặc bị kẹt

Hầu hết các trường hợp là do CLI chưa đăng nhập. Mở terminal của bạn (Terminal trên macOS, PowerShell hoặc Windows Terminal trên Windows, trình giả lập terminal của bạn trên Linux), chạy riêng lệnh của CLI (claude, codex, antigravity, opencode), hoàn tất đăng nhập trên trình duyệt, rồi quay lại AgentsRoom và khởi chạy lại tác nhân. AgentsRoom không có màn hình đăng nhập riêng: phần xác thực nằm trong CLI.

command not found: claude (hoặc codex, antigravity, v.v.)

CLI chưa được cài đặt, hoặc PATH của shell không thấy nó. Chạy lại lệnh cài đặt ở bước 0 phía trên. Nếu bạn dùng nvm, hãy cài CLI với đúng phiên bản Node mà bạn dùng hằng ngày, nếu không file thực thi sẽ không có trong PATH khi AgentsRoom khởi chạy.

Tôi không thấy nút để đăng nhập vào ChatGPT hoặc Claude bên trong AgentsRoom

Theo thiết kế. AgentsRoom là một giao diện người dùng trên các CLI và không bao giờ xử lý thông tin đăng nhập của bạn trực tiếp. Việc đăng nhập được thực hiện một lần bên trong CLI (chạy claude hoặc codex trong terminal), sau đó AgentsRoom sử dụng phiên đó. Đây là điều làm cho AgentsRoom an toàn hơn các công cụ chặn token của bạn.

Agent kẹt ở trạng thái "đang suy nghĩ"

Kiểm tra xem đăng ký hoặc khóa API của bạn có hoạt động cho nhà cung cấp đã chọn không. Thử chạy CLI trực tiếp trong terminal của bạn để xem thông báo lỗi thực sự: Claude hoặc OpenAI đôi khi giới hạn hoặc hết hạn phiên một cách âm thầm.

Không có dự án hiển thị trong thanh bên

Hãy kiểm tra xem bạn đã chọn một thư mục hợp lệ khi tạo dự án này. Thư mục này phải tồn tại trên đĩa. Khởi động lại AgentsRoom nếu một dự án được thêm vào nhưng chưa thấy được.

Tôi đã cài đặt CLI nhưng AgentsRoom vẫn nói "không tìm thấy"

AgentsRoom thừa hưởng PATH từ shell đăng nhập của bạn, không phải từ terminal tương tác của bạn. Thoát hoàn toàn AgentsRoom, mở một terminal mới, xác minh CLI có thể gọi từ một phiên shell mới (which claude), sau đó khởi chạy lại AgentsRoom.