---
title: "Hướng dẫn tạo Cloud Agent đầu tiên trên TOSE"
description: "Các bước triển khai Cloud Agent trên TOSE: chọn agent, cấu hình CPU, RAM, ổ đĩa, kho mã, duyệt kế hoạch, nhập khóa API và mở console."
url: https://tose.sh/blog/huong-dan-tao-cloud-agent-dau-tien
lang: vi
category: "Hướng dẫn"
tags: ["cloud-agents", "huong-dan", "claude-code", "codex", "pi"]
author: "TOSE"
published: 2026-11-13T12:49:17.677706Z
updated: 2026-11-13T12:49:17.677778Z
---

# Hướng dẫn tạo Cloud Agent đầu tiên trên TOSE

**TL;DR:** Cần một workspace có ví trả trước còn số dư, vai trò chủ sở hữu hoặc quản trị viên, và khóa API của nhà cung cấp. Cloud Agents → chọn agent → Triển khai → cấu hình → Xem lại kế hoạch → Duyệt kế hoạch → nhập khóa → Mở agent. Ổ đĩa tăng được nhưng không giảm được; nên bắt đầu với cấu hình nhỏ nhất.

> **info**
> **Loạt bài Cloud Agents trên TOSE** · Phần 2/5
> 1. [Giới thiệu](/blog/gioi-thieu-cloud-agents-tren-tose) · 2. **Tạo Cloud Agent đầu tiên** (bài này) · 3. [Giao việc qua MCP](/blog/giao-viec-cho-cloud-agent-qua-mcp) · 4. [GitHub và Pull Request](/blog/cloud-agent-github-pull-request) · 5. [Chi phí và tự động ngủ](/blog/chi-phi-cloud-agent-va-tu-dong-ngu)

[Video: Tạo Cloud Agent đầu tiên](https://cdn.tose.sh/blog/bd3a75da0f4b9108b4f8a4627cb11d37.mp4)

[Phần 1](/blog/gioi-thieu-cloud-agents-tren-tose) giải thích khi nào nên giao việc cho Cloud Agent. Bài này hướng dẫn từng bước dựng agent đầu tiên.

## Chuẩn bị

• Một workspace TOSE có **ví trả trước còn số dư**. Agent tính phí compute theo giờ và lưu trữ theo tháng.

• Vai trò **chủ sở hữu hoặc quản trị viên** của workspace.

• **Khóa API của nhà cung cấp**: `ANTHROPIC_API_KEY` cho Claude Code, `OPENAI_API_KEY` cho Codex, `PI_API_KEY` cho Pi. Riêng Claude Code có thể dùng gói Claude (Pro hoặc Max) thay cho khóa API, đăng nhập sau khi triển khai hoặc bằng `/login` trong console.

TOSE không tính phí sử dụng mô hình; chi phí token vẫn do nhà cung cấp tính như khi chạy trên máy cá nhân.

## Bước 1: Chọn agent

Trên dashboard, mở menu **Cloud Agents**. Phía trên là các agent của workspace, phía dưới là mục **Agent có sẵn** gồm Claude Code, Codex và Pi. Chọn một agent và bấm **Triển khai**.

![Trang Cloud Agents](https://cdn.tose.sh/blog/058b700c69a7fd8e4c5ba57d1dd7782a.webp)

*Ảnh mockup trang Cloud Agents, dữ liệu minh họa.*

## Bước 2: Cấu hình

![Form cấu hình agent](https://cdn.tose.sh/blog/64c51cd9d9388fa5e289d237a54abbbd.webp)

*Ảnh mockup form cấu hình, dữ liệu minh họa.*

**Tên ứng dụng.** Nên đặt tên phản ánh công việc, ví dụ `codex-dashboard`.

**Nhà cung cấp và mô hình.** Chọn mô hình agent sẽ sử dụng.

**CPU và RAM.**

| Agent | CPU | RAM |
| --- | --- | --- |
| Claude Code, Codex | 1, 2 hoặc 4 nhân | 2, 4 hoặc 8 GiB |
| Pi | 1 hoặc 2 nhân | 1, 2 hoặc 4 GiB |

*CPU và RAM.*

Cấu hình nhỏ nhất đủ cho phần lớn việc sửa code. Tăng lên khi cần build nặng hoặc chạy nhiều test.

**Ổ đĩa workspace.** `/workspace` có các mức 5 GiB (mặc định), 10, 20 hoặc 50 GiB, kèm 1 GiB cho `/home/agent`. **Ổ đĩa tăng được nhưng không giảm được**, vì vậy nên bắt đầu ở mức nhỏ.

**Kho mã.** Gắn tối đa 10 repo GitHub qua GitHub App của workspace. Mặc định agent chỉ đọc. Xem [phần 4](/blog/cloud-agent-github-pull-request) để bật push và Pull Request.

**Tự động ngủ.** Mặc định là Tắt. Nên chọn 30 phút cho agent đầu tiên. Xem [phần 5](/blog/chi-phi-cloud-agent-va-tu-dong-ngu).

**Mạng.** Agent truy cập được Internet công khai. Các địa chỉ mạng riêng, link-local và metadata bị chặn.

## Bước 3: Xem lại và duyệt kế hoạch

Bấm **Xem lại kế hoạch**. TOSE chưa tạo gì ở bước này mà lập một kế hoạch gồm tài nguyên sẽ tạo, trần chi phí compute mỗi giờ, giá lưu trữ theo tháng và các điểm chặn nếu có.

![Màn hình xem lại kế hoạch](https://cdn.tose.sh/blog/036b9c892a8d26cdb871b911a2810d36.webp)

*Ảnh mockup màn hình kế hoạch, dữ liệu minh họa.*

Nếu mọi thứ phù hợp, bấm **Duyệt kế hoạch**. Kế hoạch chỉ được thực hiện khi có người duyệt, kể cả khi do một AI khác tạo qua MCP.

## Bước 4: Cài đặt và nhập khóa

Ở bước **Cài đặt**, nhập khóa API của nhà cung cấp. Khóa được mã hóa và chỉ agent sử dụng; bạn không cần đưa khóa vào repo hay tệp `.env`.

## Bước 5: Mở agent

Sau khi cài xong, bấm **Mở agent**. Trang agent có năm tab: **Tổng quan, Tác vụ, Kho mã, Cài đặt, Hoạt động**.

![Trang tổng quan của agent](https://cdn.tose.sh/blog/535d472e01c1ceb10c292f905a0f3fcc.webp)

*Ảnh mockup trang agent, dữ liệu minh họa.*

Console chạy trong trình duyệt và là riêng tư: không có địa chỉ công khai, chỉ chủ sở hữu và quản trị viên workspace mở được.

## Chạy thử một việc nhỏ

Nên bắt đầu bằng một việc kiểm tra được trong vài phút, chẳng hạn:

```
Đọc README và cấu trúc thư mục của repo.
Chạy bộ test hiện có và liệt kê các test bị lỗi.
Không sửa tệp nào.
```

Nếu agent thực hiện và báo cáo đúng, agent đã sẵn sàng nhận việc thật.

## Lưu ý

• **Không nâng cấp tại chỗ.** Khi có bản phát hành mới, hãy cài thành một agent mới và chuyển công việc sang bằng git.

• **Giao việc qua MCP** cần bản có hỗ trợ tác vụ: Claude Code 1.1.0, Codex 1.1.0 hoặc Pi 1.2.0.

• **Khi ngủ, agent giữ tệp và thông tin đăng nhập** nhưng mất phiên tmux. Đánh thức bằng nút **Đánh thức và mở**.

**Phần trước:** [← Giới thiệu Cloud Agents](/blog/gioi-thieu-cloud-agents-tren-tose) **Phần tiếp theo:** [Giao việc cho Cloud Agent qua MCP →](/blog/giao-viec-cho-cloud-agent-qua-mcp)

## FAQ

### Cần gì để tạo Cloud Agent trên TOSE?

Một workspace có ví trả trước còn số dư, vai trò chủ sở hữu hoặc quản trị viên, và khóa API của nhà cung cấp mô hình.

### Có thể giảm dung lượng ổ đĩa sau khi tạo không?

Không. Ổ đĩa /workspace chỉ tăng được, vì vậy nên bắt đầu với 5 GiB.

### Làm sao nâng cấp agent lên bản phát hành mới?

TOSE không nâng cấp tại chỗ. Hãy cài bản mới thành một agent mới và chuyển công việc sang bằng git.
