“Claude CLI”를 커서ai와 연결하는 방법 상세하게 알려줘

작성자:




아래는 Claude CLI를 Cursor AI(이하 “Cursor”)에 완전히 연동해, 에디터 안에서 버튼 클릭만으로 Claude Code 기능을 쓸 수 있도록 설정하는 상세 가이드입니다.

📋 전제 조건

  1. Claude CLI가 이미 전역에 설치되어 있어야 합니다.

    bash
    # 설치 확인
claude --version

  2. 터미널에서 claude 명령어로 정상 동작해야 합니다.

  3. Cursor 최신 버전(2024.6 이상)을 설치해 두세요.

1단계: Cursor 환경 설정 열기

  1. Cursor를 실행한 뒤, 좌측 하단의 ⚙️ Settings 아이콘(또는 Ctrl+,)을 클릭하세요.

  2. Settings 패널 상단 검색창에 “AI” 또는 “External AI”를 입력해 관련 메뉴를 찾습니다.

2단계: External AI Provider 추가

  1. “External AI” (또는 “AI Providers”) 섹션으로 이동합니다.

  2. 우측에 있는 “Add Provider”(또는 “+ New”) 버튼을 클릭합니다.

  3. 새 팝업에서 Provider Type으로 **“Command-Line Interface”**를 선택하세요.

3단계: Provider 상세 설정

설정 항목 입력 값 예시 설명
Name Claude CLI 에디터 내에서 표시될 프로바이더 이름
Executable claude 터미널에서 실행할 명령어 (Windows는 claude.cmd)
Arguments --model=claude-3-sonnet 사용할 Claude 모델 플래그 (선택 사항)
Work Dir ${workspaceFolder} 커맨드가 실행될 기본 경로
Timeout (ms) 60000 최대 응답 대기 시간 (밀리초 단위)

팁:

  • --model 플래그를 지정하지 않으면, 기본 모델(claude-3-sonnet)이 사용됩니다.

  • Work Dir는 프로젝트 최상위 폴더로 설정하면, 해당 폴더 안 파일을 모두 읽고 쓸 수 있습니다.

4단계: 연결 테스트 및 저장

  1. 설정 창 하단의 “Test Connection” 또는 “Run Test” 버튼을 클릭합니다.

  2. 터미널 창에 “Welcome to Claude Code!” 메시지가 뜨면 성공입니다.

  3. “Save” 버튼을 눌러 설정을 저장하세요.

5단계: 에디터에서 Claude 사용해 보기

  1. 코드 편집 화면으로 돌아가, 수정하고 싶은 코드 블록을 드래그하거나 파일 전체를 저장소 뷰어에서 선택합니다.

  2. 블록 선택 시 나타나는 AI 아이콘(또는 우클릭 메뉴) → “Ask External AI” 클릭

  3. 리스트에서 **“Claude CLI”**를 선택

  4. 하단 입력창에 자연어 지시문(예:

    이 함수에 예외 처리 로직 추가해줘

    )을 입력하고 Enter

  5. Claude가 제안한 코드를 Accept, Edit, Reject 할 수 있는 UI가 뜹니다.

6단계: 단축키로 빠르게 호출하기

  • Windows/Linux: Ctrl+Shift+P → “Ask External AI” → 선택

  • macOS: ⌘+Shift+P → “Ask External AI” → 선택

원하는 키 바인딩이 있다면, Settings → Keybindings 에서 “Ask External AI”에 직접 단축키를 지정할 수 있습니다.

7단계: 워크스페이스별 고급 설정 (선택 사항)

프로젝트마다 다른 모델이나 플래그를 쓰고 싶다면, 프로젝트 루트에 .cursor/settings.json 파일을 만들어 아래 예시처럼 작성하세요:

jsonc
{
  "externalAI.providers": [
    {
      "name": "Claude CLI",
      "type": "cli",
      "cmd": "claude",
      "args": ["--model=claude-3-opus-20240229"],
      "cwd": "${workspaceFolder}",
      "timeout": 60000
    }
  ]
}

  • args 배열에 모델, 로깅, 출력 옵션 등을 추가로 지정할 수 있습니다.

✅ 요약

  1. Cursor Settings → External AI → Add Provider

  2. CLI 타입 지정 → claude 명령어, 모델 플래그, 워크 디렉토리 설정

  3. Test Connection → Save

  4. 코드 블록 선택 → Ask External AI → “Claude CLI” → 지시 입력

이제 Cursor AI 안에서 버튼 클릭 한 번으로 Claude Code의 강력한 코드 생성·리팩터링 기능을 바로 사용하실 수 있습니다.

문제가 생기거나 추가 궁금한 점 있으면 언제든 말씀해 주세요!

댓글 남기기