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à API Key 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
Giữ nguyên SDK hoặc HTTP ứng dụng khách tương thích. Chỉ thay Base URL, API Key và ID mô hình.
Yêu cầu hoạt động đầ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 API Key. 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 export API Key vào terminal hiện tại, sau đó khởi chạy Codex với nhà cung cấp CostRouter tạm thời. config.toml không bị thay đổi và các giá trị sẽ hết hiệu lực khi đóng terminal.
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à API Key trong config.toml để các phiên Codex sau tự động tải cấu hình. Key được lưu dưới dạng văn bản thuần trên thiết bị; chỉ 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 API Key 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. Lệnh export Base URL và API Key vào terminal hiện tại mà không sửa tệp cấu hình. Các giá trị sẽ hết hiệu lực khi bạn đóng terminal này.
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 API Key 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. Lệnh export Base URL và API Key vào terminal hiện tại mà không sửa tệp cấu hình. Các giá trị sẽ hết hiệu lực khi bạn đóng terminal này.
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 API Key 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 API Key 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ý hồ sơ trợ lý cục bộ
cc-switch lưu và chuyển hồ sơ nhà cung cấp cục bộ. Chỉ cần thêm Base URL và API Key CostRouter một lần.
Vận hành thực tế
Trước khi phát hành
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 một Key riêng cho mỗi ứng dụng, môi trường hoặc trợ lý.
- Đặt hạn mức, thời hạn, giới hạn mô hình và danh sách IP.
- Kiểm tra nhật ký sau khi cấu hình hoặc đổi mô hình.
- Nạp bí mật từ biến môi trường hoặc trình quản lý bí mật.