Cách dùng Codex — từ cài đặt đến dùng bằng khóa API không cần thuê bao, kèm chi phí thực tế cho một tác vụ

Codex là tác nhân lập trình của OpenAI. Cách sử dụng cơ bản là cài đặt Codex CLI chạy trong terminal (npm install -g @openai/codex), chạy codex trong kho lưu trữ cần làm việc rồi yêu cầu bằng tiếng Hàn. Có hai cách bắt đầu: đăng nhập bằng gói ChatGPT (Plus · Pro · Business, v.v.) để dùng trong hạn mức, hoặc chạy bằng khóa API và chỉ trả theo số token đã sử dụng. Vì hầu hết bài viết hướng dẫn sử dụng trong nước chỉ đề cập cách thứ nhất, bài này lần lượt tổng hợp cách thứ hai — cài đặt để chạy Codex CLI không cần thuê bao, cách chọn mô hình cho từng tác vụ và chi phí thực tế của một tác vụ. Giới hạn theo gói và các lựa chọn khi dùng hết hạn mức được tổng hợp riêng tại Giới hạn sử dụng Codex.

Codex không phải công cụ để dán mã vào khung trò chuyện; đây là một tác nhân đọc và chỉnh sửa tệp trong kho lưu trữ, đồng thời chạy kiểm thử và lệnh. Sau khi chạy, bạn có thể quyết định giao cho nó việc gì mà không cần xác nhận tại /permissions.

Hai cách sử dụng Codex

Nếu chạy bằng khóa API, hóa đơn được tính riêng với mức sử dụng của gói ChatGPT. Bạn có thể dùng nguyên khóa API OpenAI, nhưng bài này hướng dẫn cách kết nối qua endpoint tương thích Responses API. Có thể chuyển đổi từ GPT-6 Astra đến GPT-5.6 Terra bằng cùng một khóa; ví dụ, GPT-5.6 Sol có giá $2,00 / $12,00 trên mỗi 1M token, so với giá niêm yết OpenAI $5,00 / $30,00(OpenAI hiện cung cấp với giá khuyến mãi $4,00 / $20,00, và theo trang giá thì mức giá này được duy trì ít nhất đến 21 tháng 11, 2026) (mức giá được đọc trực tiếp từ danh mục).

Cài đặt Codex — npm hoặc Homebrew

# npm (Node.js만 있으면 macOS / Linux / Windows 공통)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

Cả hai phương pháp đều là cách cài đặt trong README chính thức của OpenAI. Trên Windows cũng có thể cài bằng lệnh npm. Sau khi cài xong, nhập codex trong thư mục kho lưu trữ cần làm việc để chạy. Nếu bạn định đăng nhập bằng ChatGPT thì đến đây là xong; không cần cài đặt bên dưới.

Cấp và thiết lập khóa API Codex — một khối config.toml

Trước tiên, đăng ký và nạp từ $10, sau đó tạo khóa tại màn hình khóa API. Khóa chỉ hiển thị một lần, vì vậy hãy lưu ngay. Tiếp theo, thêm một khối provider vào tệp cấu hình Codex.

# ~/.codex/config.toml (없으면 새로 만듭니다)
model          = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"   # 키 자체가 아니라 「환경 변수 이름」
wire_api = "responses"        # 유일하게 유효한 값. 생략해도 같습니다

Nơi dễ nhầm nhất là env_key. Giá trị nhập ở đây là tên biến môi trường chứa khóa, không phải chính khóa. Vì khóa không nằm trong tệp cấu hình, config.toml an toàn để commit hoặc dán vào bài hỏi.

# env_key에 적은 이름의 변수에 키를 넣습니다 (키는 sk-kn-으로 시작)
export KUNAVO_API_KEY="sk-kn-..."

# 매번 export하지 않도록, 쓰는 셸의 설정 파일에 추가해 둡니다
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Nếu dùng Windows PowerShell, hãy chạy setx KUNAVO_API_KEY sk-kn-... rồi mở terminal mới. Vị trí tệp cấu hình là %USERPROFILE%\.codex\config.toml. Trước khi chạy Codex, gửi một yêu cầu để xác nhận khóa và endpoint sẽ giúp dễ phân tách vấn đề hơn.

# 코덱스를 의심하기 전에, 키와 엔드포인트만 요청 한 번으로 확인합니다
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5-6-sol", "input": "OK라고만 답해줘"}'

Nếu JSON trả về, khóa và endpoint hoạt động bình thường; vấn đề còn lại nằm ở phía config.toml. Các mục cấu hình có trong Tài liệu tích hợp Codex CLI (tiếng Anh), còn phần giải thích cả cách gọi mô hình Claude từ Codex có tại Hướng dẫn khóa API Codex CLI (tiếng Anh).

Tác vụ đầu tiên

# 1. 작업할 저장소로 들어가 실행합니다
cd ~/work/my-app
codex

# 2. AGENTS.md 초안을 만들게 합니다 (테스트 실행법이나 규칙을 적는 파일)
> /init

# 3. 이후엔 한국어로 요청합니다. 파일 경로를 붙일수록 빠르고 싸게 끝납니다
> src/utils/date.test.ts가 실패해. 원인을 찾아서 고치고 테스트가 통과하는지 확인해줘

/init tạo ra AGENTS.md — một tệp ghi các “quy tắc không thể biết chỉ bằng cách đọc mã”, chẳng hạn cách chạy kiểm thử, thư viện được sử dụng và các đường dẫn không được chạm vào; tệp này sẽ được tự động đọc trong các phiên sau. Nội dung được tạo chỉ là bản nháp, hãy chỉnh sửa thủ công.

Cách yêu cầu tương tự Claude Code: đính kèm đường dẫn tệp và không giao một tác vụ lớn trong một lần. Điều này giảm token dùng cho việc khám phá, giúp kết quả nhanh và chính xác hơn, đồng thời giảm số tiền bị tính. Cách vận hành Claude Code được tổng hợp tại Cách sử dụng Claude Code.

Chọn mô hình cho từng tác vụ — chi phí thực tế của một tác vụ

Ưu điểm lớn nhất của việc chạy bằng khóa API là có thể chọn mô hình phù hợp với độ nặng của tác vụ. model chỉ là tên mô hình của endpoint, nên không cần khóa mới hay thiết lập bổ sung khi thay đổi.

# config.toml의 기본값(gpt-5-6-sol)은 그대로 두고, 이번 실행만 모델을 바꿉니다
codex -m gpt-6-astra     # 원인을 모르는 버그, 여러 모듈에 걸친 변경
codex -m gpt-5-6-terra   # 정형화된 수정, 일괄 치환, 로그 요약 같은 가벼운 작업

“Một tác vụ” được tính là sửa một kiểm thử thất bại trong 20 bước. Một bước gồm 25.000 token đầu vào (lời nhắc hệ thống + lịch sử trò chuyện + tệp đã đọc) và 1.200 token đầu ra (một lần chỉnh sửa hoặc giải thích), nên một tác vụ gồm 500.000 token đầu vào · 24.000 token đầu ra. Nếu là GPT-5.6 Sol thì $1,29, cùng số token nếu trả trực tiếp cho OpenAI sẽ là $2,48 theo giá khuyến mại hiện tại (theo giá niêm yết là $3,22). Mô hình càng rẻ càng có thể phải sửa đi sửa lại, làm tăng số lượt trao đổi; cách thực tế là nâng lên một cấp nếu không hoàn thành trong một lần. Để nhập trực tiếp số token của bạn, hãy dùng Công cụ tính chi phí.

Phép tính này chưa tính đến bộ nhớ đệm. Codex gửi lại lịch sử trò chuyện ở mỗi bước, vì vậy đầu vào đã lưu trong bộ nhớ đệm được tính bằng 0.10 lần đơn giá đầu vào (theo GPT-5.6 Sol, $0,20 trên mỗi 1M token), còn phần mới ghi vào bộ nhớ đệm được tính bằng 1.25 lần đơn giá đầu vào. Ngoài ra, với dòng GPT-5.6 và GPT-6 Astra, nếu lời nhắc của một yêu cầu vượt quá 272K token thì toàn bộ yêu cầu đó bị tính bằng 2 lần đầu vào · 1.5 lần đầu ra. Không nên dồn quá nhiều tác vụ vào một phiên; an toàn hơn là chạy một phiên mới cho từng tác vụ. Token suy luận được tính như đầu ra, nên tác vụ càng khó thì đầu ra càng tăng. Số tiền thực tế có thể kiểm tra trong usage và lịch sử sử dụng của phản hồi. Thông số mô hình có tại trang mô hình GPT-5.6 Sol, mức giá đầy đủ có tại bảng giá, và bảng so sánh song song mức giá token của các mô hình GPT mà Codex sử dụng có tại Giá GPT API.

Các lỗi thường gặp

Nói thẳng — khi gói ChatGPT tốt hơn

Nếu bạn làm việc với Codex vài giờ mỗi ngày, gói cố định thường rẻ hơn. Gói trả theo mức sử dụng tỷ lệ thuận trực tiếp với số token, nên dùng càng nhiều và càng đều thì lợi thế của gói cố định càng lớn. Tiêu chí là “phí hàng tháng ÷ đơn giá một tác vụ”; điểm hòa vốn so với từng gói đã được tính tại Giá Codex.

Còn hai điểm cần biết. Theo tài liệu OpenAI, các tính năng phụ thuộc vào không gian làm việc ChatGPT hoặc đám mây có thể bị hạn chế hoặc không dùng được khi sử dụng khóa API. Ngoài ra, đường dẫn Kunavo là dung lượng dùng chung, không có quota riêng cũng như SLA theo hợp đồng. Nếu cần hạn mức hoặc SLA được bảo đảm, nên ký hợp đồng trực tiếp với OpenAI.

Ngược lại, khóa API phù hợp với người có chênh lệch lớn giữa ngày dùng và ngày không dùng, người muốn chọn mô hình cho từng tác vụ, người muốn chia hạn mức và lịch sử sử dụng theo từng khóa trong nhóm, hoặc người chỉ muốn tiếp tục làm việc vào những ngày đã dùng hết hạn mức gói. Có thể dùng cả hai. Xóa dòng model_provider trong config.toml để quay lại đăng nhập ChatGPT; nếu muốn thay đổi mỗi lần chạy, hãy dùng --profile của Codex.

Có thể nạp Kunavo bằng thẻ, Apple Pay, Google Pay, v.v.; khi trang thanh toán hiển thị bằng won, Kakao Pay, Naver Pay, PAYCO, Samsung Pay và thẻ nội địa (bao gồm cả thẻ chưa bật thanh toán quốc tế) cũng xuất hiện. Toss không được hỗ trợ. Số dư không có thời hạn sử dụng và các yêu cầu thất bại không bị tính phí. Nếu bạn đang phân vân giữa Codex và Claude Code, hãy tham khảo So sánh Codex với Claude Code.

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