Cách dùng Codex — từ cài đặt đến chạy bằng khóa API không cần thuê bao

Codex là tác nhân lập trình của OpenAI. Cách sử dụng cơ bản là cài Codex CLI chạy trong terminal (npm install -g @openai/codex), khởi chạy codex trong repository muốn làm việc và yêu cầu bằng tiếng Nhật. Có 2 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ả cho số token đã sử dụng. Vì các bài hướng dẫn tiếng Nhật hầu như chỉ đề cập cách thứ nhất, trang này lần lượt giải thích cách thứ hai — thiết lập Codex CLI không cần thuê bao, cách chọn mô hình theo tác vụ và chi phí thực tế của một tác vụ.

Codex không phải công cụ để dán mã vào màn hình trò chuyện; đây là tác nhân đọc và sửa tệp trong repository, đồng thời chạy kiểm thử và lệnh. Bạn có thể quyết định mức độ cho phép tác nhân làm mà không cần xác nhận bằng /permissions sau khi khởi chạy.

2 cách sử dụng Codex

Khi chạy bằng khóa API, chi phí được tính riêng với hạn mức gói OpenAI. Bạn cũng có thể dùng trực tiếp khóa API OpenAI, nhưng trang này trình bày cách trỏ đến điểm cuối tương thích với 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 của OpenAI là $5,00 / $30,00(OpenAI hiện cung cấp với giá khuyến mãi $4,00 / $20,00; theo trang giá thì ít nhất đến 21 tháng 11, 2026) (mức giá được tải trực tiếp từ danh mục).

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

# npm（Node.js が入っていれば macOS / Linux / Windows 共通）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Cả hai đều là phương pháp được nêu 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, nhập codex trong thư mục repository muốn làm việc để khởi chạy. Nếu đăng nhập bằng ChatGPT thì đến đây là xong, không cần cấu hình thêm.

Chạy bằng khóa API — 1 block trong config.toml

Trước tiên, tạo tài khoản, nạp tiền từ $10 và tạo khóa tại trang khóa API. Khóa chỉ hiển thị một lần, nên hãy lưu lại ngay. Tiếp theo, viết một block provider trong 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"        # 唯一の有効値。省略しても同じ

Điểm dễ nhầm nhất ở đây là env_key. Bạn cần ghi 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 có thể được commit nguyên trạng hoặc dán vào câu hỏi một cách an toàn.

# env_key で指定した名前の変数にキーを入れる（キーは sk-kn- で始まる）
export KUNAVO_API_KEY="sk-kn-..."

# 毎回 export しないよう、使っているシェルの設定ファイルに追記しておく
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Trong PowerShell của Windows, chạy setx KUNAVO_API_KEY sk-kn-... rồi mở lại một terminal mới. Vị trí tệp cấu hình là %USERPROFILE%\.codex\config.toml. Trước khi khởi chạy Codex, nên xác minh khóa và điểm cuối bằng một yêu cầu duy nhất để việc phân loại lỗi sau đó dễ dàng hơn.

# Codex を疑う前に、キーとエンドポイントだけを 1 回で確かめる
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 nhận được JSON thì khóa và điểm cuối đều hoạt động bình thường; nếu vẫn còn vấn đề, nguyên nhân nằm ở phía config.toml. Chi tiết các mục cấu hình có trong tài liệu tích hợp Codex CLI (tiếng Anh); hướng dẫn bao gồm cả cách gọi mô hình Claude từ Codex có tại hướng dẫn thiết lập khóa API cho 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 AGENTS.md — một tệp ghi các quy ước “không thể biết chỉ bằng cách đọc mã”, như cách chạy kiểm thử, thư viện sử dụng và các đường dẫn không được chạm vào — và tự động đọc tệp này 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.

Mẹo yêu cầu cũng giống Claude Code: đính kèm tên và đường dẫn tệp và không gửi một yêu cầu lớn cùng lúc. Khi giảm số token dùng cho việc khám phá, kết quả sẽ nhanh và chính xác hơn, đồng thời hóa đơn cũng thấp hơn. Có thể điều chỉnh tần suất hộp thoại xác nhận bằng /permissions. Cách vận hành phía Claude Code được tổng hợp trong cách sử dụng Claude Code.

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

Lợi ích 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 công việc. model chỉ là tên mô hình trên điểm cuối, nên không cần thêm khóa hay cấu hình khi chuyển đổ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à 20 bước để sửa một kiểm thử bị lỗi. Mỗi bước gồm 25.000 token đầu vào (system prompt + lịch sử hội thoại + 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ụ có 500.000 token đầu vào và 24.000 token đầu ra. Với GPT-5.6 Sol là $1,29; nếu trả trực tiếp cho OpenAI cùng số token, giá khuyến mãi hiện tại là $2,48 (giá niêm yết là $3,22). Mô hình rẻ hơn có thể làm tăng số vòng lặp do phải làm lại, nên cách thực tế là nâng lên một bậc nếu không hoàn tất trong một lần.

Tính toán này chưa tính đến bộ nhớ đệm. Codex gửi lại lịch sử hội thoại ở mỗi bước, nên đầu vào được lưu trong bộ nhớ đệm bị tính bằng 0,10 lần đơn giá đầu vào (với GPT-5.6 Sol là $0,20 trên mỗi 1M token), còn phần mới ghi vào bộ nhớ đệm bị 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 prompt của một yêu cầu vượt quá 272K token, toàn bộ yêu cầu đó bị tính bằng 2 lần cho đầu vào và 1,5 lần cho đầu ra. Không nên dồn quá nhiều công việc vào một phiên; hãy khởi chạy lại theo từng tác vụ. Token suy luận của mô hình reasoning được tính như đầu ra, nên tác vụ càng khó thì đầu ra càng tăng. Kiểm tra chi phí thực tế trong usage của phản hồi và lịch sử sử dụng. Thông số mô hình có tại trang mô hình GPT-5.6 Sol, còn đơn giá của mọi mô hình có tại bảng giá.

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

Nói thẳng — khi gói ChatGPT có lợi hơn

Nếu làm việc và tương tác với Codex nhiều giờ mỗi ngày, gói có phí cố định thường rẻ hơn. Thanh toán theo mức sử dụng tỷ lệ trực tiếp với số token, nên lợi ích của gói có phí cố định càng lớn đối với người có mức sử dụng cao và ổn định. Điểm hòa vốn là “phí tháng ÷ đơn giá một tác vụ”; phép tính điểm hòa vốn so với gói được trình bày trong giá Codex.

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

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, muốn chọn mô hình theo từng tác vụ, muốn tách giới hạn và lịch sử sử dụng theo từng khóa trong nhóm, hoặc chỉ muốn tiếp tục làm việc vào những ngày đã hết hạn mức của gói. Hai cách có thể kết hợp. Xóa dòng model_provider trong config.toml sẽ quay lại đăng nhập ChatGPT; nếu muốn chuyển đổi theo từng lần khởi chạy, có thể dùng --profile của Codex.

Thanh toán bằng thẻ (bao gồm JCB), Apple Pay, Google Pay, v.v.; số dư không có hạn sử dụng. Không hỗ trợ thanh toán tại cửa hàng tiện lợi hoặc PayPay. Các yêu cầu thất bại không bị tính phí. Nếu bạn phân vân nên dùng Codex hay Claude Code, hãy tham khảo So sánh Codex và Claude Code.

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