OpenPilot: 원하는 모델을 연결하는 AI 코딩 에이전트

OpenPilot은 무엇을 하는 프로그램인가요?

OpenPilot은 컴퓨터에 설치해 쓰는 오픈소스 AI 코딩 에이전트입니다. 언어 모델을 연결하고 프로젝트 폴더를 선택한 뒤 작업을 설명하면, 실제 파일을 만들거나 수정하고 명령을 실행할 수 있습니다. 결과가 작업 폴더에 남으므로 직접 열어 검토하고 이어서 개발할 수 있습니다.

모델 제공자를 직접 고르고 싶은 개발자, 작은 시제품을 만드는 사람, 기존 코드의 오류를 고치는 작업에 적합합니다. 생성된 코드의 검토와 테스트는 사용자가 해야 합니다.

코드 수정부터 실행 결과 확인까지

파일 읽기와 검색, 새 파일 작성, 기존 코드 편집을 지원합니다. 터미널에서는 의존성 설치, 개발 서버 시작, 테스트 실행을 할 수 있으며 출력이 대화에 표시됩니다. 오류 내용을 보고 다음 수정 요청을 이어 가기 좋습니다.

처음에는 상태 확인 엔드포인트와 README가 있는 작은 API처럼 범위가 명확한 작업을 요청해 보세요. 사용할 언어와 완료 조건을 함께 적고, 응답 문구보다 실제 변경 파일과 테스트 결과로 완료 여부를 판단하는 것이 좋습니다.

로컬 모델과 클라우드 API 연결

OpenAI 호환 API를 사용하며 공식 문서는 OpenAI, OpenRouter, Ollama, LM Studio와 사용자 지정 게이트웨이를 예로 듭니다. Ollama 주소 예시는 http://localhost:11434/v1 입니다. 모델 서버를 준비하는 과정까지 자동으로 대신한다는 뜻은 아닙니다.

복잡한 다단계 작업의 품질은 선택한 모델에 좌우됩니다. 공식 FAQ는 긴 리팩터링에 더 강한 모델을 권합니다. Anthropic 기본 API 어댑터는 계획에 있으며, 현재 문서상 연결 경로는 OpenRouter입니다.

설치하고 첫 프로젝트 시작하기

2026년 10월 12일 확인한 v1.0.5에는 Windows 설치형·포터블 EXE와 Apple silicon·Intel Mac용 DMG가 있습니다. 웹사이트의 macOS 출시 예정 문구보다 실제 릴리스 파일을 확인하세요. Windows 안내 조건은 10 이상, x64입니다.

1. 운영체제와 CPU에 맞는 파일을 받습니다.
2. Settings → Models에 Base URL, API 키, 모델 ID를 입력하고 저장한 뒤 모델을 선택합니다.
3. 작업할 프로젝트 폴더를 엽니다.
4. 구체적인 목표를 요청하고 도구 기록과 민감한 명령의 승인 요청을 확인합니다.
5. 수정 파일과 테스트 결과를 검토하고 필요한 후속 작업을 요청합니다.

소스 실행은 Node.js 20+를 준비한 뒤 저장소의 npm 설치·시작 절차를 따릅니다.

무료 앱과 모델 사용료의 차이

2026년 10월 12일 기준 OpenPilot 계정이나 구독은 필요하지 않으며 프로젝트는 MIT 라이선스를 명시합니다. 모델 연결은 사용자가 제공하므로 클라우드 추론과 외부 서비스의 요금·한도는 각각의 제공자 조건을 따릅니다.

모델별 세션 및 누적 토큰 사용량을 확인할 수 있지만 무제한 무료 요청이나 고정 비용을 보장하지 않습니다. 공통 무료 토큰 할당량은 확인되지 않았습니다.

웹 문서 검색, MCP와 프로젝트 기억

실시간 웹 검색과 페이지 가져오기는 TinyFish API 키를 설정해야 사용할 수 있습니다. 키가 없어도 로컬 파일과 터미널 작업은 가능합니다.

MCP 서버는 mcp.json에 추가하고 앱을 다시 시작한 뒤 대화별로 활성화합니다. 도구와 리소스를 연결할 수 있습니다. Skills에는 반복 절차를, AGENTS.md에는 프로젝트 선호사항을 남겨 다음 작업에 활용할 수 있습니다. 이런 지침은 보안 격리 기능을 대신하지 않습니다.

내 컴퓨터에서 실행해도 외부 통신은 확인해야 합니다

클라우드 모델을 선택하면 요청이 해당 제공자에게 전달됩니다. TinyFish나 원격 MCP도 별도 연결을 사용합니다. 로컬 모델을 연결했다고 전체 구성이 자동으로 오프라인이 되는 것은 아닙니다.

공식 저장소의 원격 측정 안내는 익명 사용 통계가 기본 활성화되며 초기 설정 또는 Settings → About에서 끌 수 있다고 설명합니다. 채팅, 파일, 경로, API 키는 제외한다고 명시합니다. 현재 소스에는 새로 저장하는 비밀정보의 로컬 암호화도 있습니다. 오래된 FAQ의 서버 미사용·OS 보관소 설명만으로 완전한 오프라인이나 외부 제공자의 데이터 보존 정책을 보장할 수 없습니다.

자주 묻는 질문

기존 프로젝트를 직접 수정할 수 있나요?

네. 선택한 폴더의 파일을 읽고 수정하며 터미널 검사도 실행할 수 있습니다. 변경 내용은 직접 검토해야 합니다.

무료라면 모델 API 비용도 없나요?

앱 구독료가 없다는 뜻입니다. 모델 및 연결 서비스의 요금과 한도는 별도입니다.

Ollama나 LM Studio를 연결할 수 있나요?

호환 API로 연결할 수 있습니다. 모델과 하드웨어에 따라 결과가 달라지며, 외부 도구나 원격 측정은 인터넷을 사용할 수 있습니다.

공식 자료와 개발자 지원

• 시작 안내서: 모델, 작업 폴더와 확장 기능 설정.
• 공식 소스 저장소: 구현 확인과 소스 실행 방법.
• GitHub Issues: 버전과 재현 절차를 포함한 오류 제보.