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

# TeamSocLo Key Tool

> App cho Windows và macOS: dán key, bấm một nút là cấu hình xong Claude Code, Codex, Claude Desktop và hơn 20 công cụ

App có giao diện, dành cho người không muốn dùng terminal. Dán key một lần, app kiểm tra key, rồi ghi cấu hình cho từng công cụ lập trình trên máy bạn. File cấu hình cũ luôn được sao lưu trước khi ghi, gỡ lúc nào cũng được.

<Card title="Tải TeamSocLo Key Tool" icon="download" href="https://www.dropbox.com/scl/fo/01mhuuc1euaciw0ykx1xx/AAa8f8OXyhmw22fjJtGfuGU?rlkey=xeshttafgwkb3dtv5tk0s95tw&st=9v4uv79j&dl=0">
  Windows `.exe` · macOS `.dmg` cho chip Apple và chip Intel · hướng dẫn cài
</Card>

## Cài app

<Tabs>
  <Tab title="Windows">
    Tải `TeamSocLoKeyTool-…-Windows.exe` rồi double-click. Không cần cài thêm gì, app đã gói sẵn mọi thứ.

    Windows báo **Windows protected your PC** thì bấm **More info** → **Run anyway**. File bị chặn khi chép từ máy khác: chuột phải → **Properties** → tick **Unblock** → **OK**.
  </Tab>

  <Tab title="macOS">
    Chip Apple (M1, M2, M3, M4…) tải bản `macOS-AppleSilicon.dmg`, máy Intel tải `macOS-Intel.dmg`. Xem chip ở menu Apple → **About This Mac**.

    1. Mở file `.dmg`, kéo **TeamSocLo Key Tool** vào **Applications**.
    2. Lần đầu mở, macOS chặn vì app chưa đăng ký với Apple: vào **System Settings** → **Privacy & Security**, kéo xuống, bấm **Open Anyway** → **Open**.

    Hoặc cài bằng một lệnh Terminal, tự chọn đúng bản theo chip và không bị chặn:

    ```bash theme={null}
    curl -fsSL https://redeem.teamsoclo.site/install/keytool-mac.sh | bash
    ```
  </Tab>
</Tabs>

## Dùng app

<Steps>
  <Step title="Dán key, bấm Kiểm tra">
    App hiện số model key được gọi, phần trăm hạn mức còn lại và ngày hết hạn. Chọn **Model chính** muốn dùng.
  </Step>

  <Step title="Cấu hình">
    Bấm **Cấu hình tất cả** để ghi cho mọi công cụ đã cài trên máy. Hoặc bấm vào một công cụ để xem nó đang dùng gì, chọn model riêng (Claude Code chọn được cả Opus, Sonnet, Haiku), rồi bấm **Cấu hình**.
  </Step>

  <Step title="Mở lại công cụ">
    Mở terminal mới, hoặc thoát hẳn VS Code / app rồi mở lại để công cụ đọc cấu hình mới.
  </Step>
</Steps>

Trong trang chi tiết của mỗi công cụ, mục **Cấu hình thủ công** hiện đúng nội dung file app sẽ ghi, copy được để tự sửa tay.

## Công cụ hỗ trợ

**App tự ghi cấu hình:** Claude Code, Codex (CLI, VS Code, app), Claude Desktop, OpenCode, Cline, Kilo Code, Qwen Code, Factory Droid, Open Claw, Crush, Pi, Oh My Pi, Smelt, DeepSeek TUI, jcode, Grok Build, ForgeCode, CodeWhale, Hermes Agent.

**Có hướng dẫn kèm nút Copy** (cấu hình trong giao diện của công cụ): Cursor, GitHub Copilot, Roo Code, Continue.

<Tip>
  Key gói nào cũng dùng được cho mọi công cụ: gateway tự chuyển giao thức, nên key GPT chạy được trong Claude Code và key Claude chạy được trong Codex. Model đi theo gói, xem [Model và gói](/mo-hinh).
</Tip>

| | |
| - | - |
| **Đã kết nối** | Công cụ đang dùng gateway TeamSocLo |
| **Khác** | Công cụ đang trỏ tới gateway hoặc tài khoản khác. Mở ra xem chi tiết trước khi ghi đè |
| **Chưa cấu hình** | Đã cài nhưng chưa có cấu hình |
| **Chưa cài** | Không thấy trên máy. Vẫn cấu hình trước được; Claude Code, Codex, OpenCode, Cline, Qwen Code cài được bằng nút npm (cần Node.js 18+) |
| **Hướng dẫn** | Công cụ cấu hình trong giao diện của nó, app đưa sẵn Base URL, key và model để copy |

## Claude Desktop

Sau khi cấu hình, thoát hẳn Claude Desktop rồi mở lại: app chuyển sang chế độ gateway, không cần đăng nhập tài khoản Anthropic. Trên Windows, Cowork cần bản cài mới của Claude Desktop; nếu thấy *Reinstall the desktop app to access Cowork*, tải lại tại [claude.ai/download](https://claude.ai/download) rồi cài đè.

## Gỡ, đổi key

**Đổi key**: dán key mới, bấm **Kiểm tra** rồi **Cấu hình** lại.

**Gỡ**: mở công cụ trong app, bấm **Gỡ cấu hình**. App chỉ xoá phần của TeamSocLo, trả lại model cũ nếu có, và luôn để lại bản sao `….bak.<thời gian>` cạnh file gốc.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.