> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CC Switch

> Nhập Provider 4096bytes vào CC Switch và quản lý các ứng dụng CLI

CC Switch là công cụ quản lý cấu hình AI CLI đa nền tảng. Bạn có thể dùng nó để quản lý Provider cho Claude Code, Codex, Gemini CLI, OpenCode và các công cụ tương tự.

Sau khi nhập 4096bytes vào CC Switch, Base URL, API Key và tên mô hình sẽ được lưu trong cấu hình cục bộ. Sau đó bạn có thể chuyển đổi giữa nhiều CLI hoặc Provider mà không phải sửa biến môi trường và tệp cấu hình nhiều lần.

<Warning>
  Nhập một lần sẽ ghi API Key hiện tại vào cấu hình CC Switch trên máy. Chỉ thực hiện trên máy tính của bạn. Không nhập key trên máy dùng chung, máy từ xa tạm thời hoặc môi trường không tin cậy.
</Warning>

## Cài đặt

CC Switch là dự án mã nguồn mở trên GitHub: [`farion1231/cc-switch`](https://github.com/farion1231/cc-switch).

<Steps>
  <Step title="Mở trang Releases">
    Mở trang [`farion1231/cc-switch` Releases](https://github.com/farion1231/cc-switch/releases) và xem phiên bản mới nhất.
  </Step>

  <Step title="Tải gói phù hợp">
    Chọn gói theo hệ điều hành:

    * macOS: `.dmg`
    * Windows: `.msi`
    * Linux: `.AppImage` hoặc `.deb`.
  </Step>

  <Step title="Cài đặt và mở một lần">
    Hoàn tất cài đặt. Mở CC Switch ít nhất một lần để trình duyệt có thể gọi ứng dụng khi nhập cấu hình.
  </Step>
</Steps>

## Nhập một lần

Nên dùng nhập một lần khi có sẵn. Cách này ghi cấu hình Provider vào CC Switch cục bộ mà không cần sao chép từng trường.

<Steps>
  <Step title="Xác nhận CC Switch đã cài">
    Đảm bảo CC Switch đã được cài và đã mở ít nhất một lần.
  </Step>

  <Step title="Mở API Keys">
    Mở bảng điều khiển và tìm API Key muốn nhập vào CC Switch trên trang **API Keys**.
  </Step>

  <Step title="Nhấn Import to CCS">
    Nhấn **Import to CCS** trong dòng key đó. Nếu hệ thống hỏi có cho phép mở CC Switch không, hãy cho phép.

    <img src="https://mintcdn.com/4096bytes/92zL9C5RTBxmIwvG/images/screenshots/clients/cc-switch/ccs-import-button.png?fit=max&auto=format&n=92zL9C5RTBxmIwvG&q=85&s=6553319b327746384fdfa1bcb39eeac6" alt="Nút Import to CCS" width="720" style={{ maxWidth: "100%", height: "auto" }} data-path="images/screenshots/clients/cc-switch/ccs-import-button.png" />
  </Step>

  <Step title="Xác nhận nhập">
    Kiểm tra thông tin Provider trong CC Switch rồi xác nhận nhập.

    <img src="https://mintcdn.com/4096bytes/92zL9C5RTBxmIwvG/images/screenshots/clients/cc-switch/import-to-ccs.png?fit=max&auto=format&n=92zL9C5RTBxmIwvG&q=85&s=d3c3e15c9b90ddaa75e43c7f70d6a7b7" alt="Xác nhận nhập CC Switch" width="720" style={{ maxWidth: "100%", height: "auto" }} data-path="images/screenshots/clients/cc-switch/import-to-ccs.png" />
  </Step>
</Steps>

Sau khi nhập, CC Switch sẽ lưu cấu hình Provider tương ứng với API Key hiện tại. Nếu sau này bạn xóa hoặc thay key, hãy nhập lại hoặc cập nhật cấu hình thủ công.

## Thêm Provider thủ công

Nếu không dùng được nhập một lần, bạn có thể thêm Provider 4096bytes thủ công trong CC Switch.

| Trường CC Switch | Giá trị                                            |
| ---------------- | -------------------------------------------------- |
| Provider preset  | Chọn cấu hình tùy chỉnh.                           |
| Provider ID      | Dùng `4096bytes`.                                  |
| Provider name    | Dùng `4096bytes`.                                  |
| Official link    | `https://www.4096bytes.com`                        |
| API endpoint     | `https://api.4096bytes.com` (không bật "Full URL") |
| API Key          | API Key bạn tạo trong bảng điều khiển.             |

<Tip>
  Sao chép Base URL và tên mô hình từ bảng điều khiển. Không dùng ảnh cũ, cuộc trò chuyện hoặc cấu hình của người khác.
</Tip>

## Kiểm tra

Sau khi nhập hoặc thêm thủ công, chuyển sang Provider 4096bytes trong CC Switch rồi chạy một tác vụ rủi ro thấp.

<img src="https://mintcdn.com/4096bytes/92zL9C5RTBxmIwvG/images/screenshots/clients/cc-switch/ccs-test.png?fit=max&auto=format&n=92zL9C5RTBxmIwvG&q=85&s=683226b076ef51b67b598018f5a582c8" alt="Kiểm tra mô hình trong CC Switch" width="720" style={{ maxWidth: "100%", height: "auto" }} data-path="images/screenshots/clients/cc-switch/ccs-test.png" />

## Gợi ý xử lý lỗi

* Nếu trình duyệt không gọi được CC Switch, xác nhận CC Switch đã cài và đã mở một lần.
* Nếu nhập xong nhưng xác thực thất bại, tạo API Key mới rồi nhập lại.
* Nếu một ứng dụng CLI không dùng Provider mới, xác nhận ứng dụng đó được CC Switch quản lý và khởi động lại terminal sau khi chuyển.