Continue CLI 설정하기: 설치, config.yaml 및 API

Continue CLI는 cn 명령으로 설치되며 에디터의 Continue와 같은 YAML 구성 스키마를 읽습니다. OpenAI 호환 연결에는 openai provider, Base URL, 현재 Model ID, API Key를 안전하게 참조하는 방법이 필요합니다. cn --version으로 설치를 확인한 다음 짧은 대화형 또는 헤드리스 요청을 한 번 실행하세요.

모델을 추가하기 전에 본인의 API Key를 준비하세요. BetterToken 계정 만들기

최신 Continue CLI 가이드를 설정 중에 열어 두세요. 예시의 Model ID는 의도적으로 자리표시자입니다. 설정하는 당일 현재 값을 복사해야 합니다.

터미널 워크플로에서는 BetterToken API endpoint를 직접 구성한 뒤 Dashboard의 요청 기록에서 응답을 확인하세요.

준비할 것

• Continue 공식 installer에 접속할 수 있는 터미널
• 본인의 BetterToken API Key
• 현재 Model ID
• 로컬 config.yaml을 둘 사용자 디렉터리
• 시크릿이나 중요한 파일 접근을 포함하지 않는 짧은 테스트 prompt

BetterToken은 OpenAI 호환 API endpoint를 제공합니다. GitHub, npm, Continue 웹사이트, installer 또는 업데이트에 대한 접근을 보장하지는 않습니다. 러시아에서 BetterToken endpoint에 연결할 때는 VPN이 필요하지 않지만, 나머지 네트워크 단계는 별도로 확인하세요.

1. Continue CLI 설치

현재 Continue 문서는 macOS/Linux용 shell installer를 제공합니다.

curl -fsSL https://raw.githubusercontent.com/continuedev/continue/main/extensions/cli/scripts/install.sh | bash

Windows에서는 공식 문서의 최신 PowerShell 명령을 사용하세요. 지원되는 Node.js 버전이 설치되어 있고 npm을 선호한다면 다음을 사용합니다.

npm install -g @continuedev/cli

첫 오류가 난 뒤 두 방법을 연달아 실행하지 마세요. 먼저 어떤 바이너리와 디렉터리가 이미 만들어졌는지 확인합니다.

설치를 확인합니다.

cn --version

command not found가 아니라 버전이 출력되어야 합니다. 이 글에서는 특정 버전 번호를 고정하지 않습니다.

2. 활성 config.yaml 찾기

macOS/Linux의 기본 경로:

~/.continue/config.yaml

Windows:

%USERPROFILE%\.continue\config.yaml

변경 사항이 적용되지 않으면 여러 사본을 추측으로 편집하지 말고 먼저 --config로 파일을 명시하세요.

3. OpenAI 호환 모델 추가

최소 YAML:

name: BetterToken Continue CLI
version: 0.0.1
schema: v1

models:
  - name: BetterToken model
    provider: openai
    model: YOUR_MODEL_ID
    apiBase: https://www.bettertoken.ai/v1
    useResponsesApi: false
    apiKey: ${{ secrets.BETTERTOKEN_API_KEY }}

YOUR_MODEL_ID를 정확한 현재 ID로 바꾸세요. Continue는 config.yaml의 ${{ secrets.BETTERTOKEN_API_KEY }}를 지원합니다. 같은 이름의 환경 변수나 Continue가 지원하는 다른 secrets source로 값을 전달하고 실제 키를 YAML에 기록하지 마세요.

실제 Key를 저장소에 저장하지 마세요. config.yaml을 공유한다면 secret reference만 남기고, 로컬 credentials 파일을 사용 중인 도구의 ignore 구성에 추가하세요.

4. 대화형 테스트 실행

우선순위 문제를 배제하려면 명시적 구성으로 CLI를 시작하세요.

cn --config ~/.continue/config.yaml

짧은 요청을 보냅니다.

Reply with CONTINUE_OK and do not change files.

첫 실행에 onboarding이 보이면 CLI가 로컬 구성을 인식하는지 확인하세요. 그 화면을 건너뛰려고 Key를 prompt나 공유 로그에 넣으면 안 됩니다.

5. 헤드리스 테스트 실행

일회성 점검에는 현재 cn -p 문법을 사용합니다.

cn --config ~/.continue/config.yaml -p "Reply with CONTINUE_OK and do not change files."

명령이 정상 응답으로 끝나고 예상한 Model ID를 사용하며, 모델·status·Token 사용량이 포함된 BetterToken Dashboard 기록이 만들어지면 테스트에 성공한 것입니다.

일반적인 오류

cn: command not found

shell을 다시 시작하고 PATH를 확인하세요. npm으로 설치했다면 전역 바이너리 디렉터리를 찾습니다. 확인 전에는 두 번째 사본을 설치하지 마세요.

CLI가 config.yaml을 무시함

절대 경로와 함께 --config를 전달하세요. 테스트가 성공한 후에는 이전에 어떤 저장된 구성 또는 기본 구성이 선택되었는지 확인합니다.

401

secret reference, 현재 프로세스에 변수가 존재하는지, Key 안의 공백을 확인하세요. 변수 값은 출력하지 마세요.

404

OpenAI 호환 provider의 Base URL은 다음이어야 합니다.

https://www.bettertoken.ai/v1

apiBase가 API 루트를 기대할 때는 전체 endpoint path를 추가하지 마세요.

model not found

BetterToken 카탈로그에서 현재 Model ID를 복사하세요. 대소문자와 suffix를 확인하고 오래된 글의 이름을 사용하지 마세요.

이 테스트가 실제로 확인하는 것

짧은 요청은 현재 cn이 의도한 YAML을 읽고, secret을 가져오며, 올바른 endpoint에 연결하고, 사용 가능한 Model ID를 사용했음을 확인합니다. 모든 도구, 원격 세션, cloud 기능 또는 Continue integration을 확인하는 것은 아닙니다. 안전하고 범위가 제한된 요청으로 각각 따로 테스트하세요.