> ## Documentation Index > Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt > Use this file to discover all available pages before exploring further. # Cline 설정 가이드 > VS Code의 Cline 확장에서 OpenAI Compatible provider를 통해 Crazyrouter에 연결하고, Windows와 macOS를 구분한 전체 설치·설정·검증·문제 해결 절차를 제공합니다 > 업데이트: 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](https://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 파라미터 직접 입력`입니다. 권장 순서: 1. Git 설치 2. VS Code 설치 3. VS Code 확장 마켓플레이스에서 Cline 설치 4. Crazyrouter에서 Cline 전용 토큰 생성 5. 저장소를 열고 먼저 Git 스냅샷을 만들기 6. Cline 설정에서 `OpenAI Compatible`, `Base URL`, `API Key`, `Model ID` 입력 권장 검증 명령: ```powershell theme={null} 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 설치`입니다. 권장 순서: 1. Xcode Command Line Tools 설치 2. Homebrew 설치(아직 없다면) 3. Git 설치 4. VS Code 설치 5. VS Code에서 Cline 설치 6. Cline 설정에서 Crazyrouter 파라미터 직접 입력 권장 검증 명령: ```bash theme={null} git --version which git open -a "Visual Studio Code" ``` 터미널에서 바로 `code` 명령을 사용하려면 VS Code 명령 팔레트에서 `Shell Command: Install 'code' command in PATH`를 실행한 다음 확인합니다. ```bash theme={null} code --version which code ``` ### Linux 안내 Linux 사용자는 기본적으로 Windows / macOS와 같은 방식으로 이해하면 됩니다. 먼저 Git과 VS Code를 설치한 다음, 확장 마켓플레이스에서 Cline을 설치합니다. Ubuntu / Debian에서 흔히 쓰는 명령은 다음과 같습니다. ```bash theme={null} sudo apt update sudo apt install -y git sudo snap install code --classic git --version code --version ``` ## 처음부터 완전히 설치하기 아직 컴퓨터에 Git이 없다면 먼저 Git을 설치합니다. ```powershell theme={null} winget install --id Git.Git -e --source winget git --version where.exe git ``` ```bash theme={null} xcode-select --install git --version ``` 또는: ```bash theme={null} brew install git git --version which git ``` ```bash theme={null} sudo apt update sudo apt install -y git git --version which git ``` 설치 후 다음을 실행하는 것을 권장합니다. ```bash theme={null} git config --global user.name "Your Name" git config --global user.email "you@example.com" git config --global init.defaultBranch main ``` Cline은 현재 가장 흔히 VS Code 확장 형태로 사용됩니다. ```powershell theme={null} winget install Microsoft.VisualStudioCode code --version where.exe code ``` ```bash theme={null} brew install --cask visual-studio-code open -a "Visual Studio Code" ``` 터미널에서 바로 `code`를 실행하려면 VS Code 명령 팔레트에서 다음을 실행합니다. ```text theme={null} Shell Command: Install 'code' command in PATH ``` 그런 다음 확인합니다. ```bash theme={null} code --version which code ``` ```bash theme={null} sudo snap install code --classic code --version which code ``` 설치가 완료되면 먼저 VS Code를 한 번 정상적으로 실행해 봅니다. VS Code를 연 후: 1. `Ctrl/Cmd + Shift + X`를 눌러 확장 마켓플레이스를 엽니다 2. `Cline`을 검색합니다 3. 설치를 클릭합니다 4. 설치가 완료되면 사이드바의 Cline 아이콘을 클릭하거나, `Ctrl/Cmd + Shift + P`를 누른 후 `Cline: Open In New Tab`을 실행합니다 VS Code에서 `Running extensions might...`와 같은 알림이 뜨면 허용을 선택하면 됩니다. 아이콘이 보이지 않으면 VS Code를 재시작한 후 다시 확인합니다. Crazyrouter 관리 화면에서 `cline`이라는 이름의 토큰을 생성합니다. 처음에는 다음만 허용하는 것을 권장합니다. * `claude-opus-4-8` * `gpt-5.5` * `gemini-3.1-pro` Cline의 표준 VS Code 연동 방식은 보통 화면에서 API Key를 입력하는 방식이며, Claude Code / Codex처럼 환경 변수에 주로 의존하지 않습니다. 따라서 여기서 가장 중요한 것은 전용 토큰과 최소한의 모델 화이트리스트입니다. Cline은 실제로 파일을 수정하고 명령을 실행합니다. 처음 연동하기 전에 저장소 스냅샷을 만드는 것을 권장합니다. 디렉터리가 아직 Git 저장소가 아니라면: ```bash theme={null} git init git add . git commit -m "chore: initial snapshot before Cline" ``` 이미 기존 저장소라면 최소한 다음을 먼저 확인합니다. ```bash theme={null} git status ``` Cline 설정으로 들어가 다음을 입력합니다. * `API Provider`: `OpenAI Compatible` * `Base URL`: `https://api.crazyrouter.com/v1` * `API Key`: 본인의 `sk-...` * `Model ID`: 먼저 `claude-opus-4-8` 입력 현재 버전의 Cline 화면에 `Verify` 버튼이 있다면 먼저 한 번 클릭해 링크가 정상인지 확인하는 것을 권장합니다. 없다면 읽기 전용 테스트 요청을 직접 보내 확인해도 됩니다. 처음에는 하나의 모델로만 검증하고, 처음부터 여러 모델을 동시에 전환하지 마세요. 첫 검증은 다음 순서로 진행하는 것을 권장합니다. 1. 먼저 Cline에게 읽기 전용 작업을 시킵니다: `현재 작업 공간의 README만 읽고 요점을 정리해 주세요. 어떤 파일도 수정하지 마세요` 2. 이어서 낮은 위험도의 분석을 시킵니다: `현재 저장소에서 먼저 확인해 볼 가치가 있는 파일 3개를 지적해 주세요` 3. 마지막으로 소규모 수정을 시도합니다: `README에 있는 명확한 오타 하나만 수정하고 diff를 보여 주세요` 이 세 단계가 모두 정상적으로 작동하고 Crazyrouter 관리 화면에서 해당 요청 로그를 확인할 수 있다면, 주요 연동 경로가 안정적으로 작동한다고 볼 수 있습니다. 읽기 전용 작업과 소규모 수정이 안정화된 후에는 다음을 단계적으로 시도합니다. 1. 소규모 다중 파일 수정 2. 낮은 위험도의 명령 실행 허용 3. 마지막으로 더 복잡한 에이전트형 리팩터링 처음부터 대규모 저장소에서 광범위한 자동 작업을 실행하게 하는 것은 권장하지 않습니다. ## 권장 모델 설정 | 사용 시나리오 | 권장 모델 | 이유 | | ------------- | ----------------- | -------------------------------------------------- | | 기본 주력 에이전트 | `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, 원격 개발 머신, 팀 공용 환경은 토큰을 분리 | | 권한 분리 | 강력 권장 | 위험도가 높은 저장소는 더 작은 할당량의 별도 토큰을 설정하는 것이 좋음 | ## 검증 체크리스트 * [ ] `git --version` 정상 작동 * [ ] VS Code가 정상적으로 설치됨 * [ ] 터미널에서 프로젝트를 열어야 한다면 `code --version`도 정상 작동 * [ ] Cline 확장이 설치되어 있고 열 수 있음 * [ ] Cline에서 `OpenAI Compatible` provider를 선택함 * [ ] `Base URL`이 `https://api.crazyrouter.com/v1`로 설정됨 * [ ] `API Key`가 올바르게 입력됨 * [ ] `Model ID`에 사용 가능한 모델이 입력됨 * [ ] 첫 읽기 전용 작업이 성공적으로 실행됨 * [ ] 파일 읽기/쓰기 또는 명령 실행 작업이 예상대로 동작함 * [ ] Crazyrouter 관리 화면 로그에서 해당 요청을 확인할 수 있음 ## 자주 발생하는 오류와 해결 방법 | 현상 | 흔한 원인 | 해결 방법 | | --------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------- | | 확장은 설치됐지만 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 방식보다 "진짜 코드 에이전트" 역할에 더 적합할 것입니다.