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

# Codex CLI

> Hướng dẫn này giúp bạn bắt đầu dùng Codex với Harogo chỉ trong vài phút.

> [!NOTE]
>
> **Hướng dẫn này chỉ dùng mô hình GPT.** Codex có thể chạy các mô hình GPT (GPT-6 Luna, GPT-6 Sol, GPT-6.1 Sol, GPT-6 Astra, GPT-6.1 Terra) cùng các mô hình không bị giới hạn ứng dụng (GLM, Qwen, Kimi, MiniMax, DeepSeek). Mô hình Claude không dùng được trong Codex — xem [Claude Code](https://docs.harogo.ai/vi/claude-code.md).

## Cài đặt

### Tải từ trang chính thức (macOS)

[https://openai.com/codex/](https://openai.com/codex/)

### Cài đặt qua dòng lệnh

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

## Cấu hình biến môi trường

### Cấu hình qua tệp cấu hình

1. Mở tệp `~/.codex/config.toml` và thêm nội dung sau:

```toml theme={null}
profile = "harogo"

[model_providers.harogo]
name = "harogo"
base_url = "https://api.harogo.ai/v1"
personality = "pragmatic"
wire_api = "responses"

[profiles.harogo]
model = "gpt-6.1-sol"
model_provider = "harogo"
model_reasoning_effort = "high"
```

2. Mở tệp `~/.codex/auth.json` và cập nhật như sau:

```json theme={null}
{
  "OPENAI_API_KEY": "HAROGO_API_KEY"
}
```

### Cấu hình qua cc-switch

1. Mở CC-Switch và thêm một nhà cung cấp.

![Màn hình Thêm nhà cung cấp trong CC-Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.20.12.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=b32819dab1fb874d6a712ff40c47ec67)

2. Trong danh sách cài đặt sẵn, chọn "Cấu hình tùy chỉnh" (Custom Configuration).

![Chọn Custom Configuration trong danh sách cấu hình sẵn của CC-Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.20.35.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=7173cc1be95b8e0b48d92262970e32e3)

3. Điền tên nhà cung cấp, API key, endpoint ([https://api.harogo.ai/v1](https://api.harogo.ai/v1)) và các thông tin khác. Điền xong, nhấp "Thêm" (Add).

![Nhập API key và lưu trong CC-Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.22.08.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78f30c9346778ba163f526c96cd6dc6c)

4. Quay lại màn hình chính, chọn "harogo" và nhấp "Bật" (Enable) để bắt đầu sử dụng.

![Bật nhà cung cấp harogo trên CC-Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.27.33.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=f9fd7cc10375932aa2ab49c49f141301)

## Sử dụng Codex

### Trong terminal

1. Mở terminal, chuyển đến thư mục dự án của bạn, rồi chạy lệnh `codex`.

```bash theme={null}
cd /path/to/your/project
codex
```

2. Thiết lập quyền theo nhu cầu.

![Thiết lập quyền phê duyệt khi khởi động Codex](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.31.13.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=ebb754f23dfe9d16d878e3399dc1e9c2)

3. Nhập một prompt bằng ngôn ngữ tự nhiên — nếu nhận được phản hồi bình thường, nghĩa là bạn đã thiết lập thành công.


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