> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CoClip hoạt động thế nào

> Dự án là thư mục trên máy bạn, và bạn cùng AI agent chỉnh nó cùng lúc, trực tiếp.

CoClip có ba phần: thư mục dự án trên máy bạn, editor nơi bạn làm việc, và các AI agent bạn mời vào. Cả ba cùng thấy một timeline, cùng một lúc.

```mermaid theme={null}
flowchart LR
  you["Bạn, trong editor"] -->|"chỉnh sửa"| project[("Thư mục dự án")]
  agent["AI agent"] -->|"chỉnh qua công cụ CoClip"| project
  project -->|"cập nhật trực tiếp"| you
  project -->|"đọc"| agent
```

## Dự án là một thư mục

Mỗi dự án là một thư mục bình thường. Bạn chọn nơi lưu khi tạo dự án; mặc định CoClip dùng `Documents\CoClip` trên Windows và `~/CoClip` trên macOS.

| Trong thư mục | Chứa gì |
| - | - |
| `project.json` | Timeline: track, clip, chữ, phụ đề và cài đặt |
| `assets/` | Media và font mà dự án dùng |
| `exports/` | Video bạn đã xuất |
| `history.jsonl` | Nhật ký mọi thay đổi, của bạn và của agent |
| `.cache/` | Preview và dữ liệu phân tích mà CoClip tạo lại được |

CoClip lưu từng thay đổi vào thư mục ngay lập tức. Hàng tiêu đề hiện **Saved** và số **Revision** tăng sau mỗi thay đổi. Xem chi tiết ở [Thư mục dự án](/docs/vi/reference/project-folder.md).

## Bạn và agent cùng chỉnh sửa

Agent chỉnh dự án qua các công cụ riêng của CoClip, theo cùng quy tắc như bạn. Bạn có thể chạy agent trong **AI** dock ngay trong editor, hoặc kết nối từ bên ngoài, ví dụ Claude Code trong terminal.

* **Thay đổi hiện trực tiếp.** Khi dự án đang mở, bạn thấy từng thay đổi của agent trên timeline ngay khi nó xảy ra.
* **Mỗi thay đổi có tác giả.** **AI log** liệt kê thay đổi của agent theo tên phiên, ví dụ **Claude 1** hoặc **Codex 1**.
* **Hoàn tác theo từng phiên.** Nói với agent "undo my last edit" (hoàn tác thay đổi gần nhất của tôi) và nó chỉ hoàn tác thay đổi của phiên đó. Xem [AI log và hoàn tác](/docs/vi/ai-agents/ai-log-and-undo.md).
* **Nhiều agent làm cùng lúc.** Mỗi phiên là một tab trong AI dock.

## Không có gì diễn ra sau lưng bạn

* Video chỉ được xuất khi bạn hoặc agent yêu cầu.
* Khi agent cần preview hoặc xuất video lúc editor đang đóng, CoClip mở cửa sổ editor bình thường cho dự án đó. Không có gì render ngầm.
* Mỗi dự án mở trong cửa sổ riêng. Khi agent mở một dự án khác, dự án đó mở trong cửa sổ mới nằm sau cửa sổ của bạn, kèm thông báo.

## Máy của bạn, tài khoản của bạn

* Dự án, media và video đã xuất nằm trên máy bạn. Việc chuyển giọng nói thành chữ cũng chạy trên máy, trừ khi bạn chọn một dịch vụ online.
* Dịch vụ online là tuỳ chọn. Bạn thêm chúng dưới dạng [connector](/docs/vi/reference/connectors.md) bằng API key của chính bạn. CoClip mã hoá key và không bao giờ ghi key vào dự án.
* AI agent dùng tài khoản và gói của chính bạn với nhà cung cấp agent đó.

## Trang liên quan

* [Bắt đầu nhanh: video đầu tiên](/docs/vi/get-started/quickstart.md)
* [Tổng quan AI agent](/docs/vi/ai-agents/overview.md)
* [Khung AI trong editor](/docs/vi/ai-agents/ai-dock.md)
* [Kết nối agent bên ngoài editor](/docs/vi/ai-agents/outside-the-editor.md)
* [Menu và cửa sổ](/docs/vi/interface/menus-and-windows.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.