Cấu hình Codex CLI dùng TaiKhoanGiaRe qua config.toml

Hướng dẫn trỏ Codex CLI sang TaiKhoanGiaRe bằng config.toml hoặc lệnh cài một dòng, chọn model gpt-6-astra và kiểm tra chi phí thực tế.

Codex CLI là công cụ coding agent chạy trong terminal, dùng các model dòng GPT để đọc, sửa và chạy code trực tiếp trong thư mục dự án. Bài này hướng dẫn trỏ Codex CLI sang TaiKhoanGiaRe để dùng model gpt-6-astra với base URL https://taikhoangiare.vn/v1, theo đúng hướng dẫn tại trang Codex CLI.

Trước khi bắt đầu: cần gì

Bạn cần một tài khoản TaiKhoanGiaRe (đăng ký ở /login.html, tài khoản mới có credit thử miễn phí) và API key của mình. Mỗi tài khoản chỉ có đúng một secret key, tạo sẵn khi đăng ký, bạn chỉ cần bấm Show để xem hoặc Rotate nếu muốn đổi key (Rotate sẽ vô hiệu key cũ). Lấy key trong tab API keys ở /dashboard.html, hoặc xem cách lấy key và test nhanh ở bài Lấy API key và gọi thử bằng cURL trong 3 phút.

Cách nhanh nhất: lệnh cài một dòng

Trang hướng dẫn Codex CLI tại /integrations.html?app=codex có sẵn bước chạy lệnh cài một dòng /v1/setup-codex, với key của bạn đã được điền sẵn trong hướng dẫn. Chỉ cần copy đúng lệnh hiển thị trên trang (đã gắn key) và chạy trong terminal, Codex CLI sẽ được cấu hình sẵn để gọi qua TaiKhoanGiaRe. Đây là cách đỡ phải gõ tay nhất, phù hợp nếu bạn chỉ muốn dùng ngay.

Phần dưới đây giải thích cấu hình đó thực chất ghi gì vào config.toml, để bạn hiểu và chỉnh tay khi cần.

Cấu hình thủ công qua config.toml

Codex CLI đọc cấu hình từ file config.toml trong thư mục cấu hình của nó (thường là ~/.codex/config.toml). Để trỏ sang TaiKhoanGiaRe, bạn khai báo một model provider mới rồi chọn nó làm provider và model mặc định:

model = "gpt-6-astra"
model_provider = "taikhoangiare"

[model_providers.taikhoangiare]
name = "TaiKhoanGiaRe"
base_url = "https://taikhoangiare.vn/v1"
env_key = "TAIKHOANGIARE_API_KEY"
wire_api = "chat"

Giải thích từng dòng:

• model: model mặc định Codex CLI sẽ gọi, ở đây là gpt-6-astra.
• model_provider: tên khối provider bạn khai báo bên dưới, phải khớp với [model_providers.taikhoangiare].
• base_url: đúng base URL tương thích OpenAI SDK của TaiKhoanGiaRe, https://taikhoangiare.vn/v1.
• env_key: tên biến môi trường chứa API key, Codex CLI sẽ đọc giá trị từ biến này khi gọi API.

Biến môi trường

Sau khi khai báo env_key trong config.toml, bạn cần set đúng biến môi trường đó trỏ tới secret key lấy từ tab API keys trong /dashboard.html:

# macOS / Linux
export TAIKHOANGIARE_API_KEY="sk-..."

# Windows PowerShell
$env:TAIKHOANGIARE_API_KEY="sk-..."

Nên thêm dòng export vào ~/.zshrc hoặc ~/.bashrc để không phải gõ lại mỗi lần mở terminal mới. Lưu ý xác thực ở đây dùng Authorization: Bearer theo chuẩn OpenAI SDK, Codex CLI tự ghép header này khi đọc biến môi trường từ env_key.

Kiểm tra kết nối và đổi model

Chạy Codex CLI và gửi một yêu cầu đơn giản để chắc cấu hình đúng:

codex "Viết một hàm Python kiểm tra số nguyên tố"

Nếu nhận được phản hồi code bình thường, cấu hình đã chạy. Muốn kiểm tra bằng cURL thuần trước khi đụng tới Codex CLI, xem thêm hướng dẫn ở bài Lấy API key và gọi thử bằng cURL trong 3 phút.

Muốn đổi sang model khác (ví dụ nhẹ hơn cho tác vụ đơn giản, hoặc mạnh hơn cho tác vụ phức tạp), chỉ cần sửa dòng model = "..." trong config.toml. Danh sách model và giá đầy đủ nằm ở /models.html, có bộ lọc theo vision/tools/reasoning.

Chi phí thực tế khi dùng gpt-6-astra

Codex CLI thường gửi lại khá nhiều context cũ (file, lịch sử chat) ở mỗi lượt, nên phần lớn token input sẽ được đọc từ cache với giá rẻ hơn. Với gpt-6-astra, dựa trên một lượt agent điển hình (100.000 token đọc cache + 5.000 token input mới + 1.000 token output):

Nếu quy đổi sang credit (1 credit = 55,8đ) để nạp tiền, bạn có thể tham khảo các gói ở /pricing.html, ví dụ gói Pro 279.000đ tương ứng 5000 credit. Nạp credit bằng VietQR qua PayOS, xem chi tiết ở bài Cách nạp credit TaiKhoanGiaRe bằng VietQR qua PayOS.

Vài lưu ý khi dùng lâu dài

Prompt caching được bật sẵn trên TaiKhoanGiaRe, nên các phần context lặp lại giữa các lượt (file lớn, hướng dẫn hệ thống) sẽ được tính theo giá cache thấp hơn giá input thường, đúng như trong bảng CALCULATOR phía trên. Nếu một job hay request lỗi phía hệ thống, credit tương ứng sẽ được hoàn lại, bạn không cần tự theo dõi thủ công.

Khi cần đổi key (ví dụ nghi lộ key), vào tab API keys trong dashboard và bấm Rotate, nhưng nhớ cập nhật lại biến môi trường env_key ở máy đang chạy Codex CLI, vì key cũ sẽ ngừng hoạt động ngay sau khi Rotate.

Tóm lại: cách nhanh nhất là chạy lệnh cài một dòng trên trang hướng dẫn Codex CLI, còn nếu muốn hiểu hoặc tự chỉnh, chỉ cần ba thứ trong config.toml: base_url đúng là https://taikhoangiare.vn/v1, env_key trỏ đúng biến môi trường chứa key, và model là id model bạn muốn dùng.

Câu hỏi thường gặp

Codex CLI có bắt buộc phải dùng lệnh cài một dòng không?

Không, lệnh cài một dòng ở trang hướng dẫn Codex CLI chỉ là cách nhanh. Bạn có thể tự sửa file config.toml như hướng dẫn trong bài để kiểm soát từng dòng cấu hình.

Base URL cho Codex CLI là gì?

Dùng base URL tương thích OpenAI SDK: https://taikhoangiare.vn/v1, khai báo trong khối model_providers của config.toml.

Dùng model nào với Codex CLI thì rẻ hơn gpt-6-astra?

Có thể xem toàn bộ model và giá ở /models.html rồi đổi giá trị trong dòng model = "..." của config.toml, ví dụ các model có giá input/output thấp hơn gpt-6-astra.

Nếu Codex CLI gọi lỗi thì credit có bị mất không?

Không, các job hoặc request lỗi phía hệ thống sẽ được hoàn lại credit tương ứng.

← Về trang Blog