PluelyPluely도움말

가이드

Pluely에 로컬 AI CLI 연결하는 방법

Pluely의 질문을 이미 쓰고 있는 CLI(Claude Code, Gemini CLI, OpenAI Codex, Qwen Code, Ollama)로 처리해서, 답변이 내 컴퓨터의 도구에서 나오게 하세요. 연결하면 내 CLI가 오버레이 모델 선택기 맨 위에 자리 잡아요.

Pluely에서 “내 CLI”란

오버레이의 모델 선택기는 내 CLI, 웹 검색 / Pluely 모델, 내 제공업체로 그룹이 나뉘어 있어요. “내 CLI”는 내 컴퓨터에 설치되어 Pluely가 직접 연결하는 로컬 AI 명령줄 도구예요. CLI가 연결되어 있는 동안에는 그것이 활성 선택이에요. 답변은 호스팅 모델이 아니라 그 CLI를 통해 로컬에서 실행돼요.

지원하는 CLI

  • Claude Code: Anthropic의 CLI로, 내 Claude 구독에서 Sonnet / Opus / Haiku를 써요.
  • Gemini CLI: Google AI 플랜이나 Gemini API 키로 쓰는 Google의 CLI예요.
  • OpenAI Codex: 내 ChatGPT 플랜에서 GPT-6급 모델을 써요.
  • Qwen Code: Alibaba Cloud Coding Plan이나 Model Studio API 키로 쓰는 Qwen3-Coder 모델이에요.
  • Ollama: 내 하드웨어에서 완전히 오프라인으로 실행되는 오픈 모델이에요.

단계별 안내: CLI 연결하기

  1. 터미널에서 CLI가 설치되어 잘 동작하는지 확인하세요(계정이 필요한 CLI라면 먼저 터미널에서 로그인하세요).
  2. 대시보드(오버레이 왼쪽 위의 홈 아이콘) → Dev Space → CLI 연결을 여세요.
  3. Pluely가 설치된 CLI를 자동으로 감지하고 각각의 버전을 보여 줘요. 경로를 입력할 필요가 없어요. 방금 설치했나요? 섹션 제목 옆의 새로고침 버튼을 눌러 다시 검색하세요.
  4. 원하는 CLI에서 연결을 클릭하세요.
  5. 연결된 줄 아래에 모델 패널이 생겨요. 잘 알려진 모델을 고르거나, 사용자 지정 모델 ID를 입력하거나, 기본값(CLI에서 결정) 그대로 두세요. 예외는 Ollama로, 로컬에 내려받은 모델 중 하나를 꼭 골라야 해요.
  6. 오버레이의 모델 선택기를 여세요. 내 CLI가 모델과 함께 첫 번째 항목으로 표시돼요(예: Claude Code · opus).

스크린샷과 생각하는 모델

  • 모델 패널에서 현재 설정이 이미지를 볼 수 있는지 알려 줘요. Claude Code, Gemini CLI, OpenAI Codex, Qwen Code는 비전을 지원하고, Ollama는 내려받은 모델에 따라 달라요(llava, gemma3, qwen-vl 등 멀티모달 계열).
  • 추론/생각하는 모델은 모든 CLI에서 동작해요. 사고 과정은 자동으로 제거되므로 최종 답변만 보여요.

로컬 우선이 중요한 이유

연결한 CLI는 내 컴퓨터에서 실행되므로, 요청이 Pluely의 관리형 인프라에 닿으려고 기기 밖으로 나갈 필요가 없어요. 이미 CLI 구독료를 내고 있거나 CLI를 관리하고 있다면, Pluely는 이미 신뢰하는 도구 위에 얹는 편리한 오버레이가 돼요. 새로운 관리형 모델이 끼어들지 않아요.

Pluely 관리형 모델로 돌아가기

모델 선택기를 열고 “Pluely 모델”이나 “내 제공업체” 아래의 아무 옵션이나 선택하세요. 그러면 CLI 모드가 일단 꺼지고, 다시 연결하려면 Dev Space에서 클릭 한 번이면 돼요. 연결을 완전히 제거하려면 CLI 줄의 연결 해제를 쓰세요.

응답하지 않는 CLI 문제 해결

  • Pluely 밖에서, 터미널에서 CLI를 실행해 보세요. 거기서도 실패한다면(로그인 만료, 구독 없음 등) 먼저 터미널에서 해결하세요. Pluely도 따라서 동작해요.
  • 문제가 생기면 Pluely가 CLI 자체의 오류 메시지를 보여 주므로, 대개 오버레이에 해결 방법이 바로 나와 있어요.
  • CLI를 방금 설치하거나 업데이트했나요? “CLI 연결” 옆의 새로고침 버튼을 눌러 다시 감지하세요.
  • 사용자 지정 모델 ID에서 오류가 나나요? 기본값(CLI에서 결정) 옵션으로 되돌리세요. 언제나 동작해요.
  • Gemini CLI의 “trusted directory” 요구 사항과 Codex의 git 저장소 확인은 Pluely가 자동으로 처리해요. 플래그가 필요 없어요.

팁

  • Claude Code, Gemini CLI, OpenAI Codex, Qwen Code는 각자의 계정이 필요해요. Pluely는 그 요금을 관리하지 않고, 이미 설치된 도구에 연결할 뿐이에요.
  • 완전히 오프라인으로, 비용 없이 로컬 추론을 하고 싶다면 Ollama가 좋은 선택이에요.
  • CLI는 따로 최신 상태로 유지하세요. Pluely는 내 컴퓨터에 있는 버전을 그대로 호출해요.
  • CLI와 Pluely 관리형 모델을 자주 오간다면, 오버레이 맨 위의 모델 선택기로 클릭 한 번에 전환할 수 있어요.

관련 문서

최종 업데이트: 2026년 7월 10일 · pluely.com