Tích hợp với Coding Agents

Codex CLI

Codex CLI là gì?

Codex CLI là coding agent mã nguồn mở của OpenAI, chạy trực tiếp ngay trong terminal của người dùng. Codex CLI hỗ trợ nhiều model provider, trong đó có Trạm AI — nghĩa là người dùng vừa giữ được quy trình agentic coding quen thuộc của Codex, vừa tận dụng được API hợp nhất, provider failover và các công cụ kiểm soát ở cấp tổ chức của Trạm AI.

Bắt đầu nhanh

Bước 1: Cài đặt Codex CLIF

Làm theo hướng dẫn cài đặt Codex CLI để cài CLI lên máy.

Bước 2: Lấy API key của Trạm AI

  1. Đăng ký hoặc đăng nhập tại Trạm AI
  2. Mở trang API Keys
  3. Tạo một API key mới
  4. Sao chép key (key bắt đầu bằng tram_sk-...)

Bước 3: Cấu hình Codex cho Trạm AI

Codex dùng file config.toml, thường nằm ở ~/.codex/config.toml. Tạo mới file này hoặc mở file sẵn có rồi thêm cấu hình sau:

lines
1model_provider = "tram"
2model_reasoning_effort = "high"
3model="~openai/gpt-latest"
4
5[model_providers.tram]
6name = "Tram AI"
7
8base_url="https://api.staging.tram.ai.vn/v1"
9env_key="TRAM_AI_API_KEY"

Bước 4: Thiết lập API key

Export API key của Trạm AI trong shell profile:

lines
$# Add to ~/.zshrc, ~/.bashrc, or ~/.config/fish/config.fish
$export TRAM_AI_API_KEY="tram_sk-..."

Codex đọc API key từ biến môi trường khai báo ở env_key (mặc định là TRAM_AI_API_KEY). Hãy đảm bảo biến này đã được thiết lập trước khi khởi động Codex.

Bước 5: Khởi động Codex

Mở thư mục dự án và chạy:

lines
$cd /path/to/your/project
$codex

Hoàn tất — từ giờ mọi request sẽ được route qua Trạm AI.

Tham chiếu cấu hình

Các thiết lập cốt lõi

Thiết lậpMô tảVí dụ
model_providerProvider dùng cho các request model"tram"
modelModel ID của Trạm AI"~openai/gpt-latest"
model_reasoning_effortMức reasoning effort cho các model Codex"low", "medium", "high", "xhigh"
show_raw_agent_reasoningCó hiển thị reasoning token trong UI hay khôngtrue hoặc false
personalityPreset tính cách của agent"pragmatic", "helpful", v.v.

Khối Provider của Trạm AI

lines
1[model_providers.tram]
2name = "Tram AI"
3base_url = "https://api.staging.tram.ai.vn/v1"
4env_key = "TRAM_AI_API_KEY"
  • base_url: Endpoint API của Trạm AI. Dùng https://api.staging.tram.ai.vn/v1 cho production.
  • env_key: Tên biến môi trường chứa API key.

Mức tin cậy (Trust Level) theo dự án

Codex cho phép đặt mức tin cậy riêng cho từng dự án. Thêm đường dẫn dự án vào để kiểm soát những gì agent được phép truy cập vào:

lines
1[projects."/path/to/trusted/project"]
2trust_level = "trusted"
3
4[projects."/path/to/untrusted/project"]
5trust_level = "untrusted"
  • trusted: Agent có toàn quyền (chạy lệnh, sửa file, v.v.).
  • untrusted: Agent bị giới hạn quyền truy cập cho an toàn.

Vì sao nên dùng Trạm AI với Codex CLI?

Provider Failover

Trạm AI điều phối request qua nhiều provider. Khi một provider gặp sự cố hoặc bị rate-limit, Trạm AI sẽ tự động chuyển sang provider khác, giúp phiên làm việc không bị gián đoạn.

Theo dõi mức sử dụng

Xem mức sử dụng Codex theo thời gian thực ngay trên Trạm AI Activity Dashboard — chi phí, lượng token, và các kiểu request đều rõ ràng.

Linh hoạt đổi model

Chỉ cần trỏ model tới bất kỳ slug nào của Trạm AI (ví dụ ~openai/gpt-latest, ~anthropic/claude-sonnet-latest) hoặc một phiên bản cố định là người dùng có thể đổi model — không cần cài lại Codex, chỉ cần cập nhật config.toml.

Khắc phục sự cố

  • Lỗi xác thực: Kiểm tra TRAM_AI_API_KEY đã được thiết lập và còn hợp lệ chưa, tại tram.ai/keys.
  • Không tìm thấy model: Đối chiếu lại model ID tại tram.ai/models, và nhớ dùng đúng định dạng (ví dụ ~openai/gpt-latest).
  • Quyền riêng tư: Trạm AI không log các prompt chứa mã nguồn của người dùng, trừ khi người dùng chủ động bật prompt logging. Xem Chính sách quyền riêng tư để biết thêm.

Resources