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

# Khắc phục sự cố

> Ý nghĩa các thông báo lỗi của CoClip và cách xử lý.

Tìm thông báo hoặc hiện tượng bạn gặp, rồi làm theo cách xử lý. Thông báo được trích ngắn; trong app có thể dài hơn một chút.

## Cài đặt và khởi động

> [accordion] Windows hoặc macOS chặn cài đặt hoặc mở CoClip
>
> Windows SmartScreen và macOS có thể chặn ứng dụng tải từ internet. Cách vượt qua an toàn có ở [Cài đặt CoClip](/docs/vi/get-started/install.md).

## Xuất video

> [accordion] "The disk is full."
>
> **Nguyên nhân:** ổ đĩa bạn xuất video tới đã hết chỗ trong lúc CoClip ghi file.
>
> **Cách xử lý:** giải phóng dung lượng trên ổ đó, hoặc xuất sang ổ khác. Sau đó xuất lại.

> [accordion] "A file is locked by another program"
>
> **Nguyên nhân:** một chương trình khác đang mở file xuất ra hoặc một file media, ví dụ trình phát video hoặc công cụ đồng bộ đám mây.
>
> **Cách xử lý:** đóng trình phát, hoặc tạm dừng công cụ đồng bộ, rồi xuất lại. Xuất với tên file mới cũng được.

> [accordion] "A font used by the project could not be loaded."
>
> **Nguyên nhân:** một file font trong dự án bị thiếu hoặc hỏng.
>
> **Cách xử lý:** mở danh sách font trong Library. Font bị thiếu có nhãn **missing** và nút **Relink**. Relink font đó, hoặc chọn font khác cho đoạn chữ. Sau đó xuất lại. Xem [Chữ, kiểu chữ và font](/docs/vi/library/text-styles-fonts.md).

> [accordion] "A media file used by the project is missing or unreadable."
>
> **Nguyên nhân:** một file video, ảnh hoặc audio đã bị di chuyển, xoá hoặc hỏng.
>
> **Cách xử lý:** relink file trong Library, rồi xuất lại. Xem [Nhập và quản lý media](/docs/vi/editing/import-media.md).

> [accordion] "The NVIDIA hardware encoder failed."
>
> **Nguyên nhân:** bộ mã hoá NVIDIA trên máy bạn dừng giữa chừng khi xuất.
>
> **Cách xử lý:** mở **Settings** → **Media & export** và đặt **Render with** thành **Software (CPU, slower)**. Xuất lại. Xong việc, bạn có thể đặt lại **Auto (GPU engine when possible)**.

> [accordion] "A frame took too long to render."
>
> **Nguyên nhân:** một khung hình phải chờ media hoặc font tải quá lâu.
>
> **Cách xử lý:** kiểm tra Library xem có media hoặc font bị thiếu không và relink chúng. Sau đó xuất lại.

> [accordion] "Element … could not be drawn"
>
> **Nguyên nhân:** một element trên timeline bị lỗi khi render. Thông báo nêu tên element và lý do.
>
> **Cách xử lý:** chọn element đó và sửa theo thông báo, hoặc xoá nó. Sau đó xuất lại.

> [accordion] "Export cancelled."
>
> **Nguyên nhân:** lần xuất đã bị dừng trước khi xong.
>
> **Cách xử lý:** xuất lại bằng **File** → **Export…** (`Ctrl+E` / `⌘E`).

> [accordion] "Export failed: …" với lý do khác
>
> **Nguyên nhân:** CoClip chưa có thông báo dễ hiểu cho lỗi này.
>
> **Cách xử lý:** xuất lại một lần. Nếu vẫn lỗi, liên hệ hỗ trợ (xem cuối trang) và gửi kèm toàn bộ thông báo.

> [accordion] Xuất video chậm trên máy không có GPU NVIDIA
>
> **Nguyên nhân:** khi không có GPU xuất được, CoClip dùng engine phần mềm trên CPU. Thời gian xuất khoảng gấp đôi GPU ở 1080p, lâu hơn nữa ở 4K.
>
> **Cách xử lý:** đây là bình thường. Giữ **Render with** ở **Auto (GPU engine when possible)** để CoClip dùng GPU bất cứ khi nào có thể. Trên macOS, việc xuất chạy trên GPU của Apple. Xem [Cài đặt](/docs/vi/reference/settings.md).

## Xem trước và media

> [accordion] Một file media bị đánh dấu thiếu trong Library
>
> **Nguyên nhân:** file đã bị di chuyển, đổi tên hoặc xoá bên ngoài CoClip.
>
> **Cách xử lý:** bấm **Relink** trên file đó và chọn lại file. Xem [Nhập và quản lý media](/docs/vi/editing/import-media.md).

> [accordion] "A video could not be played"
>
> **Nguyên nhân:** CoClip không giải mã được video này và không có bản xem trước của nó. Clip để trống trong khung xem trước.
>
> **Cách xử lý:** relink clip tới một bản file còn dùng được, hoặc chuyển video sang MP4 (H.264) rồi nhập lại.

> [accordion] "An animated image could not be played"
>
> **Nguyên nhân:** CoClip không giải mã được một ảnh động. Ảnh hiện dạng giữ chỗ trong khung xem trước và trong video xuất ra.
>
> **Cách xử lý:** thay bằng một bản file còn dùng được, hoặc chuyển sang định dạng khác rồi nhập lại.

> [accordion] Proxy xem trước bị lỗi hoặc hiển thị sai
>
> **Nguyên nhân:** bộ mã hoá NVIDIA trên máy bạn tạo bản xem trước bị lỗi.
>
> **Cách xử lý:** mở **Settings** → **Media & export** và bật **Make preview proxies with the CPU only**. Cài đặt áp dụng cho proxy mới.

## Tạo transcript

> [accordion] "The last download failed: no internet connection."
>
> **Nguyên nhân:** CoClip không tải được model nhận dạng giọng nói. Model cần tải một lần trước transcript đầu tiên: khoảng 574 MB cho **Best quality**, hoặc 264 MB cho **Fast**.
>
> **Cách xử lý:** kết nối internet rồi bấm **Retry download**. Sau khi tải xong, tạo transcript không cần internet.

> [accordion] "The last download was damaged (checksum mismatch) and was deleted."
>
> **Nguyên nhân:** file model tải về không khớp, thường do mạng bị ngắt. CoClip đã xoá file đó.
>
> **Cách xử lý:** bấm **Retry download**. Nếu vẫn lỗi, thử mạng khác.

## Dự án và cửa sổ

> [accordion] "You have … projects open (limit …)"
>
> **Nguyên nhân:** bạn đã mở tới giới hạn số dự án. Dự án do agent mở cũng được tính; thông báo liệt kê các dự án này.
>
> **Cách xử lý:** đóng một dự án trong danh sách, hoặc tăng **Open projects at once** trong **Settings** → **General** (tối đa 8).

## Connector và tải xuống

> [accordion] Connector hiện "Re-enter key"
>
> **Nguyên nhân:** CoClip không đọc được key đã lưu. Key được lưu bởi một bản cài CoClip khác hoặc một tài khoản Windows khác, hoặc quyền truy cập Keychain "CoClip Safe Storage" trên macOS đã bị từ chối.
>
> **Cách xử lý:** trên macOS, thoát rồi mở lại CoClip và chọn **Always Allow** khi macOS hỏi. Nếu không, dán lại key ở **Settings** → **Connectors** rồi bấm **Save**. Xem [Connector và API key](/docs/vi/reference/connectors.md).

> [accordion] "The key was refused" hoặc "Out of … credits"
>
> **Nguyên nhân:** dịch vụ từ chối key (sai, đã thu hồi hoặc thiếu quyền), hoặc tài khoản của bạn ở dịch vụ đó đã hết credit.
>
> **Cách xử lý:** kiểm tra key và số dư trên website của dịch vụ, rồi lưu lại key và bấm **Test connection**.

> [accordion] "yt-dlp is not installed" hoặc "The video downloader is missing"
>
> **Nguyên nhân:** công cụ CoClip dùng để nhập video từ link không có sẵn.
>
> **Cách xử lý:** trên macOS, chạy `brew install yt-dlp`, rồi khởi động lại CoClip. Trên Windows, cài lại CoClip. Xem [Cài đặt CoClip](/docs/vi/get-started/install.md).

## AI agent

> [accordion] Agent không khởi động, quá cũ hoặc không đăng nhập được
>
> Trang của mỗi agent có các bước cài đặt, phiên bản tối thiểu, cách đăng nhập và các thông báo lỗi:
>
> * [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)

> [accordion] Agent đã sửa thứ bạn không muốn
>
> Hoàn tác từ AI log. Xem [AI log và hoàn tác](/docs/vi/ai-agents/ai-log-and-undo.md).

## Vẫn chưa xử lý được?

Gửi email tới [support@coclip.app](mailto:support@coclip.app) kèm:

* phiên bản CoClip (hiện cạnh tên CoClip ở Start screen; trên macOS còn có ở **CoClip** → **About CoClip**)
* Windows hay macOS, và phiên bản hệ điều hành
* các bước dẫn tới sự cố
* ảnh chụp màn hình thông báo
* nếu bộ phận hỗ trợ yêu cầu, file log `logs/main.log` (xem [Thư mục dự án](/docs/vi/reference/project-folder.md))


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