Cline 설정 가이드

업데이트: 2026-06-06

Cline은 VS Code에서 매우 강력한 에이전트형 코딩 확장 프로그램으로, 파일 읽기/쓰기, 터미널 실행, 단계별 계획, 다회차 코드 수정에 적합합니다. Crazyrouter와 연동할 때는 Cline이 공식 제공하는 OpenAI Compatible provider를 사용하는 것을 권장합니다.

개요

Cline의 OpenAI Compatible provider를 통해 에이전트 요청을 Crazyrouter로 전송할 수 있습니다.

권장 프로토콜: OpenAI-compatible API
Base URL: https://api.crazyrouter.com/v1
인증 방식: sk-... 토큰
권장 기본 모델: claude-opus-4-8 또는 gpt-5.5

Cline은 파일을 읽고 쓰고 터미널 명령을 실행할 수 있는 능력을 가지고 있습니다. 연결에 성공한 후 진짜 위험은 “연결이 되는가”가 아니라 “지나치게 큰 실행 권한을 부여했는가”입니다. 먼저 익숙한 소규모 저장소부터 시작하는 것을 권장합니다.

이런 분께 적합합니다

VS Code에서 에이전트형 프로그래밍 경험을 얻고 싶은 분
Crazyrouter의 멀티 모델 기능을 결합해 코드 수정을 하고 싶은 분
IDE 에이전트 트래픽과 CLI 트래픽을 분리해서 통계를 내고 싶은 분
Claude, GPT 등의 모델을 통합 게이트웨이로 전환하고 싶은 분

사용 프로토콜

권장 프로토콜: OpenAI-compatible API Cline 설정에서 다음을 선택합니다.

API Provider: OpenAI Compatible
Base URL: https://api.crazyrouter.com/v1
API Key: 본인의 sk-...
Model ID: 사용하고자 하는 모델 이름

Base URL을 다음과 같이 작성하지 마세요.

https://api.crazyrouter.com
https://api.crazyrouter.com/v1/chat/completions

Claude Code, Codex, Aider와 달리 Cline의 표준 VS Code 연동 방식은 대체로 환경 변수를 수동으로 작성할 필요가 없습니다. 대부분의 경우 Cline 설정 화면에서 Base URL, API Key, Model ID만 입력하면 됩니다.

시스템 요구 사항 및 사전 조건

항목	설명
Crazyrouter 계정	먼저 crazyrouter.com에서 가입
Crazyrouter 토큰	Cline 전용 토큰을 별도로 생성하는 것을 권장
Git	`git 2.23+` 권장
VS Code	현재 안정 버전 권장
Cline 확장	현재 버전 권장
사용 가능한 모델	에이전트형 코딩에 적합한 모델을 최소 1~2개 허용
환경 변수	표준 VS Code 연동 방식에서는 보통 필요하지 않음

권장 초기 화이트리스트:

claude-opus-4-8
gpt-5.5
gemini-3.1-pro

운영체제별 전체 설치 경로

Windows 권장 경로

Windows에서 Cline을 사용하는 가장 안정적인 경로는 Git + VS Code + 확장 마켓플레이스에서 Cline 설치 + Cline 설정에서 Crazyrouter 파라미터 직접 입력입니다. 권장 순서:

Git 설치
VS Code 설치
VS Code 확장 마켓플레이스에서 Cline 설치
Crazyrouter에서 Cline 전용 토큰 생성
저장소를 열고 먼저 Git 스냅샷을 만들기
Cline 설정에서 OpenAI Compatible, Base URL, API Key, Model ID 입력

권장 검증 명령:

git --version
where.exe git
code --version
where.exe code

code --version에서 명령을 찾을 수 없더라도 VS Code 본체가 정상적으로 열린다면 Cline 사용에는 영향이 없습니다. 다만 터미널에서 바로 code 명령으로 디렉터리를 열 수 없을 뿐입니다.

macOS 권장 경로

macOS에서 Cline을 사용하는 가장 편한 경로는 보통 Xcode Command Line Tools + Homebrew + Git + VS Code + 확장 마켓플레이스에서 Cline 설치입니다. 권장 순서:

Xcode Command Line Tools 설치
Homebrew 설치(아직 없다면)
Git 설치
VS Code 설치
VS Code에서 Cline 설치
Cline 설정에서 Crazyrouter 파라미터 직접 입력

권장 검증 명령:

git --version
which git
open -a "Visual Studio Code"

터미널에서 바로 code 명령을 사용하려면 VS Code 명령 팔레트에서 Shell Command: Install 'code' command in PATH를 실행한 다음 확인합니다.

code --version
which code

Linux 안내

Linux 사용자는 기본적으로 Windows / macOS와 같은 방식으로 이해하면 됩니다. 먼저 Git과 VS Code를 설치한 다음, 확장 마켓플레이스에서 Cline을 설치합니다. Ubuntu / Debian에서 흔히 쓰는 명령은 다음과 같습니다.

sudo apt update
sudo apt install -y git
sudo snap install code --classic
git --version
code --version

처음부터 완전히 설치하기

1단계: Git 설치

아직 컴퓨터에 Git이 없다면 먼저 Git을 설치합니다.

Windows PowerShell
macOS
Ubuntu / Debian

winget install --id Git.Git -e --source winget
git --version
where.exe git

xcode-select --install
git --version

또는:

brew install git
git --version
which git

sudo apt update
sudo apt install -y git
git --version
which git

설치 후 다음을 실행하는 것을 권장합니다.

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

2단계: VS Code 설치

Cline은 현재 가장 흔히 VS Code 확장 형태로 사용됩니다.

Windows PowerShell
macOS
Ubuntu / Debian

winget install Microsoft.VisualStudioCode
code --version
where.exe code

brew install --cask visual-studio-code
open -a "Visual Studio Code"

터미널에서 바로 code를 실행하려면 VS Code 명령 팔레트에서 다음을 실행합니다.

Shell Command: Install 'code' command in PATH

그런 다음 확인합니다.

code --version
which code

sudo snap install code --classic
code --version
which code

설치가 완료되면 먼저 VS Code를 한 번 정상적으로 실행해 봅니다.

3단계: Cline 확장 설치

VS Code를 연 후:

Ctrl/Cmd + Shift + X를 눌러 확장 마켓플레이스를 엽니다
Cline을 검색합니다
설치를 클릭합니다
설치가 완료되면 사이드바의 Cline 아이콘을 클릭하거나, Ctrl/Cmd + Shift + P를 누른 후 Cline: Open In New Tab을 실행합니다

VS Code에서 Running extensions might...와 같은 알림이 뜨면 허용을 선택하면 됩니다.아이콘이 보이지 않으면 VS Code를 재시작한 후 다시 확인합니다.

4단계: Crazyrouter에서 Cline 전용 토큰 생성

Crazyrouter 관리 화면에서 cline이라는 이름의 토큰을 생성합니다. 처음에는 다음만 허용하는 것을 권장합니다.

claude-opus-4-8
gpt-5.5
gemini-3.1-pro

Cline의 표준 VS Code 연동 방식은 보통 화면에서 API Key를 입력하는 방식이며, Claude Code / Codex처럼 환경 변수에 주로 의존하지 않습니다. 따라서 여기서 가장 중요한 것은 전용 토큰과 최소한의 모델 화이트리스트입니다.

5단계: Git 저장소 준비 및 첫 스냅샷 만들기

Cline은 실제로 파일을 수정하고 명령을 실행합니다. 처음 연동하기 전에 저장소 스냅샷을 만드는 것을 권장합니다.디렉터리가 아직 Git 저장소가 아니라면:

git init
git add .
git commit -m "chore: initial snapshot before Cline"

이미 기존 저장소라면 최소한 다음을 먼저 확인합니다.

git status

6단계: Cline에 Crazyrouter 설정 입력

Cline 설정으로 들어가 다음을 입력합니다.

API Provider: OpenAI Compatible
Base URL: https://api.crazyrouter.com/v1
API Key: 본인의 sk-...
Model ID: 먼저 claude-opus-4-8 입력

현재 버전의 Cline 화면에 Verify 버튼이 있다면 먼저 한 번 클릭해 링크가 정상인지 확인하는 것을 권장합니다. 없다면 읽기 전용 테스트 요청을 직접 보내 확인해도 됩니다.처음에는 하나의 모델로만 검증하고, 처음부터 여러 모델을 동시에 전환하지 마세요.

7단계: 첫 검증 완료하기

첫 검증은 다음 순서로 진행하는 것을 권장합니다.

먼저 Cline에게 읽기 전용 작업을 시킵니다: 현재 작업 공간의 README만 읽고 요점을 정리해 주세요. 어떤 파일도 수정하지 마세요
이어서 낮은 위험도의 분석을 시킵니다: 현재 저장소에서 먼저 확인해 볼 가치가 있는 파일 3개를 지적해 주세요
마지막으로 소규모 수정을 시도합니다: README에 있는 명확한 오타 하나만 수정하고 diff를 보여 주세요

이 세 단계가 모두 정상적으로 작동하고 Crazyrouter 관리 화면에서 해당 요청 로그를 확인할 수 있다면, 주요 연동 경로가 안정적으로 작동한다고 볼 수 있습니다.

8단계: 더 강한 권한을 단계적으로 열어주기

읽기 전용 작업과 소규모 수정이 안정화된 후에는 다음을 단계적으로 시도합니다.

소규모 다중 파일 수정
낮은 위험도의 명령 실행 허용
마지막으로 더 복잡한 에이전트형 리팩터링

처음부터 대규모 저장소에서 광범위한 자동 작업을 실행하게 하는 것은 권장하지 않습니다.

권장 모델 설정

사용 시나리오	권장 모델	이유
기본 주력 에이전트	`claude-opus-4-8`	다회차 계획, 코드 설명, 긴 컨텍스트 처리 성능이 안정적
OpenAI 호환 기준선	`gpt-5.5`	2026년 3월 23일 프로덕션 환경에서 실측 성공, OpenAI 호환 주 기준선으로 적합
Gemini 대체 옵션	`gemini-3.1-pro`	두 번째 호환성 검증 경로로 적합

먼저 claude-opus-4-8로 에이전트 흐름을 검증하고, OpenAI 호환 기준선을 보완해야 한다면 gpt-5.5로 전환하는 것을 권장합니다.

토큰 설정 모범 사례

설정	권장 사항	설명
전용 토큰	필수	Cline은 Cursor, Claude Code, Aider와 토큰을 공유하지 않아야 함
모델 화이트리스트	강력 권장	Cline은 소모량이 큰 도구이므로 화이트리스트가 좁을수록 안전함
IP 제한	고정된 사무 환경에서는 활성화 권장	노트북 이동 네트워크 환경에서는 신중하게 사용
할당량 상한	강력 권장	에이전트형 다회차 실행은 쉽게 할당량을 소진시킴
환경 분리	권장	개인 VS Code, 원격 개발 머신, 팀 공용 환경은 토큰을 분리
권한 분리	강력 권장	위험도가 높은 저장소는 더 작은 할당량의 별도 토큰을 설정하는 것이 좋음

검증 체크리스트

자주 발생하는 오류와 해결 방법

현상	흔한 원인	해결 방법
확장은 설치됐지만 Cline 아이콘이 보이지 않음	VS Code가 새로고침되지 않았거나 확장이 제대로 활성화되지 않음	VS Code를 재시작한 후 명령 팔레트에서 Cline을 엶
`code` 명령을 사용할 수 없음	VS Code 본체는 설치됐지만 shell 명령이 PATH에 없음	Windows는 터미널을 새로 열어 재시도; macOS는 명령 팔레트에서 `Shell Command: Install 'code' command in PATH` 실행
401 unauthorized	API Key가 잘못됐거나 만료됐거나 복사 오류	토큰을 재생성해 다시 붙여넣기
403 / model not allowed	토큰이 현재 모델을 허용하지 않음	Crazyrouter 토큰 설정에서 모델을 허용
404	Base URL을 루트 도메인이나 구체적인 인터페이스 경로로 입력함	`https://api.crazyrouter.com/v1`로 수정
`model not found`	`Model ID` 이름이 잘못됐거나 현재 모델을 사용할 수 없음	`claude-opus-4-8` 또는 다른 허용된 모델로 되돌림
사내 네트워크에서 연결 안 됨	프록시 또는 방화벽이 차단	먼저 VS Code 자체의 프록시 설정을 확인; Cline 확장은 VS Code의 네트워크 프록시 설정을 재사용함
써서는 안 될 파일이 수정됨	처음부터 지나치게 큰 쓰기 권한을 부여함	읽기 전용 작업과 소규모 diff 검증부터 다시 시작
비용이 지나치게 빠르게 증가함	다회차 계획 + 대량 컨텍스트 + 자동 실행	작업 범위를 축소하고 Cline에 별도 예산을 설정

성능 및 비용 관련 권장 사항

처음 연동할 때는 읽기 전용 작업과 소규모 수정만 진행
복잡한 리팩터링은 claude-opus-4-8 또는 gpt-5.5를 우선 사용
빈도가 높은 경량 작업에는 처음부터 모델을 너무 많이 확장하지 말고 화이트리스트를 좁게 유지
서로 다른 작업 공간이나 프로젝트 유형에는 다른 토큰을 사용하는 것을 권장
큰 작업을 실행한 후에는 매번 Crazyrouter 로그를 확인해 실제 소모량을 파악

FAQ

Cline은 어떤 Provider를 선택해야 하나요?

OpenAI Compatible을 선택하세요.

Base URL은 무엇을 입력해야 하나요?

https://api.crazyrouter.com/v1을 입력하세요.

Cline의 이 연동 방식은 반드시 환경 변수를 작성해야 하나요?

보통 필요하지 않습니다. 표준 VS Code 연동 방식은 일반적으로 Cline 설정 화면에서 Base URL, API Key, Model ID만 입력하면 충분합니다.

처음에 왜 먼저 Git 스냅샷을 만들어야 하나요?

Cline은 실제로 파일을 읽고 쓰고 명령을 실행하는 에이전트이기 때문입니다. 먼저 스냅샷을 만들어 두면 리뷰와 롤백이 훨씬 쉬워집니다.

처음에 추천하는 모델은 무엇인가요?

먼저 claude-opus-4-8을 사용하세요.

왜 처음부터 큰 권한을 주지 않는 것을 권장하나요?

Cline이 실제로 작업 공간을 조작하기 때문입니다. 읽기 전용, 소규모 작업으로 먼저 검증하는 것이 가장 안정적인 도입 방식입니다.

VS Code 내의 일체형 에이전트 경험을 더 중요하게 여긴다면, Cline은 Cursor의 BYOK 방식보다 “진짜 코드 에이전트” 역할에 더 적합할 것입니다.

API 키 & 콘솔 관리

SDK & 코드 예제

서드파티 연동

Cline 설정 가이드

개요

이런 분께 적합합니다

사용 프로토콜

시스템 요구 사항 및 사전 조건

운영체제별 전체 설치 경로

Windows 권장 경로

macOS 권장 경로

Linux 안내

처음부터 완전히 설치하기

권장 모델 설정

토큰 설정 모범 사례

검증 체크리스트

자주 발생하는 오류와 해결 방법

성능 및 비용 관련 권장 사항

FAQ

Cline은 어떤 Provider를 선택해야 하나요?

Base URL은 무엇을 입력해야 하나요?

Cline의 이 연동 방식은 반드시 환경 변수를 작성해야 하나요?

처음에 왜 먼저 Git 스냅샷을 만들어야 하나요?

처음에 추천하는 모델은 무엇인가요?

왜 처음부터 큰 권한을 주지 않는 것을 권장하나요?

​개요

​이런 분께 적합합니다

​사용 프로토콜

​시스템 요구 사항 및 사전 조건

​운영체제별 전체 설치 경로

​Windows 권장 경로

​macOS 권장 경로

​Linux 안내

​처음부터 완전히 설치하기

​권장 모델 설정

​토큰 설정 모범 사례

​검증 체크리스트

​자주 발생하는 오류와 해결 방법

​성능 및 비용 관련 권장 사항

​FAQ

​Cline은 어떤 Provider를 선택해야 하나요?

​Base URL은 무엇을 입력해야 하나요?

​Cline의 이 연동 방식은 반드시 환경 변수를 작성해야 하나요?

​처음에 왜 먼저 Git 스냅샷을 만들어야 하나요?

​처음에 추천하는 모델은 무엇인가요?

​왜 처음부터 큰 권한을 주지 않는 것을 권장하나요?

개요

이런 분께 적합합니다

사용 프로토콜

시스템 요구 사항 및 사전 조건

운영체제별 전체 설치 경로

Windows 권장 경로

macOS 권장 경로

Linux 안내

처음부터 완전히 설치하기

권장 모델 설정

토큰 설정 모범 사례

검증 체크리스트

자주 발생하는 오류와 해결 방법

성능 및 비용 관련 권장 사항

FAQ

Cline은 어떤 Provider를 선택해야 하나요?

Base URL은 무엇을 입력해야 하나요?

Cline의 이 연동 방식은 반드시 환경 변수를 작성해야 하나요?

처음에 왜 먼저 Git 스냅샷을 만들어야 하나요?

처음에 추천하는 모델은 무엇인가요?

왜 처음부터 큰 권한을 주지 않는 것을 권장하나요?