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

# 시작하기

> 코드를 구매하고, 키로 교환하고, Node.js를 설치하고, 도구를 선택하세요

<Steps>
  <Step title="CDK 코드 구매">
    코드는 `TSL-XXXX-XXXX-XXXX` 형식이며 패키지별로 판매됩니다:

    | 패키지 | 모델 | 판매 단위 |
    | - | - | - |
    | **GPT** | `gpt-5.6-sol` | 크레딧 (10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **GPT Astra** | `gpt-astra` | 토큰 (5M, 10M, 20M, 50M, 100M, 200M, 500M, 1B) |
    | **Claude** | `claude-opus-5`, `claude-fable-5-1`, `claude-sonnet-5`, `claude-haiku-4-5`… | 크레딧 (10M, 20M, 50M, 100M, 200M, 300M, 500M, 1B) |

    모든 패키지에는 **교환 시점부터 계산되는 유효 기간**이 있습니다(제품에 명시됨, 예: 1일, 2일, 5일). 만료되거나 할당량을 모두 사용하면 키가 중지되며, 미사용 할당량은 새 키로 이월되지 않습니다.

    공지 및 지원: [t.me/teamsoclo](https://t.me/teamsoclo).
  </Step>

  <Step title="코드를 API 키로 교환">
    \*\*[redeem.teamsoclo.site](https://redeem.teamsoclo.site)\*\*를 열고, 코드를 붙여넣고, 교환합니다. `sk-...` 키와 패키지 안내를 받게 됩니다.

    <Warning>
      텍스트를 선택하지 말고 **Copy** 버튼으로 키를 복사하세요. 키가 길어서 양쪽 끝의 문자를 놓치기 쉬우며, 이는 나중에 "잘못 복사했습니다"가 아니라 `401 Unauthorized`로 나타납니다.
    </Warning>

    키를 잃어버렸나요? 같은 코드를 다시 교환하면 같은 키가 표시됩니다. 남은 할당량 및 만료일: [gpt.teamsoclo.site/check](https://gpt.teamsoclo.site/check).
  </Step>

  <Step title="Node.js 설치 (Codex CLI 전용)">
    Codex CLI는 `npm`을 통해 설치되므로 **Node.js 18 이상**이 필요합니다. 확인:

    ```bash theme={null}
    node --version
    ```

    없는 경우 OS에 맞게 설치하세요:

    <Tabs>
      <Tab title="macOS">
        ```bash theme={null}
        brew install node
        ```

        또는 [nodejs.org](https://nodejs.org)에서 설치 프로그램을 다운로드하세요.
      </Tab>

      <Tab title="Linux">
        ```bash theme={null}
        curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
        nvm install --lts
        ```

        nvm은 글로벌 패키지의 `EACCES` 권한 오류를 방지합니다.
      </Tab>

      <Tab title="Windows">
        ```powershell theme={null}
        winget install OpenJS.NodeJS.LTS
        ```

        또는 [nodejs.org](https://nodejs.org)에서 설치 프로그램을 다운로드하세요.
      </Tab>
    </Tabs>

    Cursor, Cline, Chatbox는 Node.js가 필요하지 않습니다.
  </Step>

  <Step title="도구를 선택하고 설정하세요">
    <CardGroup cols={2}>
      <Card title="Codex" icon="terminal" href="/ko/setup/codex">
        CLI + VS Code 확장 + 앱, 세 가지 모두 명령 하나
      </Card>

      <Card title="Claude Code" icon="sparkles" href="/ko/setup/claude-code">
        CLI + 확장, 명령 하나, Claude 패키지 키 필요
      </Card>

      <Card title="Cursor" icon="mouse-pointer-2" href="/ko/setup/cursor">
        Settings → Models에서 Base URL 재정의
      </Card>

      <Card title="Cline / Roo Code" icon="bot" href="/ko/setup/cline">
        OpenAI Compatible 제공자
      </Card>

      <Card title="Chatbox" icon="message-square" href="/ko/setup/chatbox">
        웹 및 데스크톱
      </Card>
    </CardGroup>
  </Step>
</Steps>

## 할당량 계산 방식

키는 **실제 사용된 토큰**(입력 + 출력), 즉 각 요청에 대해 API가 반환하는 `usage`로 정확히 청구됩니다. 숨겨진 수수료나 삽입된 토큰은 없습니다.

* **GPT** 패키지: 10M 크레딧 = 10M `gpt-5.6-sol` 토큰.
* **GPT Astra** 패키지: 10M = 10M `gpt-astra` 토큰. Astra 키는 `gpt-astra`만, GPT 키는 `gpt-5.6-sol`만 호출할 수 있습니다.
* **Claude** 패키지: 크레딧은 모델별로 청구되며, Opus 5 ≈ 1 크레딧/토큰, Fable ≈ 2, Sonnet/Haiku는 더 저렴합니다. Claude 키는 `claude-*` 모델만 호출할 수 있습니다.

<Tip>
  가장 효과적인 절약 방법: **주제를 바꿀 때 새 대화를 시작하세요**. 매 번 전체 기록이 재전송되므로, 긴 채팅의 51번째 메시지는 첫 번째 메시지보다 훨씬 많은 비용이 듭니다. Cursor와 Cline에서는 저장소 전체를 스캔하게 두지 말고 에이전트가 정확한 파일을 가리키도록 하세요.
</Tip>


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