설정 및 구성

Pluely에서 Claude Code 사용하기

Anthropic의 AI CLI인 Claude Code를 연결하면 Pluely 오버레이에서 하는 모든 질문이 내 컴퓨터에서 로컬로, 내 Claude 구독을 통해 처리돼요. Pluely가 호스팅하는 모델은 전혀 쓰지 않아요.

1. 설치하고 로그인하기

아직 없다면 Anthropic에서 Claude Code를 설치하고(예: npm install -g @anthropic-ai/claude-code), 터미널에서 claude를 한 번 실행해 로그인하세요. 터미널에서 claude가 응답하면 Pluely에서도 쓸 수 있어요.

2. Pluely에서 연결하기

대시보드 → Dev Space → CLI 연결을 여세요.
Pluely가 Claude Code를 버전과 함께 자동으로 감지해요. 연결을 클릭하세요.
오버레이 모델 선택기 맨 위에 내 CLI로 나타나요.

방금 설치했나요? “CLI 연결” 제목 옆의 새로고침 버튼을 눌러 다시 검색하세요.

3. 모델 고르기

연결된 Claude Code 줄 바로 아래에 모델 패널이 생겨요.

기본값(CLI에서 결정): Claude Code에 설정된 모델을 그대로 써요. 언제나 동작해요.
Sonnet / Opus / Haiku: 각 계열의 최신 모델이며 항상 최신 상태로 유지돼요(Claude Code 자체 별칭이에요).
사용자 지정 모델 ID: 특정 버전이 필요하면 정확한 모델 ID를 입력하세요.

선택한 모델은 연결 카드와 오버레이 선택기에 표시돼요(예: Claude Code · opus).

이미지도 돼요

Pluely에서 Claude Code는 비전을 지원해요. 질문에 스크린샷이나 이미지를 첨부하면 Claude가 읽어요. 캡처, 선택 영역, “이미지 사용” 컨트롤도 모두 그대로 켜져 있어요.

생각하는 모델도 돼요

확장 사고(extended thinking) 출력은 자동으로 처리돼요. 날것의 사고 과정은 보이지 않고 최종 답변만 볼 수 있어요.

문제 해결

“CLI에서 응답하지 못했어요”: 터미널에서 claude -p "hello"를 실행해 보세요. 거기서도 실패한다면(로그인 만료, 구독 없음 등) 터미널에서 먼저 해결하면 Pluely도 따라서 동작해요.
사용자 지정 모델 ID에서 오류가 나요: 내 계정에 그 ID가 있는지 확인하세요. 기본값은 언제나 동작해요.
세션: Pluely는 대화마다 Claude Code 세션을 하나씩 유지하므로, 후속 질문은 새 메시지만 보내서 더 빨리 답변해요. 오버레이의 “새 메시지”를 누르면 새 세션이 시작돼요.
Homebrew나 npm으로 설치한 경우: macOS에서는 둘 다 찾아내요. npm으로 설치한 Codex는 Windows에서도 동작해요.