> ## 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.

# Tiện ích Codex cho VS Code

> Dùng lại cấu hình Codex CLI của 4096bytes trong VS Code

Tiện ích Codex cho VS Code có thể dùng lại cấu hình cục bộ của Codex CLI. Trước tiên hãy cấu hình `config.toml` và `auth.json`, rồi cài tiện ích Codex trong VS Code.

Nếu bạn đã hoàn tất cấu hình [Codex](/vi/clients/codex), hãy cài tiện ích và khởi động lại VS Code. 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).
* VS Code đã được cài.
* Bạn đã hoàn tất cấu hình Codex CLI trong trang [Codex](/vi/clients/codex).
* 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 cấu hình Codex CLI

Trước tiên hãy hoàn tất [cấu hình Codex CLI](/vi/clients/codex). Bước này ghi thông số kết nối 4096bytes vào thư mục cấu hình Codex cục bộ.

| 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` |

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.

Nếu bạn dùng VS Code Remote - WSL, hãy ghi cấu hình vào thư mục `~/.codex/` của WSL.

## Cài tiện ích VS Code

<Steps>
  <Step title="Mở Extensions">
    Mở bảng **Extensions** trong VS Code.
  </Step>

  <Step title="Cài tiện ích Codex">
    Tìm tiện ích Codex do OpenAI phát hành, rồi nhấn **Install**.
  </Step>

  <Step title="Khởi động lại VS Code">
    Sau khi cài, đóng toàn bộ cửa sổ VS Code rồi mở lại dự án.
  </Step>

  <Step title="Dùng Codex">
    Mở mục Codex trong VS Code. Tiện ích sẽ đọc cấu hình Codex cục bộ.
  </Step>
</Steps>

## Kiểm tra

Mở một dự án cục bộ và gửi một tác vụ rủi ro thấp trong tiện ích Codex:

```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 tiện ích 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. Tiện ích Codex cho VS Code đọc cùng cấu hình `~/.codex/`. Hãy cài tiện ích rồi khởi động lại VS Code.
  </Accordion>

  <Accordion title="Tiện ích 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, đóng toàn bộ cửa sổ VS Code rồi mở lại dự án.
  </Accordion>

  <Accordion title="Tiện ích 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="Remote - WSL không dùng cấu hình">
    Nếu dự án chạy trong WSL, hãy cấu hình `~/.codex/` của WSL, không chỉ `%USERPROFILE%\.codex\` trên Windows.
  </Accordion>
</AccordionGroup>