Codex CLI: khóa riêng thay vì gói thuê bao

Codex không phải là công cụ gợi ý trong trình soạn thảo mà là một trình thực thi độc lập. Bạn diễn đạt tác vụ bằng lời nói, nó tự quyết định tệp nào cần đọc, lệnh nào cần thực thi và cái gì cần thay đổi. Nó có trong tay khoảng chục công cụ: chạy lệnh, đọc tệp, duy trì kế hoạch công việc, yêu cầu người dùng làm rõ, tạo các tác vụ phụ.

Hai chế độ hoạt động. Tương tác — codex không có đối số, cuộc đối thoại trong terminal với việc hiển thị từng bước. Không tương tác — codex exec «tác vụ», chạy một lần cho đến khi có kết quả: thuận tiện trong script và CI.

Bảo mật được tích hợp sẵn: theo mặc định, tác vụ hoạt động trong sandbox và yêu cầu xác nhận trước khi thay đổi. Mức độ kiểm soát được đặt trong cấu hình — từ "hỏi mọi thứ" đến chạy hoàn toàn tự động với quyền ghi vào thư mục làm việc.

Một đặc điểm nữa là trạng thái hội thoại. Codex không yêu cầu máy chủ ghi nhớ bất cứ điều gì: nó giữ toàn bộ luồng hội thoại và gửi nó đi hoàn toàn với mỗi lượt. Đối với bạn, điều này có nghĩa là cuộc trò chuyện không bị lưu lại phía nhà cung cấp mô hình, và việc thay đổi endpoint không làm hỏng phiên đang bắt đầu.

Sự khác biệt với Claude Code và các tác vụ terminal khác chính là giao thức. Codex giao tiếp với mô hình thông qua Responses API, nơi cuộc đối thoại không được mô tả bằng danh sách tin nhắn phẳng mà bằng luồng các phần tử: văn bản, lệnh gọi công cụ, kết quả lệnh gọi, khối lập luận. Điều này mang lại cho công cụ một mô hình đối thoại chặt chẽ hơn, và đối với bạn là yêu cầu phải có một endpoint hiểu được giao thức này.

Codex lưu trữ cài đặt trong ~/.codex/config.toml. Nhà cung cấp của bạn được mô tả bằng khối [model_providers.*], và trường quan trọng ở đây là wire_api: nếu không có nó, Codex sẽ cố gắng nói chuyện bằng Chat Completions và sẽ không thiết lập được vòng lặp tác vụ.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

Khóa không được ghi vào tệp: env_key đặt tên cho biến môi trường mà Codex sẽ lấy khóa từ đó. Tên biến là riêng của bạn, không phải OPENAI_API_KEY — nhờ vậy cài đặt không ảnh hưởng đến các công cụ khác của bạn đang hoạt động với OpenAI.

export JOINGONKA_API_KEY=jg-khoa-cua-ban

Trường model đặt mô hình mặc định, còn model_provider là khối nào trong số các khối được mô tả sẽ được sử dụng. Cả hai đều có thể ghi đè tại thời điểm khởi chạy, vì vậy một cấu hình có thể phục vụ nhiều nhà cung cấp: công việc, thử nghiệm và dự phòng.

Khóa được cấp trong bảng điều khiển cá nhân sau khi đăng ký, tại đó bạn cũng thấy số dư và mức tiêu thụ. Nếu bạn không muốn thay đổi cấu hình chung, khối tương tự có thể được truyền một lần thông qua -c: codex -c model_provider=joingonka …. Và để giữ nhiều cấu hình độc lập, hãy chỉ định thư mục cài đặt trong biến CODEX_HOME.

Cách nhanh nhất để đảm bảo kết nối hoạt động là chạy thử một lần:

codex exec "Trả lời bằng một dòng: 17*3 bằng bao nhiêu?"

Trong phần đầu của phản hồi, Codex sẽ hiển thị người mà nó đang làm việc cùng: model, provider: joingonka, chế độ sandbox và session ID. Nếu đúng provider của bạn và có phản hồi bên dưới, kết nối đã hoạt động.

Tiếp theo, hãy kiểm tra tính năng quan trọng nhất mà Codex mang lại — làm việc với tệp. Hãy đặt một tệp nhỏ có lỗi rõ ràng vào thư mục và yêu cầu nó tìm lỗi:

codex exec "Đọc calc.py và nói bằng một câu xem có lỗi không."

Tác nhân sẽ tự gọi công cụ đọc, mở tệp và phản hồi chính xác, bao gồm cả số dòng. Nếu điều này xảy ra, toàn bộ chu trình tác nhân (yêu cầu → gọi công cụ → kết quả → phản hồi) thông qua gateway đã được thiết lập chính xác.

Nếu có sự cố xảy ra, chẩn đoán thường nằm ngay trong thông báo lỗi:

Yêu cầu đầu tiên trong phiên có thể mất vài giây: Codex gửi một system prompt lớn và mô tả của tất cả công cụ, còn node mạng cần thời gian để tiếp nhận tác vụ. Các phản hồi tiếp theo sẽ nhanh hơn.

Tất cả các mô hình trong mạng đều có cùng mức giá, vì vậy việc lựa chọn phụ thuộc vào hành vi chứ không phải ngân sách. Dưới đây là kết quả thực tế của cùng một tác vụ (đọc tệp và tìm lỗi) thông qua Codex trên mỗi mô hình.

Khuyến nghị mặc định là DeepSeek V4 Flash: công việc tác nhân thường nhanh chóng chạm giới hạn ngữ cảnh, và 380K token cho phép lưu trữ nhiều tệp cùng lúc. Nếu muốn phản hồi ngắn gọn nhất, hãy chọn Kimi K2.6. Bạn có thể thay đổi mô hình bằng một dòng model trong tệp cấu hình hoặc cờ -c model=… mà không cần sửa file.

Danh sách mô hình mạng hiện tại luôn có tại GET https://gate.joingonka.ai/v1/models.

Các công cụ tác nhân tiêu tốn token khác với chat thông thường: với mỗi câu của bạn, Codex thêm system prompt và mô tả tất cả công cụ, sau đó thực hiện đối thoại đa bước với mô hình. Trong lần chạy thực tế, một tác vụ đơn giản "đọc tệp và tìm lỗi" tiêu tốn khoảng 18-20 nghìn token. Đây là cái giá hợp lý cho quyền tự chủ, và đó là lý do tại sao giá mỗi token lại quan trọng.

Thông qua JoinGonka Gateway, token có giá $0.0047 mỗi triệu input và $0.014 mỗi triệu output — giá giống nhau cho tất cả mô hình mạng và được lấy từ nguồn trực tiếp trên trang này.

Để so sánh — cách thức tính phí của bản thân Codex và các đối thủ trong cùng phân khúc:

Thanh toán dựa trên mức tiêu thụ thực tế, không có phí thuê bao hàng tháng và không có hạn ngạch: không có cửa sổ 5 giờ, không giới hạn "prompt" và không nhân hệ số trong giờ cao điểm. Số dư được nạp bằng tiền điện tử, số dư còn lại và chi tiêu hàng ngày được hiển thị trong tài khoản cá nhân. Phân tích kinh tế chi tiết có trong bài viết về API AI rẻ nhất.

Lịch sử hội thoại được lưu giữ bởi chính Codex. Nó gửi toàn bộ lịch sử với mỗi yêu cầu và không yêu cầu máy chủ ghi nhớ bất kỳ điều gì — và chúng tôi cũng không lưu trữ các cuộc hội thoại. Mã nguồn và các prompt của bạn không còn nằm trên gateway sau khi có phản hồi.

Tìm kiếm web hoạt động tốt. Codex khai báo công cụ tìm kiếm trong mỗi yêu cầu và gateway chấp nhận nó: việc tìm kiếm được thực hiện ở phía chúng tôi, kết quả được trộn vào phản hồi của mô hình.

Các công cụ là cục bộ, không phải trên đám mây. Codex thực thi các lệnh và đọc tệp cục bộ, ngay trên máy của bạn, vì vậy quyền truy cập vào dự án không phụ thuộc vào nhà cung cấp mô hình.

Sandbox. Trên Linux, Codex sử dụng bubblewrap để cách ly các lệnh đang chạy. Nếu hệ thống không có, Codex sẽ cảnh báo và sử dụng bản sao tích hợp sẵn — điều này không ảnh hưởng đến công việc, nhưng việc cài đặt gói qua trình quản lý hệ thống sẽ thuận tiện hơn.

Nếu bạn cần làm việc với hình ảnh — như ảnh chụp màn hình giao diện, sơ đồ trên ảnh — hãy sử dụng công cụ với mô hình có khả năng thị giác cho các tác vụ đó: các mô hình trong mạng lưới Gonka là mô hình văn bản. Đối với mã, lệnh và tệp, đây không phải là hạn chế.

Nếu Codex không phù hợp, hãy thử các agent terminal khác: hướng dẫn API nhanh cho thấy cách kết nối bất kỳ công cụ tương thích nào chỉ trong vài phút.