VSCode에서 Claude API 연결하는 법 (Continue.dev) — Claude 에이전트 팀 시리즈 1편

---

Date: 2026-05-22

이 시리즈는 Claude 에이전트 팀을 구성해서 React + Spring Boot 포트폴리오 웹사이트를 만드는 과정을 기록한다.
1편에서는 VSCode 안에서 Claude를 채팅으로 쓸 수 있도록 환경을 세팅한다.

왜 Continue.dev인가?

GitHub Copilot Chat 대신 Continue.dev를 선택한 이유는 간단하다.

• 원하는 모델(Claude)을 직접 연결할 수 있다
• VSCode 채팅창에서 코드 파일을 컨텍스트로 넘기기 편하다
• 에이전트별 Custom Commands 등록이 가능하다
• 오픈소스라 설정을 내 마음대로 제어할 수 있다

전체 세팅 순서

1. Continue.dev 설치
2. Anthropic API 키 발급
3. Claude 모델 연결
4. 동작 확인

---

1단계 — Continue.dev 설치

VSCode Extensions 탭에서 Continue 검색 후 설치한다.

또는 터미널에서:

code --install-extension Continue.continue

설치하면 VSCode 좌측 사이드바에 Continue 아이콘이 생긴다.

---

2단계 — Anthropic API 키 발급

console.anthropic.com 접속 → API Keys 탭 → Create Key

⚠️ 키는 생성 시 한 번만 보여준다. 반드시 복사해서 안전한 곳에 저장할 것.

무료 크레딧이 있으니 처음엔 결제 없이 테스트 가능하다.

---

3단계 — Claude 모델 연결

Continue 설정 파일을 열어 Claude를 연결한다.

방법 1: UI에서 설정

Continue 사이드바 하단 설정 아이콘 → Add Model → Anthropic 선택 → API 키 입력

방법 2: config.json 직접 수정 (추천)

~/.continue/config.json 파일을 열어 아래 내용을 추가한다.

{
  "models": [
    {
      "title": "Claude Sonnet 4.6",
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "apiKey": "sk-ant-여기에_API_키_입력"
    }
  ]
}

⚠️ API 키를 절대 Git에 커밋하지 말 것. .gitignore에 config.json을 추가하거나 환경변수로 관리한다.

# .gitignore
.continue/config.json

---

4단계 — 동작 확인

VSCode에서 Cmd+L (Mac) 또는 Ctrl+L (Windows) 로 Continue 채팅창을 연다.

아래처럼 입력해보자.

안녕! 지금 어떤 모델이야?

Claude가 응답하면 성공이다.

---

에이전트 팀을 위한 Custom Commands 등록 (보너스)

이 시리즈의 핵심인 에이전트 역할 전환을 편하게 하려면 Custom Commands를 등록해두면 좋다.

~/.continue/config.json에 아래 내용을 추가한다.

{
  "models": [...],
  "customCommands": [
    {
      "name": "fe",
      "description": "Frontend Agent 모드로 전환",
      "prompt": "You are the Frontend Agent. Stack: React 18, TypeScript, Tailwind CSS. Only write frontend code. Always follow the conventions in CLAUDE.md."
    },
    {
      "name": "be",
      "description": "Backend Agent 모드로 전환",
      "prompt": "You are the Backend Agent. Stack: Spring Boot 3, Java 21, PostgreSQL. Only write backend code. Always follow the conventions in CLAUDE.md."
    },
    {
      "name": "qa",
      "description": "QA Agent 모드로 전환",
      "prompt": "You are the QA Agent. Review the code for bugs, security issues, and convention violations. Output a structured review report."
    }
  ]
}

채팅창에서 /fe, /be, /qa 를 입력하면 해당 에이전트 모드로 바로 전환된다.

---

다음 편 예고

2편에서는 실제 프로젝트 폴더를 만들고, 에이전트 팀의 두뇌인 CLAUDE.md 를 작성한다.
LLM에게 장기 기억이 없는 이유와, 그걸 CLAUDE.md로 보완하는 원리도 같이 설명한다.

시리즈 전체 코드는 GitHub에서 공개 예정.