CCRouter Docs
Tài liệu

Bắt đầu

Hướng dẫn dùng CCRouter với Codex và CC Switch

Trang này được viết cho user mới. Mục tiêu là giúp bạn hiểu CCRouter là gì, chọn gói phù hợp, setup nhanh trong CC Switch và kiểm tra quota mà không bị nhầm.

Bắt đầu ngay
terminal

$ open https://t.me/ccrouter_shop_bot

# Mở Telegram bot của CC Router...

READY @ccrouter_shop_bot

$ _

CCRouter là gì?

CCRouter là gói API subscription cung cấp API key riêng, daily credits và quota rõ ràng để dùng với Codex hoặc các app hỗ trợ OpenAI-compatible API.

Để hiểu nhanh:

  • Codex là coding agent hoặc app mà bạn sử dụng.
  • CCRouter là API key + quota để gắn vào app.
  • CC Switch là app quản lý provider cho Codex, Claude, OpenCode, Gemini và các tool khác.
Vertical connection flow from Codex and Claude to CC Switch and CC Router

Bắt đầu nhanh

Có 2 cách setup CCRouter vào CC Switch. Với user mới, nên ưu tiên cách import nhanh. Nếu muốn tự kiểm soát thông số, có thể dùng cách config tay.

1. Import nhanh vào CC Switch

Đây là cách ngắn nhất: copy đoạn mã import config từ bot, dán vào trình duyệt, sau đó bấm Open CC Switch và Save.

Các bước

  1. Trong giao diện bot, mở bot CCRouter và chọn API key.
  2. Tiếp tục click vào phần Import to CC Switch.
  3. Lấy đoạn mã import như trong hình và copy lại.
  4. Dán vào trình duyệt hoặc app launcher.
  5. Bấm Open CC Switch.
  6. Trong CC Switch, bấm Save.
  7. Restart terminal, Codex hoặc app đang dùng để config có hiệu lực.
Ví dụ luồng import nhanh 
Mở bot CCRouter
Chọn API key
Chọn Import to CC Switch
Copy mã import
Dán vào trình duyệt
Open CC Switch
Save
Restart terminal hoặc Codex
Màn hình import nhanh vào CC Switch từ bot CCRouter

2. Config tay trong CC Switch

Cách này dùng khi bạn muốn nhập thủ công API key, endpoint và model.

Các bước

  1. Mở CC Switch.
  2. Bấm Add Provider.
  3. Chọn preset phù hợp hoặc custom provider.
  4. Nhập API Key.
  5. Nhập Endpoint URL hoặc API Base: https://ccrouter.luom.io/v1.
  6. Nhập model được khuyên dùng.
  7. Bấm Enable.
  8. Bấm Save.
  9. Restart terminal hoặc app đang dùng.
Thông tin cần điền 
Endpoint URL: https://ccrouter.luom.io/v1
API Key: sk-...
Model: GPT-5.5 hoặc GPT-5.4
Endpoint URL / API Base
https://ccrouter.luom.io/v1
Phù hợp với Codex / app hỗ trợ OpenAI-compatible API
Model gợi ý
GPT-5.5 / GPT-5.4
Màn hình API key đang hoạt động và các nút setup thủ công

Kiểm tra request

Sau khi setup xong, hãy gửi một request đơn giản trong Codex, CLI hoặc app đang dùng để xác nhận key, model và endpoint đều hoạt động.

  • Nếu thành công, bạn đã setup xong.
  • Nếu không chạy, kiểm tra lại API key, quota, base URL, model và việc restart app.

Dùng CC Router với các app khác

Nếu app của bạn hỗ trợ OpenAI-compatible API, bạn có thể nhập thủ công API key, endpoint URL và model để sử dụng ngay, kể cả khi không đi qua giao diện import nhanh của CC Switch.

Mẫu config manual 
API Key: sk-demo-ccrouter-xxxxxxxx
Base URL: https://ccrouter.luom.io/v1
Model: gpt-5.5
Mẫu env generic 
LLM_BASE_URL=https://ccrouter.luom.io/v1
LLM_API_KEY=sk-demo-ccrouter-xxxxxxxx
LLM_MODEL=gpt-5.5

Codex

Với Codex, cách dễ nhất cho user mới là đi qua CC Switch. Bạn chỉ cần import nhanh từ bot hoặc add provider thủ công, sau đó restart terminal hoặc app để config có hiệu lực.

Cách nên dùng

  • Dùng Import to CC Switch nếu muốn setup nhanh
  • Dùng Config tay nếu muốn kiểm soát API key, endpoint và model
  • Nếu đổi API key mới, thường chỉ cần thay key trong config cũ để giữ session và history

Flow ngắn

  • Mua gói và lấy API key
  • Import nhanh vào CC Switch hoặc add provider thủ công
  • Enable và Save
  • Restart terminal hoặc Codex
  • Gửi một request test
Mẫu config cho Codex 
API Key: sk-demo-ccrouter-xxxxxxxx
Base URL: https://ccrouter.luom.io/v1
Model: gpt-5.5

Claude

Với Claude hoặc Claude Desktop, bản chất vẫn là dùng API key. Điểm khác là chỗ nhập config của app này khác Codex, nên dùng CC Switch sẽ dễ quản lý và switch provider hơn.

Khi nào nên dùng CC Switch

  • Khi bạn muốn đổi provider nhanh mà không sửa file config thủ công
  • Khi bạn dùng nhiều app cùng lúc như Claude, Codex, OpenCode
  • Khi muốn theo dõi usage và quản lý local proxy dễ hơn

Lưu ý

  • Đảm bảo app của bạn hỗ trợ OpenAI-compatible API hoặc đi qua local proxy
  • Kiểm tra lại model và endpoint URL
  • Restart app sau khi đổi provider hoặc đổi key
Mẫu config cho Claude 
API Key: sk-demo-ccrouter-xxxxxxxx
Base URL: https://ccrouter.luom.io/v1
Model: gpt-5.5
Khuyên dùng: đi qua CC Switch để dễ switch provider

Other

Với OpenCode, CLI hoặc app khác, bạn chỉ cần tìm nơi nhập API key, base URL và model. Nếu app hỗ trợ OpenAI-compatible API, bạn có thể dùng mẫu config chung bên dưới.

Cần điền gì

  • API key riêng của bạn
  • Base URL: https://ccrouter.luom.io/v1
  • Model: gpt-5.5 hoặc gpt-5.4

Khi không chạy

  • Kiểm tra app có hỗ trợ OpenAI-compatible API không
  • Kiểm tra key, quota, model, endpoint
  • Restart app hoặc terminal sau khi sửa config
Mẫu config manual chung 
API Key: sk-demo-ccrouter-xxxxxxxx
Base URL: https://ccrouter.luom.io/v1
Model: gpt-5.5
Mẫu env generic 
LLM_BASE_URL=https://ccrouter.luom.io/v1
LLM_API_KEY=sk-demo-ccrouter-xxxxxxxx
LLM_MODEL=gpt-5.5

Bảng giá và daily credits

Daily credits là số credits được reset theo ngày, không phải tổng credits cho toàn bộ thời gian gói.

Gói Credits Thời hạn Giá Mô tả
Trial 1D 500/ngày 1 ngày 20.000 VND Test bot, API key và CCSwitch
PRO5 - 7D 500/ngày 7 ngày 100.000 VND Phù hợp mọi tác vụ văn phòng
PRO20 - 7D 2.000/ngày 7 ngày 200.000 VND Dành cho developer
PRO100 - 7D 10.000/ngày 7 ngày 500.000 VND Coding, automation, any task
MAX5 - 30D 500/ngày 30 ngày 360.000 VND Save 10%, tác vụ văn phòng
MAX20 - 30D 2.000/ngày 30 ngày 640.000 VND Best Value, Save 20%, dành cho developer
MAX100 - 30D 10.000/ngày 30 ngày 1.600.000 VND Save 20%, coding và automation nặng
Gói đề xuất

MAX20 là gói cân bằng nhất cho developer dùng Codex đều mỗi ngày.

Mua ngay Xem gói trong Telegram

Kiểm tra quota và usage

Có 2 cách để kiểm tra mức sử dụng credits.

1. Trong Telegram bot

Mở bot CCRouter Shop - API Giá Rẻ, vào Menu và bấm Quota.

  • Subscription đang active hay không
  • Hôm nay đã dùng bao nhiêu credits
  • Còn lại bao nhiêu
  • Reset lúc nào
  • Hết hạn khi nào
Màn hình nút Quota trong Telegram bot CCRouter

2. Trong CC Switch

Mở Settings và vào tab Usage Statistics.

  • Total Requests
  • Total Cost
  • Total Tokens
  • Cache Tokens
  • Usage Trends theo app và theo thời gian
Màn hình Usage Statistics trong CC Switch

Checklist nhanh khi API không chạy

  • API key đã copy đúng chưa
  • Subscription còn hạn không
  • Daily credits còn không
  • Base URL đã đúng chưa
  • Model đã đúng chưa
  • Đã Enable provider trong CC Switch chưa
  • Đã restart terminal hoặc app chưa
  • App đang dùng có hỗ trợ OpenAI-compatible API không

FAQ

CCRouter có phải Codex không?

Không. Codex là coding agent hoặc app. CCRouter là API key + quota để gắn vào Codex hoặc tool tương thích.

Tôi có thể dùng với Claude, OpenCode hoặc CLI được không?

Có. Nếu app đó hỗ trợ OpenAI-compatible API hoặc có thể đi qua CC Switch / local proxy, bạn có thể sử dụng được.

Tôi có cần cài CC Switch không?

Không bắt buộc, nhưng rất nên có nếu bạn muốn setup dễ hơn, switch provider nhanh hơn và quản lý nhiều tool từ một giao diện.

Credits được tính như thế nào?

CCRouter sử dụng credit làm đơn vị usage thay vì token. Hiện tại, 10 credits tương đương khoảng 1 USD usage theo mặt bằng OpenAI API. Cách tính này đã bao gồm toàn bộ chi phí liên quan đến input tokens, output tokens và cache tokens.

Chúng tôi dùng đơn vị credit để user dễ theo dõi quota hơn, vì chi phí giữa input, output và cache không giống nhau nếu tính trực tiếp theo token. Ngoài ra, hiện tại CCRouter không áp dụng request limit riêng; usage chủ yếu phụ thuộc vào subscription, daily credits còn lại và tình trạng xử lý thực tế của app hoặc model.

Tôi muốn giữ login session và history chat khi đổi API key mới thì sao?

Thường chỉ cần thay API key mới vào config cũ. Session và history chat vẫn được giữ nếu bạn không xóa profile và không reset app.

Chính sách và phạm vi hỗ trợ

Phạm vi sản phẩm

CCRouter là dịch vụ API key, quota và credits để sử dụng với Codex, Claude, OpenCode, CC Switch hoặc các app hỗ trợ OpenAI-compatible API.

Từ chối trách nhiệm liên quan đến app bên thứ ba

Chúng tôi không phải đơn vị phát triển chính thức của Codex, Claude, OpenCode hoặc các app bên thứ ba khác. Vì vậy, các vấn đề phát sinh từ giao diện app, thay đổi phiên bản, lỗi local environment, lỗi login, lỗi session hoặc hành vi nội bộ của từng app có thể nằm ngoài phạm vi kiểm soát trực tiếp của CCRouter.

Tuy nhiên, nếu vấn đề liên quan đến API key, quota, credits, endpoint hoặc khả năng gọi API của CCRouter, chúng tôi sẵn sàng hỗ trợ kiểm tra và xử lý.

Cam kết hỗ trợ

  • Hỗ trợ kiểm tra key, quota, endpoint, model và usage
  • Hỗ trợ xác minh lỗi 401, 403, 429 hoặc timeout liên quan đến API
  • Hỗ trợ hướng dẫn setup với CC Switch hoặc manual config cơ bản

Chính sách hoàn tiền

Nếu sản phẩm không đúng như mô tả hoặc API của CCRouter không thể sử dụng đúng theo phạm vi đã cam kết, chúng tôi sẽ xem xét và hỗ trợ hoàn tiền phù hợp.

Để xử lý nhanh, user nên cung cấp càng rõ càng tốt: gói đang dùng, lỗi gặp phải, ảnh chụp màn hình, thông tin quota hiện tại và các bước đã thử trước đó.

Khi nào nên liên hệ hỗ trợ?

Khi bạn đã kiểm tra key, quota, base URL, model, Enable provider và restart app mà vẫn gặp lỗi 401, 403, 429 hoặc timeout liên tục.

Bắt đầu ngay