Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Opilot은 Ollama 생태계를 VS Code의 Copilot Chat 인터페이스에 통합한 확장 프로그램입니다. 이를 통해 사용자는 로컬 또는 클라우드 모델을 에디터를 벗어나지 않고도 사용할 수 있습니다. 전용 사이드바에서 다양한 모델 관리 및 상세 설정이 가능하여 개발 워크플로우를 강화합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Version Tests 
codecov 
License: MIT
Opilot은 완전한 Ollama 생태계 — 로컬 모델, 클라우드 모델, 그리고 Ollama 모델 라이브러리 — 를 VS Code의 Copilot Chat 인터페이스에 직접 통합합니다. 로컬 모델을 사용할 때 사용자의 대화 내용은 기기를 벗어나지 않으며, 에디터를 떠나지 않고도 모델 간 전환이 가능합니다.
<p align="center"> <a href="https://opilot.self.agency">📖 문서</a> • <a href="https://marketplace.visualstudio.com/items?itemName=selfagency.opilot">🛒 마켓플레이스</a> • <a href="https://github.com/selfagency/opilot">🐙 GitHub</a> • <a href="https://github.com/selfagency/opilot/issues">🐛 이슈</a> </p> <p align="center"> <a href="https://ollama.ai">🌐 Ollama</a> • <a href="https://github.com/ollama/ollama">📖 Ollama 레포</a> • <a href="https://ollama.ai/library">📚 모델 라이브러리</a> </p>🦙 모든 Ollama 모델: Ollama Library의 모든 모델을 첫 번째 등급의 Copilot 채팅 모델 및 @ollama 참여자로 사용할 수 있으며, Cloud 모델( ollama login 후)도 포함됩니다.
🛠️ 모델 관리 사이드바: 전용 Ollama 활동 바 패널에서 모델을 가져오고(Pull), 실행하고(Run), 검사하며(Inspect), 중지시키고(Stop), 삭제할 수 있으며, 실시간 상태 배지가 제공됩니다.
🎛️ 모델별 설정 패널: 에디터 내 웹뷰에서 온도(temperature), top-p/top-k, 컨텍스트(context), 최대 토큰(max tokens), 사고 예산(thinking budget)을 조정할 수 있습니다. 이 설정은 모델별로 유지됩니다.
📡 상태 표시줄 하트비트: 실행 중인 모델 개수, 연결 상태, 리소스 툴팁이 표시되는 항상 보이는 Ollama 서버 인디케이터가 제공됩니다.
💬 채팅 참여자: Copilot Chat에서 @ollama를 호출하여 선택한 로컬 모델과의 전용적이고 히스토리 인식적인 대화를 나눌 수 있습니다.
📝 Modelfile 관리자: 구문 강조 표시, 호버 문서화(hover documentation), 자동 완성 기능이 있는 사용자 지정 Ollama modelfile을 생성하고 편집하며 빌드할 수 있습니다.
⌨️ 인라인 코드 완성: 타이핑하는 동안 로컬 Ollama 모델을 이용한 채우기(fill-in-the-middle) 코드 제안을 받을 수 있습니다.
🔧 도구 호출 (Tool Calling): 호환 가능한 모델(MCP 서버, VS Code 명령어, 사용자 지정 스킬)을 위한 에이전트 워크플로우에서 전체 도구/함수 호출 지원 기능을 제공합니다.
🖼️ 비전 지원 (Vision Support): 비전 기능이 있는 모델에 이미지 입력을 할 수 있습니다. 비전 기능이 없는 모델의 경우 프롬프트 오버플로우를 방지하기 위해 이미지가 자동으로 제거됩니다.
💭 사고 모델 (Thinking Models): 체인 오브 소트(chain-of-thought)를 노출하는 모델(예: DeepSeek-R1, Qwen QwQ, Kimi)의 경우 접을 수 있는
VS Code 1.111.0 이상
GitHub Copilot Chat 확장 프로그램 설치 및 활성화
로컬에 Ollama 설치 (Download) 또는 사용자가 제어하는 원격 Ollama 인스턴스
ollama serve 또는 앱 열기).vsix 파일을 설치)llama3.2:3b)@ollama를 입력하여 채팅합니다확장 프로그램은 로컬의 http://localhost:11434에 있는 Ollama 인스턴스를 자동으로 감지합니다. 클라우드 모델을 사용하려면 먼저 ollama login을 실행해야 합니다. 원격 인스턴스를 사용하려면 VS Code 설정에서 opilot.host를 설정하십시오 (레거시 ollama.host도 여전히 지원됩니다).
VS Code 설정을 열고 (Ctrl+, / Cmd+,)
레거시 ollama.* 설정은 계속 작동하며 활성화 시 자동으로 마이그레이션됩니다.
원격 Ollama 인스턴스를 사용하려면, opilot.host를 원격 서버가 가리키도록 업데이트하세요.
@ollama 핸들 없이 Copilot Chat에서 Ollama 모델을 사용하려면:
어떤 Copilot Chat 입력창에든 @ollama를 입력하여 대화를 로컬 Ollama 인스턴스로 직접 연결할 수 있습니다:
@ollama explain the architecture of this TypeScript project
참여자(participant)는 고정적입니다. 한 번 호출되면 해당 스레드 동안 활성 상태를 유지합니다.
opilot.completionModel을 로컬에 설치된 모델로 설정하여 타이핑하는 동안 인라인 코드 완성을 얻을 수 있습니다. 작고 빠른 모델이 가장 좋습니다:
qwen2.5-coder:1.5bdeepseek-coder:1.3bstarcoder2:3b완성은 모델이 지원하는 경우 필 인 더 미들 (fill-in-the-middle, FIM) 방식을 사용하며, opilot.enableInlineCompletions로 토글할 수 있습니다.
Ollama 활동 바 아이콘을 열면 네 개의 패널이 있는 사이드바가 나타납니다:
opilot.localModelRefreshInterval)을 통해 구성 가능); 설정이 변경되면 새로고침 간격은 자동으로 재시작됩니다.Ollama: Open Model Settings를 열거나(또는 로컬 모델의 기어 아이콘 클릭) 모델별 생성 오버라이드를 구성할 수 있습니다.
num_ctx)num_predict)think)think_budget)변경 사항은 즉시 적용되며 확장 프로그램의 전역 저장소에서 모델별로 영구 저장됩니다.
Opilot은 지속적인 상태 표시줄 항목을 추가합니다:
$(loading~spin) Ollama…$(pulse) Ollama 또는 $(pulse) Ollama (N)$(warning) Ollama offline상태 표시줄 항목을 클릭하거나 Ollama: Check Server Health를 실행하여 즉시 연결 상태 확인을 할 수 있습니다.
ollama login 필요)사용자 지정 Ollama modelfile을 생성하고 관리하기 위한 Modelfile Manager 패널. 아래 Modelfile Manager를 참조하세요.
Modelfile Manager 패널 헤더의 + 버튼을 클릭합니다. 대화형 마법사가 다음 과정을 안내합니다:
pirate-bot)마법사는 파일을 생성하고, 선택한 설정으로 미리 채운 후 편집기에서 열어줍니다.
패널에서 아무 .modelfile을 마우스 오른쪽 버튼으로 클릭하고 **Modelfile에서 모델 빌드(Build Model from Modelfile)**를 선택하거나 (명령 팔레트를 사용: Ollama: Build Model from Modelfile) 이 기능을 사용할 수 있습니다. 이렇게 하면 파일로 ollama create가 실행되고 VS Code 알림에 진행 상황이 스트리밍됩니다.
모든 .modelfile 파일은 다음을 제공받습니다:
FROM, PARAMETER, SYSTEM, TEMPLATE, ADAPTER, LICENSE, MESSAGE, REQUIRES), 매개변수 이름, 숫자, 문자열 및 주석# Modelfile — pirate-bot
FROM llama3.2:3b
...
전체 구문 참조는 Ollama Modelfile Docs를 참고하세요.
Ollama의 보안 및 개인 정보 보호 모델에 대한 자세한 내용은 Ollama GitHub 리포지토리를 참고하세요.
pnpm install
# 빠른 명령어
pnpm run compile # 타입 검사 + 린트 + 번들링 (Task에 위임)
pnpm run watch # 타입 검사와 번들을 위한 병렬 감시 (Task에 위임)
프로젝트는 Task(go-task)를 표준 실행기로 사용합니다. 위의 package.json 스크립트는 기여자 및 CI를 위해 발견 가능하고 일관된 인터페이스를 제공하기 위해 Task에 위임하는 얇은 래퍼입니다. 선호한다면 Task로 직접 작업을 실행할 수 있습니다:
task compile
task unit-test-coverage
task extension-tests
로컬에 Task가 설치되어 있지 않다면, CI는 go-task/setup-task 액션을 사용합니다. 또는 pnpm/pnpx를 통해 실행할 수 있습니다: `pnpm dlx task <name>`.
pnpm test # 단위 테스트 (unit tests) (Vitest)
pnpm run test:coverage # 커버리지를 포함한 단위 테스트 (target: 85%)
pnpm run test:extension # VS Code 통합 테스트 (integration tests)
...
VS Code에서 프로젝트를 열고 F5를 눌러 확장 프로그램이 로드된 Extension Development Host를 실행합니다.
MIT License - 자세한 내용은 LICENSE를 참조하세요.
Daniel Sieradski (@selfagency)가 유지보수합니다.