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 (đã đọc điều này trước)

AgentsRoom là buồng lái. Các AI CLI (Claude Code, Codex, OpenCode, Antigravity, Aider, Grok Build, Mistral Vibe, Kimi Code) 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, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe hoặc Kimi Code)
ví dụ: npm install -g @anthropic-ai/claude-code
✓Một máy chủ nhật ký hoặc API key cho nhà cung cấp đã chọn của bạn

Bước 0, cài đặt và ký vào cơ chế 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 để ký, xác minh nó hoạt động. Rồi nhảy tới 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 người dùng lần đầu

Làm việc với

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

Cài đặt 1

npm install -g @anthropic-ai/claude-code

2. ký vào

Chạy đi. Một cửa sổ trình duyệt mở ra để ký với tài khoản Anthropic.

3 Kiểm tra

Chạy lệnh cài đặt ở trên, rồi chạy chỉ tên của CLI trong thiết bị cuối (v. d. gõ "laude" và nhấn Enter). Anh nên thấy một dấu hiệu chào đón. Gõ "xin chào" và nhấn phím Enter: nếu bạn có câu trả lời, bạn sẵn sàng sử 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.

Cài đặt 1

npm install -g @openai/codex

2. ký vào

Chạy sổ tay một lần trong bất kỳ thiết bị cuối nào. Cửa sổ trình duyệt mở. Ký vào với tài khoản ChatGPT của bạn, cùng một 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.

Cài đặt 1

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

2. ký vào

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.

Cài đặt 1

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

2. ký vào

Chạy việc đăng nhập chính xác mã mở và theo các dấu nhắc để thêm một khóa nhà cung cấp.

3 Kiểm tra

AiderNgười dùng điện

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).

Cài đặt 1

python -m pip install -U --upgrade-strategy only-if-needed aider-chat

2. ký vào

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: xuất khẩu ANTHROPIC API=sk-...

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.

Cài đặt 1

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

2. ký vào

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

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.

Cài đặt 1

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

2. ký vào

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

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.

Cài đặt 1

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

2. ký vào

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

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.

Cài đặt 1

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

2. ký vào

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

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.

Cài đặt 1

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

2. ký vào

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

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.

Cài đặt 1

npm install -g freebuff

2. ký vào

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

Bị mắc kẹt ở bước này? Xem phần có vấn đề ở 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. Anh 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 thiết bị cuối trông trống hoặc hiển thị màn hình đăng nhập, thì trình CLI chưa được ký. Mở một thiết bị cuối thông thường, chạy crawude hoặc sổ tay (hoặc lệnh của nhà cung cấp của bạn) một lần, hoàn thành các dấu hiệu, sau đó trở 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: suy nghĩ, mã hóa, xong. Bạn nhận được một thông báo macOS 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 móc. 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à mẹo

1.Sử dụng Opus cho các quyết định kiến trúc, Sonnet cho mã hóa hàng ngày, Haiku cho các công việc nhanh

2.Các dự án nhóm theo vùng (làm việc, Cá nhân, tổ chức bên) cho tổ chức tốt 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.Dùng thông báo macOS để đa nhiệm vụ khi 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

Name

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.

không tìm thấy lệnh: cladeude (hoặc sổ tay, grini, etc.)

CLI chưa được cài đặt, hoặc trình bao PATH không thấy nó. Chạy lại lệnh cài đặt từ bước 0 trên. Nếu bạn sử dụng nvm, cài đặt CLI với phiên bản nút tương tự, bạn sử dụng ngày- ngày- ngày, nếu không hệ nhị phân sẽ không có trong PATH khi AgentsRoom phát hành.

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.