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

# Cài đặt

> Mỗi tab Settings điều khiển gì: giao diện, xuất video, tải xuống, trợ lý AI và connector.

Mở Settings bằng nút bánh răng (**Settings**) ở thanh trên cùng của cửa sổ. Các tab bên trái gồm **General**, **Media & export**, **Downloads**, **AI assistants** và **Connectors**. Thay đổi được lưu ngay khi bạn chọn; bấm **Close** khi xong.

Ảnh minh hoạ sẽ được bổ sung

Hộp thoại Settings
Trạng thái: Đang mở tab General
Làm nổi bật: Danh sách tab bên trái

## General

| Cài đặt | Tác dụng |
| - | - |
| **Theme** | **System**, **Light** hoặc **Dark**. **System** đi theo Windows hoặc macOS. |
| **Accent color** | **Magenta**, **Violet**, **Blue** hoặc **Cyan**. Màu này dùng cho nút, vùng chọn và viền focus. Các mục AI vẫn giữ màu xanh lime. |
| **Open projects at once** | Số dự án được mở cùng lúc, từ 1 đến 8 (mặc định 4). Mỗi dự án mở trong cửa sổ riêng. Dự án do agent mở cũng được tính. Giảm con số này không đóng các cửa sổ đang mở. |

## Media & export

| Cài đặt | Tác dụng |
| - | - |
| **Make preview proxies with the CPU only** | Bỏ qua bộ mã hoá NVIDIA khi CoClip tạo proxy xem trước. Bật lên nếu proxy bị lỗi hoặc hiển thị sai trên máy bạn. Áp dụng cho proxy mới. |
| **Render with** | Engine dùng để xuất video. Xem các lựa chọn bên dưới. |
| **FFmpeg** | Hiện **Bundled with CoClip**, hoặc bản FFmpeg bạn đã chọn. **Use another FFmpeg…** chọn bản của riêng bạn; ffprobe phải nằm cùng thư mục. CoClip hiện checksum của cả hai file và hỏi trước khi dùng. **Use bundled FFmpeg** quay về bản đi kèm. |

Các lựa chọn của **Render with**:

* **Auto (GPU engine when possible)**: mặc định. CoClip dùng GPU engine và tự chuyển sang cách khác khi không xuất được.
* **GPU engine**: giải mã, ghép lớp và mã hoá video trên GPU.
* **Software (CPU, slower)**: chỉ có trên Windows. Thời gian xuất khoảng gấp đôi GPU ở 1080p, lâu hơn nữa ở 4K.

Trên Windows, **Auto** và **GPU engine** chuyển sang engine phần mềm khi GPU của máy không xuất được. Trên macOS, chúng chuyển sang bộ mã hoá x264 khi bộ mã hoá phần cứng của Apple không xuất được; macOS chưa hỗ trợ xuất bằng phần mềm (CPU). Nếu không engine nào vẽ được, lần xuất sẽ thất bại và báo lý do. Xem [Xuất video](/docs/vi/editing/export.md).

## Downloads

### Video downloader

CoClip nhập video từ link bằng yt-dlp. Mục này hiện phiên bản đang dùng và nguồn của nó.

* **Windows:** **Update downloader** tải yt-dlp mới nhất. Sau khi cập nhật, **Use bundled version** quay về bản đi kèm CoClip.
* **macOS:** yt-dlp lấy từ Homebrew. Cập nhật bằng `brew upgrade yt-dlp`.

**Use browser login** cho phép downloader dùng phiên đăng nhập trong trình duyệt của bạn với những link cần đăng nhập. Mặc định là **Off**. Bạn có thể chọn Firefox, Chrome, Edge, Brave, Chromium, Opera hoặc Vivaldi, và Safari trên macOS.

* Trên Windows, Chrome và Edge có thể không dùng được.
* Safari cần cấp quyền Full Disk Access cho CoClip.
* Downloader chỉ đọc cookie khi một lần nhập cần đăng nhập. CoClip không bao giờ lưu cookie hay chia sẻ chúng với agent.
* Lần nhập do agent thực hiện chỉ dùng cài đặt này khi CoClip đang mở.

### Map imagery

Bản đồ vệ tinh được cắt từ ảnh Blue Marble của NASA. CoClip tải ảnh này một lần và dùng lại cho mọi dự án. Mục này hiện thư mục cache và dung lượng.

* **Retry** chuẩn bị phần ảnh mà dự án đang mở còn thiếu.
* **Clear map imagery cache** giải phóng dung lượng. Mỗi dự án giữ bản sao riêng các tile nó dùng, nên xoá cache không làm hỏng dự án nào. Bạn không xoá được khi ảnh đang được chuẩn bị.

Xem [Maps](/docs/vi/library/elements/maps.md).

## AI assistants

Chọn cách mỗi agent khởi động trong AI dock. Có một lựa chọn riêng cho **Claude**, **Codex** và **OpenCode**. Lựa chọn áp dụng cho phiên kế tiếp của agent đó.

| Lựa chọn | Agent nạp những gì |
| - | - |
| **CoClip setup only (recommended)** | Chỉ công cụ, skill và agent của CoClip. Tài khoản đăng nhập và model của bạn giữ nguyên. Skill, plugin, MCP server và cấu hình riêng của bạn không lẫn vào dự án video. |
| **Use my own … setup** | Nạp cả cấu hình riêng của bạn, kèm công cụ CoClip cho phiên đó. |

Cách cài đặt và đăng nhập từng agent nằm ở trang riêng: [Claude Code](/docs/vi/ai-agents/claude-code.md), [Codex](/docs/vi/ai-agents/codex.md), [OpenCode](/docs/vi/ai-agents/opencode.md), [Antigravity](/docs/vi/ai-agents/antigravity.md).

## Connectors

Thêm key của riêng bạn cho ElevenLabs, OpenRouter, Vbee, Epidemic Sound và Freesound. Xem [Connector và API key](/docs/vi/reference/connectors.md).

## Trang liên quan

* [Phím tắt](/docs/vi/reference/keyboard-shortcuts.md)
* [Thư mục dự án](/docs/vi/reference/project-folder.md)
* [Khắc phục sự cố](/docs/vi/reference/troubleshooting.md)


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