> ## 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

> Windows 和 macOS App：貼上金鑰，點一下即可設定 Claude Code、Codex、Claude Desktop 等 20 多個工具

帶介面的桌面App，適合不想用終端機的使用者。貼上一次金鑰，App會先驗證，再為本機的每個程式設計工具寫入設定。寫入前總會備份原有設定檔案，隨時可以移除。

<Card title="下載 TeamSocLo Key Tool" icon="download" href="https://www.dropbox.com/scl/fo/01mhuuc1euaciw0ykx1xx/AAa8f8OXyhmw22fjJtGfuGU?rlkey=xeshttafgwkb3dtv5tk0s95tw&st=9v4uv79j&dl=0">
  Windows `.exe` · macOS `.dmg`（Apple 晶片 / Intel）· 安裝說明
</Card>

## 安裝App

<Tabs>
  <Tab title="Windows">
    下載 `TeamSocLoKeyTool-…-Windows.exe` 並雙擊執行。無需安裝其他元件，已全部打包。

    如果 Windows 提示 **Windows protected your PC**，點選 **More info** → **Run anyway**。從其他電腦複製後檔案被阻止：右鍵 → **屬性** → 勾選 **解除鎖定** → **確定**。
  </Tab>

  <Tab title="macOS">
    Apple 晶片（M1、M2、M3、M4…）下載 `macOS-AppleSilicon.dmg`，Intel 機型下載 `macOS-Intel.dmg`。可在 Apple 選單 → **關於本機** 檢視晶片。

    1. 開啟 `.dmg`，把 **TeamSocLo Key Tool** 拖到 **App**。
    2. 首次開啟時 macOS 會因未公證而阻止：開啟 **系統設定** → **隱私與安全性**，向下滾動，點選 **仍要開啟** → **開啟**。

    也可以用一條終端機命令安裝，會自動選擇對應晶片的版本，且不會被阻止：

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

## 使用App

<Steps>
  <Step title="貼上金鑰，點選「檢查」">
    App會顯示金鑰可呼叫的模型數量、剩餘額度和到期時間。選擇 **主模型**。
  </Step>

  <Step title="設定">
    點選 **全部設定**，為本機已安裝的所有工具寫入設定。也可以點開單個工具，檢視它當前的設定並單獨選擇模型（Claude Code 還可分別選擇 Opus、Sonnet、Haiku），然後點選 **設定**。
  </Step>

  <Step title="重新開啟工具">
    新開一個終端機，或完全退出 VS Code / App後再開啟，讓工具讀取新設定。
  </Step>
</Steps>

每個工具的詳情頁中，**手動設定** 會顯示App將要寫入的完整內容，可複製後自行修改。

## 支援的工具

**自動寫入設定：** 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.

**提供指南和複製按鈕**（在工具自身介面中設定）： Cursor, GitHub Copilot, Roo Code, Continue.

<Tip>
  任何套餐的金鑰都能用於任何工具：閘道器會自動轉換協議，GPT 金鑰可以在 Claude Code 中使用，Claude 金鑰也可以在 Codex 中使用。模型取決於套餐，見 [模型與套餐](/zh-tw/models)。
</Tip>

| | |
| - | - |
| **已連線** | 工具正在使用 TeamSocLo 閘道器 |
| **其他** | 工具指向其他閘道器或賬號，覆蓋前請先開啟檢視 |
| **未設定** | 已安裝但尚未設定 |
| **未安裝** | 本機未找到。仍可先設定；Claude Code、Codex、OpenCode、Cline、Qwen Code 可用 npm 按鈕安裝（需要 Node.js 18+） |
| **指南** | 在工具自身介面中設定，App提供可複製的 Base URL、金鑰和模型 |

## Claude Desktop

設定後請完全退出 Claude Desktop 再開啟：它會切換到閘道器模式，不再需要登入 Anthropic 賬號。在 Windows 上，Cowork 需要新版安裝包；如果看到 *Reinstall the desktop app to access Cowork*，請到 [claude.ai/download](https://claude.ai/download) 重新下載並覆蓋安裝。

## 移除或更換金鑰

**更換金鑰**：貼上新金鑰，點選 **檢查**，再點選 **設定**。

**移除**：在App中開啟該工具，點選 **移除設定**。只會移除 TeamSocLo 的部分，若之前有模型設定會恢復，並且原檔案旁總會保留一份 `….bak.<時間>` 備份。


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