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

# Cline

> Cline의 OpenAI Compatible 제공자 설정에 Venice base URL, API 키, 모델 ID를 지정해 VS Code에서 프라이빗 Venice 모델로 파일 편집, 터미널 명령 실행, 다단계 코딩 작업, 자율 개발 워크플로를 수행하도록 구성하세요.

[Cline](https://cline.bot/)은 파일을 읽고 편집하며, 명령을 실행하고, 다단계 개발 작업을 수행할 수 있는 VS Code용 AI 코딩 어시스턴트입니다. Venice는 Cline의 OpenAI 호환 제공자 설정을 통해 작동합니다.

<CardGroup cols={3}>
  <Card title="VS Code 통합" icon="code">
    에디터를 벗어나지 않고 Venice 모델을 사용하세요
  </Card>

  <Card title="OpenAI 호환" icon="plug">
    Venice의 `/chat/completions` 엔드포인트를 통해 연결하세요
  </Card>

  <Card title="모델 유연성" icon="microchip">
    호환되는 어떤 Venice 텍스트 모델이든 선택하세요
  </Card>
</CardGroup>

***

## 사전 요구 사항

* [venice.ai/settings/api](https://venice.ai/settings/api)에서 받은 Venice API 키
* [Visual Studio Code](https://code.visualstudio.com/) 설치
* VS Code에 설치된 [Cline 확장 프로그램](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev)

***

## 설정

<Steps>
  <Step title="Cline 설정 열기">
    VS Code 활동 표시줄에서 Cline 아이콘을 선택한 다음, 톱니바퀴 아이콘을 선택하여 Cline 설정을 여세요.
  </Step>

  <Step title="API 제공자 선택">
    **API Provider**를 **OpenAI Compatible**로 설정하세요.
  </Step>

  <Step title="Venice 구성">
    다음 값을 입력하세요:

    | 설정       | 값                                  |
    | -------- | ---------------------------------- |
    | Base URL | `https://api.venice.ai/api/v1`     |
    | API Key  | 사용자의 Venice API 키                  |
    | Model ID | [텍스트 모델 카탈로그](/models/text)의 모델 ID |

    예를 들어, Model ID로 `zai-org-glm-5-1`을 사용하세요.

    API 키는 `Bearer` 접두사 없이 그대로 입력하세요. Base URL은 `/api/v1`로 유지하세요; Cline이 `/chat/completions` 경로를 추가합니다.
  </Step>

  <Step title="모델 기능 구성">
    **Model Configuration**을 확장하고 선택한 모델에 맞춰 컨텍스트 창과 최대 출력 토큰을 설정하세요. 이미지 입력이나 컴퓨터 사용 등 모델이 지원하는 기능이 있다면 활성화하세요.

    선택적 기능을 활성화하기 전에 [텍스트 모델 카탈로그](/models/text)에서 선택한 모델을 확인하세요.
  </Step>

  <Step title="저장 및 테스트">
    제공자 설정을 저장하고, 프로젝트를 연 뒤, Cline에 다음과 같은 작은 작업을 부여하세요:

    ```txt theme={null}
    Review the current file and suggest one safe improvement.
    ```

    각 파일 또는 명령 권한을 승인하기 전에 검토하세요.
  </Step>
</Steps>

***

## Venice API 확인

Cline이 연결할 수 없는 경우, API 키와 사용 가능한 모델 ID를 독립적으로 확인하세요:

```bash theme={null}
curl https://api.venice.ai/api/v1/models \
  -H "Authorization: Bearer $VENICE_API_KEY"
```

모델의 `id`를 Cline의 **Model ID** 필드에 정확히 복사하세요.

***

## 구성 참고 사항

* Base URL로는 전체 `/chat/completions` 엔드포인트가 아닌 `https://api.venice.ai/api/v1`을 사용하세요.
* 모델 ID는 시간이 지남에 따라 변경될 수 있습니다. 오래된 예시에 의존하지 말고 [텍스트 모델 카탈로그](/models/text) 또는 `GET /models`를 사용하세요.
* Cline의 컨텍스트 창 및 출력 토큰 설정은 요청 예산 배정 방식에 영향을 줍니다. 최상의 결과를 위해 선택한 모델과 일치시키세요.
* Venice API 키를 비공개로 유지하세요. 소스 파일에 붙여넣거나 git에 커밋하지 마세요.

***

## 문제 해결

<AccordionGroup>
  <Accordion title="401 또는 인증 오류">
    API 키가 [venice.ai/settings/api](https://venice.ai/settings/api)에서 받은 것인지 확인하세요. `Bearer`나 추가 공백 없이 원시 키를 Cline에 붙여넣으세요.
  </Accordion>

  <Accordion title="모델을 찾을 수 없음">
    [텍스트 모델 카탈로그](/models/text) 또는 `GET /models`의 응답에 Model ID가 있는지 확인한 다음, 정확히 복사하세요.
  </Accordion>

  <Accordion title="연결 또는 엔드포인트 오류">
    **API Provider**가 **OpenAI Compatible**이고 Base URL이 정확히 `https://api.venice.ai/api/v1`인지 확인하세요.
  </Accordion>

  <Accordion title="Cline이 도구를 사용하거나 파일을 편집할 수 없음">
    **Model Configuration**을 열고 선택한 모델이 필요한 기능을 지원하는지 확인한 뒤, 해당 모델에 대해 Cline이 컴퓨터 사용 옵션을 노출한다면 이를 활성화하세요.
  </Accordion>
</AccordionGroup>

***

## 리소스

<CardGroup cols={2}>
  <Card title="Venice Cline 원문 가이드" icon="book" href="https://venice.ai/blog/how-to-use-the-venice-api-with-cline-in-vscode-a-developers-guide">
    Venice 공식 문서를 읽어보세요
  </Card>

  <Card title="Venice 텍스트 모델" icon="list" href="/models/text">
    사용 가능한 Venice 모델 ID를 살펴보세요
  </Card>

  <Card title="Cline 제공자 문서" icon="gear" href="https://docs.cline.bot/provider-config/openai-compatible">
    OpenAI 호환 제공자 설정
  </Card>

  <Card title="Venice API 참조" icon="code" href="/api-reference/api-spec">
    전체 엔드포인트 및 매개변수 문서
  </Card>
</CardGroup>