> ## 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용 앱: 키를 한 번 붙여넣고 클릭하면 Claude Code, Codex, Claude Desktop 및 20개 이상의 도구가 설정됩니다

터미널을 사용하지 않으려는 분들을 위한 데스크톱 앱입니다. 키를 한 번 붙여넣으면 앱이 확인하고 컴퓨터의 각 코딩 도구에 대한 설정을 작성합니다. 기존 설정 파일은 항상 먼저 백업되며, 언제든지 모든 것을 제거할 수 있습니다.

<Card title="TeamSocLo Key Tool 다운로드" icon="download" href="https://www.dropbox.com/scl/fo/01mhuuc1euaciw0ykx1xx/AAa8f8OXyhmw22fjJtGfuGU?rlkey=xeshttafgwkb3dtv5tk0s95tw&st=9v4uv79j&dl=0">
  Windows `.exe` · Apple 실리콘 및 Intel용 macOS `.dmg` · 설치 안내
</Card>

## 앱 설치

<Tabs>
  <Tab title="Windows">
    `TeamSocLoKeyTool-…-Windows.exe`를 다운로드하고 더블 클릭하세요. 별도로 설치할 것이 없으며, 모든 것이 번들로 포함되어 있습니다.

    Windows에서 **Windows가 PC를 보호했습니다**라고 표시되면 **자세한 정보** → **어쨌든 실행**을 클릭하세요. 다른 PC에서 복사한 후 파일이 차단된 경우: 오른쪽 클릭 → **속성** → **차단 해제** 체크 → **확인**.
  </Tab>

  <Tab title="macOS">
    Apple 실리콘(M1, M2, M3, M4…)은 `macOS-AppleSilicon.dmg`, Intel Mac은 `macOS-Intel.dmg`를 사용하세요. Apple 메뉴 → **이 Mac에 관하여**에서 확인하세요.

    1. `.dmg`를 열고 **TeamSocLo Key Tool**을 **응용 프로그램**으로 드래그합니다.
    2. 첫 실행 시 macOS는 공증되지 않았다는 이유로 차단합니다: **시스템 설정** → **개인 정보 보호 및 보안**을 열고, 아래로 스크롤하여 **어쨌든 열기** → **열기**를 클릭하세요.

    또는 올바른 빌드를 선택하고 차단되지 않는 터미널 명령 하나로 설치하세요:

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

## 앱 사용

<Steps>
  <Step title="키를 붙여넣고 Check를 클릭">
    앱이 키가 호출 가능한 모델 수, 남은 할당량 및 만료일을 표시합니다. **Main model**을 선택하세요.
  </Step>

  <Step title="설정">
    **Configure all**을 클릭하면 이 컴퓨터에 설치된 모든 도구의 설정을 작성합니다. 또는 단일 도구를 열어 현재 사용하는 내용을 확인하고, 자체 모델을 선택한 후(Claude Code는 Opus, Sonnet 및 Haiku도 선택 가능) **Configure**를 클릭하세요.
  </Step>

  <Step title="도구 다시 열기">
    새 터미널을 열거나, VS Code / 앱을 완전히 종료하고 다시 열어 새 설정을 읽도록 하세요.
  </Step>
</Steps>

각 도구의 세부 페이지에서 **Manual config**는 앱이 작성할 내용을 정확히 표시하며, 수동으로 편집하려는 경우 복사할 준비가 되어 있습니다.

## 지원 도구

**자동으로 설정됨:** Claude Code, Codex (CLI, VS Code, 앱), 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.

**안내 제공, Copy 버튼 포함** (도구 자체 설정에서 구성): Cursor, GitHub Copilot, Roo Code, Continue.

<Tip>
  모든 패키지 키는 모든 도구에서 작동합니다: 게이트웨이가 프로토콜을 변환하므로 GPT 키도 Claude Code에서 작동하고 Claude 키도 Codex에서 작동합니다. 모델은 패키지를 따릅니다, [모델 및 패키지](/ko/models) 참조.
</Tip>

| | |
| - | - |
| **연결됨** | 도구가 TeamSocLo 게이트웨이를 사용합니다 |
| **다른 곳** | 도구가 다른 게이트웨이나 계정을 가리킵니다. 덮어쓰기 전에 열어서 확인하세요 |
| **설정 안 됨** | 설치되었지만 설정되지 않았습니다 |
| **설치 안 됨** | 이 컴퓨터에서 찾을 수 없습니다. 그래도 설정할 수 있으며; Claude Code, Codex, OpenCode, Cline 및 Qwen Code는 npm 버튼으로 설치 가능합니다(Node.js 18+ 필요) |
| **가이드** | 도구 자체 UI에서 구성; 앱이 복사할 Base URL, 키 및 모델을 제공합니다 |

## Claude Desktop

설정 후 Claude Desktop을 완전히 종료하고 다시 여세요: 게이트웨이 모드로 전환되어 더 이상 Anthropic 로그인이 필요하지 않습니다. Windows에서 Cowork는 새 Claude Desktop 설치 프로그램이 필요합니다; *Reinstall the desktop app to access Cowork*가 표시되면 [claude.ai/download](https://claude.ai/download)에서 다시 다운로드하여 재설치하세요.

## 키 제거 또는 변경

**키 변경**: 새 키를 붙여넣고 **Check**를 클릭한 후 다시 **Configure**를 클릭하세요.

**제거**: 앱에서 도구를 열고 **Remove config**를 클릭하세요. TeamSocLo 부분만 제거되고, 이전 모델이 있으면 복원되며, `….bak.<timestamp>` 복사본이 항상 원본 옆에 보관됩니다.


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