Hướng dẫn tích hợp Kira AI vào Codex (ChatGPT)

Chuẩn bị thông tin cấu hình Kira AI

Trước tiên, bạn cần chuẩn bị các thông tin quan trọng sau từ hệ thống Kira AI:

// Kira AI Platform (kiraai.vn)
API URL:     https://kiraai.vn/api/v1
API Key:     https://kiraai.vn/developer/     ← Lấy key tại đây
Models:      https://kiraai.vn/models/        ← Xem danh sách model
Protocol:    Responses (native)             ← Chuẩn giao thức

Cài đặt và chuyển CC Switch sang giao diện tiếng Anh

Nếu chưa cài đặt, bạn tải CC Switch tại ccswitch.io (hỗ trợ macOS, Windows, Linux). Trong CC Switch, mở Settings → General và chọn English ở mục Language để đồng bộ giao diện.

Phóng to

Settings → General → Chọn English

Giữ phiên đăng nhập OpenAI chính thức (tùy chọn)

Nếu bạn muốn chuyển đổi qua lại thuận tiện giữa Kira AI và OpenAI Official, hãy vào Settings → General và bật Keep official login for direct switches trong phần Codex App Enhancements.

Phóng to

Bật "Keep official login for direct switches"

Thêm Codex provider mới trong CC Switch

Quay lại màn hình chính của CC Switch, chọn tab Codex trên thanh ứng dụng, sau đó nhấn vào nút + màu cam. Dưới mục Codex Provider, chọn Custom Configuration.

Phóng to

Click nút "+" → Chọn "Custom Configuration"

Điền thông tin cấu hình Kira AI vào form

Điền đầy đủ và chính xác các trường dữ liệu sau vào form cấu hình provider:

Phóng to

Điền Provider Name, API Key, API Request URL = https://kiraai.vn/api/v1

Chọn giao thức Responses (native)

Mở rộng phần Advanced Options và thiết lập mục Upstream Format thành Responses (native).

Phóng to

Advanced Options → Upstream Format = Responses (native)

Kira AI hỗ trợ chuẩn Responses API native trực tiếp, tối ưu hóa tốc độ streaming và phản hồi mượt mà cho Codex mà không cần qua proxy chuyển đổi phức tạp. Nhấn nút Fetch Models để kiểm tra kết nối, xác thực API key và tải danh mục model mới nhất.

Lưu cấu hình và kích hoạt Kira AI

Nhấn Save để lưu cấu hình. Quay lại màn hình danh sách Codex provider, tìm thẻ Kira AI và click vào nút Enable.

Phóng to

Click "Save" rồi click "Enable" để kích hoạt provider Kira AI

Thẻ Kira AI sẽ được làm nổi bật với viền sáng và trạng thái In Use khi kích hoạt thành công.

Phóng to

Provider Kira AI đã được kích hoạt thành công — hiển thị "In Use"

CC Switch tự động tạo và cập nhật file cấu hình Codex. Nội dung tương đương được sinh ra trong file ~/.codex/config.toml:

model_provider = "custom"
model = "your-model-id"

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://kiraai.vn/api/v1"

Khởi động lại và kiểm tra phản hồi của Codex

Thoát hoàn toàn và mở lại ứng dụng Codex (hoặc mở một phiên làm việc mới trên Codex CLI). Thao tác này giúp nạp lại toàn bộ cấu hình provider mới.

Gửi câu lệnh kiểm tra mẫu sau vào Codex:

Reply with exactly: Kira AI Codex connection successful

Phóng to

Codex đã kết nối Kira AI thành công — hiển thị "⚙ Kira AI" ở góc dưới bên trái và phản hồi prompt mượt mà

Cách đổi sang các model AI khác

Khi kết nối đã ổn định, bạn có thể chỉnh sửa cấu hình provider trong CC Switch để đổi sang các model AI đa dạng khác trong kho tài nguyên của Kira AI.

web_search = "disabled"

Chuyển về OpenAI Official khi cần

Khi cần sử dụng lại tài khoản OpenAI chính thức, trong ứng dụng CC Switch bạn chỉ cần tìm thẻ OpenAI Official và click Enable.

Phóng to

Click "Enable" tại OpenAI Official để quay về provider mặc định

Bạn cũng có thể kiểm tra trạng thái đăng nhập tài khoản chính thức qua lệnh CLI:

codex login status