Công cụ lập trình
Codex CLI
Cấu hình OpenAI Codex CLI để sử dụng TokenLab API
Để agent của tôi thiết lập điều này
Sao chép tác vụ này vào một agent đang chạy trên máy tính của bạn:
Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/vi/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Tổng quan
Codex CLI có thể kết nối với TokenLab thông qua /v1/responses. Model đã chọn phải liệt kê openai_responses trong tokenlab.accepted_request_formats; các tính năng có thể khác nhau tùy theo model.
Compaction từ xa sử dụng POST /v1/responses/compact. Codex gửi model của phiên hiện tại trong body.model, do đó model đó cũng phải hỗ trợ Responses. Không cấu hình /v1/compact.
Yêu cầu hệ thống
Sử dụng hướng dẫn cài đặt CLI chính thức cho macOS, Linux hoặc Windows. Windows native và WSL là các môi trường riêng biệt; hãy làm theo hướng dẫn Windows. Lệnh npm bên dưới là một tùy chọn cài đặt, không phải là yêu cầu bắt buộc đối với các tệp thực thi native.
Cài đặt
npm install -g @openai/codex@0.163.0Xác minh cài đặt:
codex --versionCấu hình
Bước 1: Thiết lập API Key
Sử dụng hướng dẫn terminal trong Bắt đầu nhanh dành cho macOS, Linux, WSL hoặc Windows PowerShell để thiết lập TOKENLAB_API_KEY mà không lưu key vào lịch sử lệnh. Khởi chạy Codex từ terminal đó. Để sử dụng lâu dài, hãy dùng trình quản lý secret cục bộ của bạn; không thêm key dạng plaintext vào shell profile của bạn.
Bước 2: Cấu hình tokenlab.config.toml
Sử dụng một tệp tokenlab.config.toml riêng trong CODEX_HOME đang hoạt động của bạn (thường là ~/.codex) với Codex 0.163.0 (đã thử nghiệm vào 2026-10-18). Chỉ tạo tệp này nếu tên chưa được sử dụng, hoặc sao lưu trước khi chỉnh sửa một profile TokenLab hiện có. Profile bên dưới được tải một cách rõ ràng với codex --profile tokenlab; nó giữ nguyên config.toml mặc định, auth.json, các tài khoản và chính sách quyền hạn. Không sử dụng bảng [profiles.tokenlab] cũ (legacy). Khởi động mà không có profile để quay lại thiết lập thông thường của bạn. Xem cấu hình profile 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 = 15000Chế độ WebSocket này là một cầu nối Responses-over-WebSocket dành cho các client Codex. Nó chỉ chấp nhận các sự kiện response.create chính thức; stream là ngầm định, và background cũng như response.cancel không khả dụng trên phương thức truyền tải này. Đây không phải là OpenAI Realtime API và không chấp nhận session.update, conversation.item.*, input_audio_buffer.*, âm thanh nhị phân (binary audio), hoặc các envelope response.create.response lồng nhau của Realtime.
Tạo tệp cấu hình đã chọn nếu nó chưa tồn tại. Sau khi chỉnh sửa, hãy bắt đầu một phiên mới bằng lệnh tương ứng bên dưới.
Codex hiện tại sử dụng wire_api = "responses". Không cấu hình chat/completions. Giữ requires_openai_auth ở trạng thái chưa đặt hoặc false cho nhà cung cấp tùy chỉnh này để env_key được sử dụng.
Các request Responses không được chuyển đổi thành Chat Completions. Các trường tùy chọn và tương lai phụ thuộc vào model đã chọn.
Cách sử dụng cơ bản
Bắt đầu chế độ tương tác:
codex --profile tokenlabLệ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ột model
Sử dụng một model hiện đang liệt kê openai_responses trong tokenlab.accepted_request_formats. Hãy so sánh các ứng viên trên chính các tác vụ lập trình của bạn và kiểm tra giá hiện tại trên trang Models.
Các lệnh tương tác
| Lệnh | Mô tả |
|---|---|
/help | Hiển thị trợ giúp |
/exit hoặc Ctrl+C | Thoát |
/clear | Xóa cuộc trò chuyện |
/status | Hiển thị model đang hoạt động, quyền hạn và mức sử dụng token |
/model <name> | Chuyển đổi model |
Xác minh cấu hình
Kiểm tra xem biến môi trường đã được đặt hay chưa mà không in giá trị của nó. Bước kiểm tra này không xác thực key:
if [ -n "${TOKENLAB_API_KEY:-}" ]; then
printf '%s\n' 'TOKENLAB_API_KEY is set'
else
printf '%s\n' 'TOKENLAB_API_KEY is not set'
fiKhởi động Codex và chạy /status để kiểm tra model đang hoạt động và quyền hạn. Nếu bạn sử dụng profile, hãy khởi động đúng profile đó. Xem lệnh status chính thức.
Khi bạn đã sẵn sàng thực hiện một request thực tế, hãy chạy lệnh bên dưới. Lệnh này sử dụng số dư TokenLab của bạn. Kiểm tra câu trả lời và bản ghi tương ứng trong Requests; việc kiểm tra môi trường hoặc khởi động thành công đơn thuần không chứng minh rằng một request đã 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ến
Đánh giá code:
git diff | codex --profile tokenlab "Review these code changes"Tạo commit message:
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 code:
cat main.py | codex --profile tokenlab "Explain what this code does"Tạo hình ảnh và video trong cùng một agent
Codex cũng có thể tạo hình ảnh và video ngắn với TokenLab MCP server. Mỗi lượt tạo được thanh toán từ cùng một số dư TokenLab. Chạy lệnh này trong terminal nơi TOKENLAB_API_KEY đã được thiết lập:
codex mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48Lệnh này thêm server vào config.toml cơ sở của bạn. Codex cũng tải tệp đó dưới profile tokenlab.config.toml, vì vậy các công cụ sẽ hoạt động dù có hay không có --profile tokenlab. Chạy codex mcp list và kiểm tra xem tokenlab đã được liệt kê hay chưa. Sau đó thử:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video trả về một task ID. Agent sẽ gọi get_task_status cho đến khi video sẵn sàng.