Kết nối ứng dụng và trợ lý lập trình
Chọn lộ trình, cấu hình Base URL và khóa API CostRouter, rồi xác minh yêu cầu đầu tiên trong nhật ký sử dụng.
Lộ trình 1
Kết nối ứng dụng AI
Tiếp tục sử dụng SDK hoặc HTTP client tương thích. Chỉ cần thay Base URL, khóa API và ID mô hình.
Kiểm tra yêu cầu đầu tiên
Ví dụ curl
curl -X POST "https://costrouter.ai/v1/chat/completions" \
-H "Authorization: Bearer YOUR_COSTROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-luna",
"messages": [
{
"role": "user",
"content": "Reply with exactly: CostRouter connected"
}
],
"stream": false
}'Ba giá trị cần đặt
- Base URL: https://costrouter.ai/v1
- Xác thực: Bearer YOUR_COSTROUTER_API_KEY
- Mô hình: sao chép chính xác ID từ danh mục
Lộ trình 2
Cấu hình trợ lý lập trình
Mỗi cấu hình đều chỉ rõ Base URL và biến môi trường dùng để truyền khóa API. Hãy thay YOUR_COSTROUTER_API_KEY cùng giá trị mô hình bằng giá trị thực tế, rồi chạy các lệnh hiển thị để khởi động công cụ.
Codex
Cấu hình tương thích CostRouter
Cấu hình
Codex
Cấu hình tương thích CostRouter
Cài đặt Codex
Cài đặt công cụ hoặc xác nhận phiên bản hiện tại có thể khởi chạy bình thường.
Cài đặt Codex
npm install -g @openai/codex
codex --versionSao chép một lệnh để kiểm tra kết nối
Lệnh đặt khóa API cho phiên terminal hiện tại, rồi khởi chạy Codex với cấu hình nhà cung cấp CostRouter tạm thời. Tệp config.toml không bị thay đổi. Các thiết lập này chỉ áp dụng cho phiên hiện tại.
Terminal hiện tại (zsh / bash)
export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" && \
codex \
-c 'model_provider="costrouter"' \
-c 'model="gpt-5.6-luna"' \
-c 'model_providers.costrouter.name="CostRouter"' \
-c 'model_providers.costrouter.wire_api="responses"' \
-c 'model_providers.costrouter.env_key="OPENAI_API_KEY"' \
-c 'model_providers.costrouter.base_url="https://costrouter.ai/v1"'Cấu hình lâu dài
Lưu địa chỉ nhà cung cấp và khóa API trong config.toml để các phiên Codex sau tự động tải cấu hình. Khóa được lưu dưới dạng văn bản thuần trên thiết bị; chỉ sử dụng cách này trên máy cá nhân và bảo vệ tệp cẩn thận.
~/.codex/config.toml
model_provider = "costrouter"
model = "gpt-5.6-luna"
[model_providers.costrouter]
name = "CostRouter"
wire_api = "responses"
base_url = "https://costrouter.ai/v1"
experimental_bearer_token = "YOUR_COSTROUTER_API_KEY"
- Dùng khóa API riêng cho công cụ này.
- Chọn mô hình đang khả dụng trong danh mục.
- Khởi động lại công cụ và xác minh yêu cầu trong nhật ký.
Claude Code
Cấu hình tương thích CostRouter
Cấu hình
Claude Code
Cấu hình tương thích CostRouter
Cài đặt Claude Code
Cài đặt công cụ hoặc xác nhận phiên bản hiện tại có thể khởi chạy bình thường.
Cài đặt Claude Code
npm install -g @anthropic-ai/claude-code
claude --versionSao chép một lệnh để kiểm tra kết nối
Chạy toàn bộ lệnh bên dưới để đặt Base URL và khóa API cho phiên terminal hiện tại mà không sửa tệp cấu hình. Các thiết lập này chỉ áp dụng cho phiên hiện tại.
Terminal hiện tại (zsh / bash)
export ANTHROPIC_BASE_URL="https://costrouter.ai" \
ANTHROPIC_AUTH_TOKEN="YOUR_COSTROUTER_API_KEY" && \
claudeCấu hình lâu dài
Lưu các giá trị vào tệp cấu hình của công cụ để tiếp tục sử dụng sau khi khởi động lại.
~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://costrouter.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_COSTROUTER_API_KEY"
}
}- Dùng khóa API riêng cho công cụ này.
- Chọn mô hình đang khả dụng trong danh mục.
- Khởi động lại công cụ và xác minh yêu cầu trong nhật ký.
Gemini CLI
Cấu hình tương thích CostRouter
Cấu hình
Gemini CLI
Cấu hình tương thích CostRouter
Cài đặt Gemini CLI
Cài đặt công cụ hoặc xác nhận phiên bản hiện tại có thể khởi chạy bình thường.
Cài đặt Gemini CLI
npm install -g @google/gemini-cli
gemini --versionSao chép một lệnh để kiểm tra kết nối
Chạy toàn bộ lệnh bên dưới để đặt Base URL và khóa API cho phiên terminal hiện tại mà không sửa tệp cấu hình. Các thiết lập này chỉ áp dụng cho phiên hiện tại.
Terminal hiện tại (zsh / bash)
export GOOGLE_GEMINI_BASE_URL="https://costrouter.ai" \
GEMINI_API_KEY="YOUR_COSTROUTER_API_KEY" \
GEMINI_MODEL="gemini-available-model-id" && \
geminiCấu hình lâu dài
Lưu các giá trị vào tệp cấu hình của công cụ để tiếp tục sử dụng sau khi khởi động lại.
~/.gemini/settings.json
{
"env": {
"GOOGLE_GEMINI_BASE_URL": "https://costrouter.ai",
"GEMINI_API_KEY": "YOUR_COSTROUTER_API_KEY",
"GEMINI_MODEL": "gemini-available-model-id"
}
}- Dùng khóa API riêng cho công cụ này.
- Chọn mô hình đang khả dụng trong danh mục.
- Khởi động lại công cụ và xác minh yêu cầu trong nhật ký.
Cursor
Cấu hình tương thích CostRouter
Cấu hình
Cursor
Cấu hình tương thích CostRouter
Cài đặt Cursor
Cài đặt công cụ hoặc xác nhận phiên bản hiện tại có thể khởi chạy bình thường.
Cài đặt Cursor
cursor .Sao chép một lệnh để kiểm tra kết nối
Các biến môi trường chỉ được truyền cho lần khởi chạy Cursor này và các tiến trình của dự án. Việc chúng có điều khiển Agent tích hợp hay không vẫn phụ thuộc vào phiên bản Cursor.
Terminal hiện tại (zsh / bash)
export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" \
OPENAI_BASE_URL="https://costrouter.ai/v1" && \
cursor .Cấu hình lâu dài
Lưu vào tệp .env của dự án để mã nguồn và script chạy trong Cursor sử dụng. Khả năng dùng Base URL tùy chỉnh của Agent tích hợp phụ thuộc vào phiên bản đã cài.
.env
OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY"
OPENAI_BASE_URL="https://costrouter.ai/v1"- Dùng khóa API riêng cho công cụ này.
- Chọn mô hình đang khả dụng trong danh mục.
- Khởi động lại công cụ và xác minh yêu cầu trong nhật ký.
Quản lý cấu hình trợ lý trên thiết bị
cc-switch giúp lưu và chuyển đổi cấu hình nhà cung cấp trên thiết bị. Chỉ cần thêm Base URL và khóa API CostRouter một lần.
Vận hành thực tế
Trước khi triển khai
Duy trì kiểm soát truy cập và khả năng theo dõi chi phí khi lưu lượng tăng.
- Dùng khóa API riêng cho từng ứng dụng, môi trường hoặc trợ lý.
- Đặt hạn mức chi tiêu, thời hạn, giới hạn mô hình và danh sách IP được phép.
- Kiểm tra Nhật ký sử dụng sau khi cấu hình hoặc thay đổi mô hình.
- Nạp thông tin xác thực từ biến môi trường hoặc công cụ quản lý thông tin bí mật.