Coding Agent 설정

Cline 설치 및 API 설정

Cline을 설치하고 BetterToken Base URL과 API Key를 설정한 뒤 호환 제공자 모델을 선택하고 일반적인 오류를 해결하세요.

Cline을 BetterToken에 연결하려면 API Key를 준비하고 아래 Base URL을 입력한 뒤 모델 광장에서 현재 Model ID를 선택하세요. 비슷한 인터페이스를 사용하는 Roo Code, Kilo Code, MonkeyCode도 함께 확인하세요.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	모델 광장의 현재 Model ID

준비 사항

최신 버전의 도구 설치
BetterToken API Key: 가입 후 발급받기
모델 광장의 Model ID

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

추가 요구 사항

VS Code 설치

설치하기

Cline 설치

VS Code를 열고 확장 프로그램 Marketplace에서 Cline을 검색해 설치하세요.

수동 설정

Cline 설정 UI에서 다음 설정을 완료하세요. 설정 파일을 수정할 필요는 없습니다.

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	모델 광장의 현재 Model ID

설정 절차

충돌하는 환경 변수 제거

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Cline 설정 UI 열기

Cline 사이드바에서 Use your own API key를 클릭하세요.

API 제공자 설정

다음 항목을 입력하세요.

API Provider → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → BetterToken API Key
Model → 모델 광장에서 복사한 지원 제공자의 Model ID

Model Configuration에는 선택한 모델의 확인된 컨텍스트 및 출력 한도를 입력하세요. 모델과 엔드포인트가 모두 지원할 때만 이미지나 Computer Use 기능을 켜세요. Cline provider 설정을 참고하세요.

공식 문서에서 명시적으로 요구할 때만 추가 헤더 설정

Cline의 공식 OpenAI 호환 설정 문서는 Base URL, API Key, Model ID를 중심으로 설명합니다. BetterToken 연결에는 일반적으로 추가 User-Agent가 필요하지 않습니다.

사용자 지정 게이트웨이, 테넌트 라우팅, 관측성 또는 Cache 계층을 함께 사용하는 경우 해당 업스트림 서비스의 공식 문서에 따라서만 헤더를 추가하세요.

설정 저장

Done을 클릭하세요.

Cline 다시 시작

설정을 저장한 뒤 VS Code를 다시 시작하거나 Cline 확장 프로그램을 다시 로드해 새 설정을 적용하세요.

연결 확인

provider 설정에서 Verify로 연결을 확인하세요.

짧은 테스트 프롬프트를 보내세요. 인증 또는 Model ID 오류 없이 응답이 오면 연결이 완료된 것입니다. 설정을 변경한 뒤에는 도구를 완전히 다시 시작하세요.

Cline CLI

공식 Cline CLI를 설치하세요. VS Code 확장 프로그램과 별도로 설치해야 합니다. GPT 모델을 사용한 macOS 테스트에서 Cline CLI 3.0.73은 텍스트 요청과 파일 읽기 도구 호출을 완료했습니다.

YOUR_API_KEY를 BetterToken API Key로, YOUR_MODEL_ID를 모델 광장의 정확한 ID로 바꾼 다음 인증하세요.

cline auth --provider openai --apikey YOUR_API_KEY --baseurl https://bettertoken.ai/v1 --modelid YOUR_MODEL_ID

비대화형 텍스트 확인을 실행하세요.

cline --json --retries 2 --timeout 170 --provider openai --model YOUR_MODEL_ID "Reply with only: OK"

최종 답변이 OK인지 확인하세요. 테스트에서 CLI의 --provider openai는 openai-compatible로 기록되었습니다. 명령줄 값은 IDE의 OpenAI Compatible 메뉴 레이블과 다릅니다. --data-dir로 구성 디렉터리를 선택한다면 두 명령에 같은 디렉터리를 지정하세요.

모델 전환

모델 선택기를 열거나 설정의 Model 필드를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 뒤 현재 세션을 다시 시작하세요.

흔한 오류

오류	확인할 항목
`401` 또는 `Unauthorized`	BetterToken API Key를 확인하고 앞뒤 공백을 제거하세요.
`404`	Base URL을 확인하고 특정 엔드포인트 경로를 추가하지 마세요.
`model not found`	모델 광장에서 현재 Model ID를 복사하세요.
변경 사항이 적용되지 않음	설정을 저장하고 도구를 완전히 다시 시작하세요.

기술 세부 정보

프로토콜, 엔드포인트, 내부 제공자 필드

이 설정은 https://bettertoken.ai/v1을 사용합니다. 도구가 OpenAI 호환 엔드포인트 경로를 추가합니다. 특정 필드에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.