설정 및 구성

로컬 CLI 연결하기

Dev Space(대시보드 → Dev Space)의 CLI 연결 영역에서는 컴퓨터에 이미 설치된 AI CLI를 Pluely가 감지해 쓰게 할 수 있어요. 그러면 요청이 Pluely 관리형 모델 대신 그 로컬 도구를 거쳐 처리돼요.

지원하는 CLI

Pluely는 많이 쓰이는 AI CLI 다섯 가지를 감지하고 연결할 수 있으며, 각각 전용 설정 페이지가 있어요.

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

이 중 하나라도 컴퓨터에 설치되어 있다면, 경로나 설정을 직접 입력하지 않아도 CLI 연결에서 찾아내요.

CLI 연결하기

Dev Space를 열고 CLI 연결로 가세요(Dev Pro에서는 2단계. 답변을 받으려면 AI 연결, 그다음 이 컴퓨터의 CLI 사용).
Pluely가 컴퓨터에 설치된 지원 CLI를 검색해요(버전도 표시돼요).
원하는 CLI에서 연결을 클릭하세요.
연결한 CLI가 이제 오버레이 “모델 선택” 선택기의 맨 위에 내 CLI로 나타나며, 어떤 질문에든 바로 쓸 수 있어요.

터미널에서는 되는데 Pluely에서는 안 될 때

연결됨 옆의 테스트를 누르세요(Dev Pro에서는 2단계 → 이 컴퓨터의 CLI 사용에 있어요). Pluely가 오버레이가 쓰는 것과 똑같은 경로로 CLI에 한 단어짜리 응답을 요청하고, 해당 줄 아래에 “연결 및 테스트 완료” 또는 CLI 자체의 오류를 표시해요. 그 메시지가 진단 정보예요. Pluely는 터미널의 PATH도 CLI에 넘겨 주므로, npm이나 nvm으로 설치한 도구(Node 스크립트)도 셸에서와 똑같이 시작돼요. 오버레이에서 질문이 실패하면 이제 일반적인 오류 대신 CLI가 보고한 내용을 그대로 보여 줘요.

모델 고르기: 모든 CLI에서

연결한 모든 CLI에는 해당 줄 바로 아래에 모델 패널이 생겨요.

Claude Code, Gemini CLI, OpenAI Codex, Qwen Code: 잘 알려진 모델(예: Sonnet/Opus/Haiku, Gemini 3 Pro, GPT-6 Astra, Qwen3 Coder) 중에서 고르거나, 사용자 지정 모델 ID를 입력하거나, 기본값(CLI에서 결정) 그대로 두세요.
Ollama: 패널에 로컬에 내려받은 모델이 나열되며, 하나를 꼭 골라야 해요(기본값이 없어요).

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

스크린샷과 이미지

모델 패널에서 현재 설정이 이미지를 볼 수 있는지 알려 줘요. Claude Code, Gemini CLI, OpenAI Codex, Qwen Code는 비전을 지원하고, Ollama는 내려받은 모델에 따라 달라요(llava, gemma3, qwen-vl 등 멀티모달 계열은 이미지 지원이 자동으로 켜져요). 비전을 쓸 수 있으면 캡처, 선택 영역, “이미지 사용”이 모두 CLI를 통해 동작해요.

생각하는 모델

추론 모델은 모든 CLI에서 완전히 지원돼요. 생각 과정(thinking) 출력은 자동으로 제거되므로 항상 깔끔한 최종 답변만 받아요.

새로고침과 연결 해제

새로고침: “CLI 연결” 제목 옆의 새로고침 버튼으로 다시 검색해요. 새 CLI를 설치한 직후 등에 쓰세요(감지하는 동안 버튼이 돌아가요).
연결 해제: 현재 CLI 연결을 제거해요. 다시 연결할 때까지 오버레이의 “내 CLI” 그룹이 사라져요.

Pro 기능이에요

CLI를 연결하려면 활성 라이선스가 필요해요. 유료 플랜이나 Dev Pro 평생 라이선스 중 하나면 돼요. 라이선스가 없으면 이 영역에 연결 과정 대신 “업그레이드하여 CLI 잠금 해제” 안내가 표시돼요.

CLI를 연결하는 이유

Claude Code, Gemini CLI, OpenAI Codex, Qwen Code, Ollama처럼 이미 컴퓨터에 설치된 CLI로 요청을 처리하면 그 요청은 Pluely 서버를 전혀 거치지 않아요. 연결한 도구가 로컬에서 요청을 처리하고 Pluely는 그쪽으로 전달할 뿐이에요. 질문과 컨텍스트가 내 컴퓨터 밖으로 절대 나가지 않는다는 가장 강력한 보장이 필요할 때 쓰는 옵션이에요.