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.

Bước đầu tiên nên làm

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

Codex

Cấu hình tương thích CostRouter

Cấu hình
1

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 --version
2
Nên kiểm tra trước

Sao 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"'
3

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ý.
Antigravity

Claude Code

Cấu hình tương thích CostRouter

Cấu hình
1

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 --version
2
Nên kiểm tra trước

Sao 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" && \
claude
3

Cấ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

Gemini CLI

Cấu hình tương thích CostRouter

Cấu hình
1

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 --version
2
Nên kiểm tra trước

Sao 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" && \
gemini
3

Cấ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

Cursor

Cấu hình tương thích CostRouter

Cấu hình
1

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 .
2
Nên kiểm tra trước

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 .
3

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.

Tải cc-switch

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.
Kết nối ứng dụng AI và trợ lý lập trình | CostRouter