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

# Codex Desktop

> Dùng 4096bytes trong Codex Desktop

Codex Desktop dùng cùng cấu hình cục bộ với Codex CLI. Trước tiên hãy cài Codex Desktop, rồi ghi `config.toml` và `auth.json` do bảng điều khiển tạo vào thư mục cấu hình Codex.

Nếu bạn đã hoàn tất cấu hình [Codex](/vi/clients/codex), hãy mở hoặc khởi động lại Codex Desktop. Bạn không cần tạo API Key mới.

## Điều kiện trước

* Bạn đã hoàn thành [Tạo tài khoản](/vi/quickstart/create-account).
* Bạn đã hoàn thành [Lấy API Key](/vi/quickstart/get-api-key).
* Codex Desktop đã được cài.
* Hộp thoại **Use key** đã mở cho API Key bạn muốn dùng.

<Warning>
  API Key trong `auth.json` được lưu cục bộ dạng văn bản rõ. Không đưa `~/.codex/auth.json`, ảnh chụp hoặc đầu ra terminal vào repository hoặc cuộc trò chuyện.
</Warning>

## Cài đặt

Tải và cài Codex Desktop từ [tài liệu OpenAI Codex app](https://developers.openai.com/codex/app). Sau khi cài, mở ứng dụng và hoàn tất thiết lập ban đầu theo hướng dẫn của Codex Desktop.

Nếu Codex Desktop chưa có cho hệ điều hành của bạn, hãy dùng [Codex CLI](/vi/clients/codex) để truy cập bằng terminal.

## Sao chép cấu hình từ bảng điều khiển

<Steps>
  <Step title="Mở API Keys">
    Mở bảng điều khiển và vào **API Keys**.
  </Step>

  <Step title="Chọn Codex CLI">
    Tìm key muốn dùng cho Codex Desktop, nhấn **Use key**, rồi chọn **Codex CLI**.
  </Step>

  <Step title="Chọn hệ điều hành">
    Chọn **macOS / Linux** hoặc **Windows**. Bảng điều khiển sẽ hiển thị đường dẫn tệp cấu hình tương ứng.
  </Step>

  <Step title="Ghi cấu hình cục bộ">
    Làm theo các bước cho hệ điều hành tương ứng trong trang [Codex](/vi/clients/codex) để ghi `config.toml` và `auth.json`.
  </Step>

  <Step title="Khởi động lại Codex Desktop">
    Lưu cấu hình, thoát hẳn Codex Desktop rồi mở lại.
  </Step>
</Steps>

## Đường dẫn tệp cấu hình

| Hệ điều hành  | `config.toml`                      | `auth.json`                      |
| ------------- | ---------------------------------- | -------------------------------- |
| macOS / Linux | `~/.codex/config.toml`             | `~/.codex/auth.json`             |
| Windows       | `%USERPROFILE%\.codex\config.toml` | `%USERPROFILE%\.codex\auth.json` |

Nếu bạn dùng Codex trong WSL, hãy cấu hình thư mục `~/.codex/` của WSL, không phải thư mục người dùng Windows.

Dùng các giá trị `model`, `review_model`, `base_url` và API Key được hiển thị trong bảng điều khiển. Xem trang [Codex](/vi/clients/codex) để biết ý nghĩa từng trường.

## Kiểm tra

Mở Codex Desktop, chọn một dự án cục bộ, rồi gửi một tác vụ rủi ro thấp:

```text theme={null}
Mô tả mục đích của dự án hiện tại trong một câu. Không sửa tệp.
```

Nếu Codex Desktop phản hồi mà không báo lỗi xác thực hoặc lỗi mô hình, cấu hình đã có hiệu lực.

## Vấn đề thường gặp

<AccordionGroup>
  <Accordion title="Tôi đã cấu hình Codex CLI. Có cần làm lại không?">
    Không. Codex Desktop đọc cùng cấu hình `~/.codex/`. Hãy thoát hẳn Codex Desktop rồi mở lại.
  </Accordion>

  <Accordion title="Codex Desktop vẫn dùng mô hình hoặc địa chỉ cũ">
    Đặt cấu hình mới ở đầu `config.toml`. Lưu tệp, thoát hẳn Codex Desktop rồi mở lại.
  </Accordion>

  <Accordion title="Codex Desktop báo lỗi xác thực">
    Kiểm tra `auth.json` là JSON hợp lệ. Xác nhận API Key không thiếu ký tự, không có xuống dòng hoặc khoảng trắng thừa.
  </Accordion>

  <Accordion title="Codex Desktop không tìm thấy mô hình">
    `model` và `review_model` phải khớp chính xác với tên mô hình trong bảng điều khiển. Không sao chép từ ảnh của người khác.
  </Accordion>
</AccordionGroup>