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

# Codex

> Cài Codex CLI, đăng nhập, chọn thiết lập trong CoClip và sửa các thông báo về phiên bản và cài đặt.

Codex là agent dòng lệnh của OpenAI. Trong CoClip, Codex chạy trong một tab **Codex** của [AI dock](/docs/vi/ai-agents/ai-dock.md), kèm công cụ, skill và vai trò agent của CoClip cho riêng phiên đó.

## Cài đặt và đăng nhập

CoClip cần Codex CLI **0.144.5** trở lên. CoClip không bao giờ cài hay cập nhật Codex. Lệnh cài do OpenAI cung cấp; hãy xem [kho mã chính thức của Codex](https://github.com/openai/codex) để có hướng dẫn mới nhất.

**1. Cài Codex**

Mở PowerShell (Terminal trên macOS) và chạy:

```bash theme={null}
npm install -g @openai/codex
```

Lệnh này cần Node.js. OpenAI cũng có trình cài độc lập.

**2. Đăng nhập một lần**

Chạy `codex` và làm theo các bước đăng nhập. Thông tin đăng nhập nằm trên máy bạn.

**3. Kiểm tra phiên bản**

Chạy `codex --version`. Kết quả phải là 0.144.5 trở lên.

**4. Mở tab Codex**

Trong CoClip, bấm **+** trong AI dock và chọn **Codex**.

## Chọn thiết lập

Mở **Settings** → **AI assistants** → **Codex**:

| Lựa chọn | Codex nạp những gì |
| - | - |
| **CoClip setup only (recommended)** | Chỉ công cụ, skill và subagent của CoClip cho phiên đó. Giữ đăng nhập của bạn. Cấu hình Codex của bạn không bao giờ bị thay đổi. |
| **Use my own Codex setup** | Nạp thêm cấu hình riêng của bạn, kèm công cụ CoClip chỉ cho phiên đó. |

Lựa chọn áp dụng cho phiên Codex tiếp theo mà AI dock mở. Ở cả hai chế độ, CoClip thêm công cụ cho từng phiên và không bao giờ ghi vào cấu hình Codex hay thư mục dự án của bạn.

## Codex có gì trong CoClip

* Công cụ CoClip, skill CoClip và năm vai trò agent. Xem [Skill và vai trò agent](/docs/vi/ai-agents/skills-and-agents.md).
* Công cụ CoClip chạy mà không cần hỏi, chỉ trong phiên đó. Các thao tác khác, như lệnh shell, theo lời hỏi xác nhận của chính agent.
* Codex không nhận vùng chọn timeline trực tiếp. Khi bạn nói "sửa clip này", Codex đọc vùng chọn hiện tại bằng một công cụ CoClip.

## Thông báo và cách sửa

| Bạn thấy gì | Cách sửa |
| - | - |
| **Codex CLI is not installed on this PC** (hoặc Mac) | Chạy `npm install -g @openai/codex`, chạy `codex` một lần để đăng nhập, rồi bấm **Open Codex again**. |
| **Codex … is too old for CoClip** | Cập nhật Codex bằng `npm install -g @openai/codex` (hoặc `codex update` nếu dùng bản cài độc lập), rồi bấm **Open Codex again**. |
| **CoClip could not read the Codex version** | Chạy `codex --version` trong terminal. Nếu lệnh lỗi, hãy cài lại Codex. |
| **CoClip starts Codex's own codex.exe, but only the npm launcher was found** (Windows) | Cài lại Codex bằng `npm install -g @openai/codex`, rồi mở lại tab. |
| Codex báo lỗi riêng về model | Codex của bạn quá cũ cho model đó. Hãy cập nhật Codex. CoClip không bao giờ chọn model cho Codex. |
| Đã cài mà vẫn không tìm thấy Codex | Khởi động lại CoClip. |
| **Codex 1 exited** | Bấm **Restart** để mở phiên mới, hoặc **Close** để đóng tab. |

## Trang liên quan

* [Dùng Codex bên ngoài editor](/docs/vi/ai-agents/outside-the-editor.md#codex)
* [AI log và hoàn tác](/docs/vi/ai-agents/ai-log-and-undo.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.