Codex CLI

Để agent của tôi thiết lậpCopy Anchor Link

Sao chép nhiệm vụ này cho một agent đã hoạt động trên máy tính của bạn:

Đọc hướng dẫn này và giúp tôi kết nối Codex CLI với TokenLab:
https://tokenlab.sh/docs/vi/integrations/codex-cli
Trước tiên, kiểm tra phiên bản đã cài và cấu hình đang có hiệu lực.
Giữ nguyên các tài khoản, nhà cung cấp, quyền và những thiết lập khác hiện có.
Sao lưu các tệp cục bộ và trình bày những thay đổi dự kiến.
Để tôi nhập khóa API cần thiết trên máy của mình; không yêu cầu, hiển thị hoặc dán khóa trong cuộc trò chuyện.
Trước tiên, xác nhận cấu hình tải được bình thường.
Giải thích riêng chi phí của mọi phép thử có gửi yêu cầu trả phí trước khi chạy.

Tổng quanCopy Anchor Link

Codex CLI kết nối TokenLab qua /v1/responses. Mô hình được chọn phải có openai_responses trong tokenlab.accepted_request_formats; tính năng có thể khác nhau theo mô hình.

Nén từ xa của Codex CLI được hỗ trợ tại POST /v1/responses/compact. Codex gửi model của phiên hiện tại trong body.model cho /compact và tự động nén, vì vậy model bạn muốn dùng để nén phải có sẵn trên đường dẫn Responses. Không cấu hình /v1/compact.

Yêu cầu hệ thốngCopy Anchor Link

Làm theo hướng dẫn CLI chính thức cho macOS, Linux hoặc Windows. Windows nguyên bản và WSL là môi trường riêng; xem hướng dẫn Windows. npm là một cách cài đặt, không phải yêu cầu của bản nhị phân.

Cài đặtCopy Anchor Link

npm install -g @openai/codex@0.149.0

Xác minh cài đặt:

codex --version

Cấu hìnhCopy Anchor Link

Bước 1: Thiết lập API KeyCopy Anchor Link

Làm theo bước terminal trong bắt đầu nhanh cho macOS, Linux, WSL hoặc Windows PowerShell để đặt TOKENLAB_API_KEY mà không ghi khóa vào lịch sử lệnh. Mở Codex từ terminal đó. Khi dùng lâu dài, hãy dùng trình quản lý bí mật cục bộ, không thêm khóa dạng văn bản vào hồ sơ shell.

Bước 2: Cấu hình tokenlab.config.tomlCopy Anchor Link

Với Codex 0.149.0, dùng tệp tokenlab.config.toml riêng trong CODEX_HOME đang hoạt động (thường là ~/.codex). Chỉ tạo khi tên chưa được dùng, hoặc sao lưu hồ sơ TokenLab hiện có trước khi sửa. codex --profile tokenlab nạp hồ sơ rõ ràng mà không thay đổi config.toml, auth.json, tài khoản hay chính sách quyền. Không dùng bảng cũ [profiles.tokenlab]. Khởi chạy không kèm hồ sơ này để quay lại cấu hình thường dùng. Xem cấu hình hồ sơ chính thức.

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

Chế độ WebSocket này là cầu nối Responses-over-WebSocket cho client Codex. Nó chỉ nhận sự kiện chính thức response.create; stream là ngầm định, còn background và response.cancel không khả dụng trên transport này. Đây không phải OpenAI Realtime API và không nhận session.update, conversation.item.*, input_audio_buffer.*, âm thanh nhị phân hoặc envelope Realtime lồng nhau response.create.response.

Codex hiện dùng wire_api = "responses", không phải chat/completions. Bỏ requires_openai_auth hoặc đặt false để nhà cung cấp dùng env_key.

Sử dụng cơ bảnCopy Anchor Link

Bắt đầu chế độ tương tác:

codex --profile tokenlab

Lệnh trực tiếp:

codex --profile tokenlab "Fix the bug in main.py line 42"

Chỉ định model:

codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"

Chọn mô hìnhCopy Anchor Link

Chọn mô hình hiện có openai_responses trong tokenlab.accepted_request_formats. So sánh bằng tác vụ của bạn và xem giá hiện tại trên trang mô hình.

Lệnh tương tácCopy Anchor Link

Xác minh cấu hìnhCopy Anchor Link

Chỉ kiểm tra biến môi trường đã được đặt hay chưa, không in giá trị. Kiểm tra này không xác nhận khóa có hợp lệ hay không:

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Khởi động Codex rồi chạy /status để kiểm tra mô hình và quyền đang dùng. Nếu sử dụng hồ sơ cấu hình, hãy khởi động cùng hồ sơ đó. Xem lệnh trạng thái chính thức.

Khi sẵn sàng gửi yêu cầu thật, hãy chạy lệnh dưới đây. Lệnh sẽ sử dụng số dư TokenLab. Kiểm tra câu trả lời và bản ghi tương ứng trong Yêu cầu. Biến đã được đặt hoặc ứng dụng khởi động thành công chưa chứng minh yêu cầu đã thành công.

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

Các trường hợp sử dụng phổ biếnCopy Anchor Link

Đánh giá mã:

git diff | codex --profile tokenlab "Review these code changes"

Tạo commit messages:

git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"

Sửa lỗi:

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

Giải thích mã:

cat main.py | codex --profile tokenlab "Explain what this code does"

Xử lý sự cốCopy Anchor Link