“오픈코드를 설치했는데, 어디서부터 시작해야 할까요? 모델은 어떻게 고르고 내 작업 폴더는 어떻게 연결하죠?”
처음 만나는 화면이 낯설어도 걱정하지 마세요. 이번 글에서는 유튜브 초보자 튜토리얼을 바탕으로 오픈코드 데스크톱을 설치하고, 모델 제공자를 연결하고, 안전한 프로젝트 작업대를 만드는 첫 과정을 차근차근 정리합니다.
안녕하세요. 시니어 회사원의 시선에서 AI 실무 도구를 가장 쉽고 실용적으로 해설하는 블로그의 열여섯 번째 글입니다.
지난 #15편에서는 baoyu-youtube-transcript 스킬을 설치해 유튜브 영상의 자막을 추출하고 요약하는 방법을 살펴보았습니다. 이번 글은 그 자막을 제공한 초보자 튜토리얼을 토대로, 오픈코드를 처음 실행한 뒤 첫 프로젝트를 시작하는 과정을 다룹니다.
| 참고 영상은 **“Learn 80% of OpenCode Desktop in 20 Minutes! | Full Beginner Tutorial”**입니다. 영상은 설치, 제공자 연결, Build/Plan 모드, 스킬, MCP, AGENTS.md, GitHub 연결까지 폭넓게 다루므로 초보자가 따라 하기 좋게 세 편으로 나누어 정리합니다. |
AGENTS.md·GitHub 연결영상의 화면과 메뉴 이름은 제작 시점의 버전을 기준으로 합니다. 오픈코드는 업데이트가 잦으므로 현재 화면에서 메뉴 위치나 제공자 목록이 다를 수 있습니다. 특히 가격·무료 모델·구독 연동 여부는 각 서비스의 최신 안내를 확인하세요.
영상은 오픈코드의 가장 큰 특징으로 여러 모델 제공자를 선택할 수 있는 유연성을 꼽습니다. 특정 회사 모델 하나에만 고정되지 않고, 제공자 설정에 따라 여러 모델을 바꾸어 사용할 수 있습니다.
반면, 특정 모델과 도구에 맞춰 긴밀히 최적화된 제품은 사용 경험이 더 매끄러울 수 있습니다. 따라서 “무조건 어느 쪽이 더 낫다”기보다, 선택의 폭과 사용 편의성 중 무엇을 우선할지가 선택 기준입니다.
| 비교 기준 | 오픈코드 | 특정 제공자 중심 코딩 에이전트 |
|---|---|---|
| 모델 선택 | 여러 제공자 및 모델을 설정해 선택 가능 | 해당 생태계의 모델과 기능에 최적화되는 경우가 많음 |
| 유연성 | 모델을 바꿔 시험하기 편리 | 제공자 생태계 안에서 일관된 사용 경험 |
| 초보자 고려점 | 제공자·모델·비용 설정을 이해해야 함 | 시작은 쉬울 수 있으나 선택 폭은 제품별로 다름 |
영상에서 언급하는 제공자와 모델은 시간이 지나면 바뀔 수 있습니다. 특정 모델의 성능이나 가격을 고정된 사실처럼 받아들이기보다, 현재 오픈코드의 모델 목록과 제공자 공식 페이지를 확인하는 습관이 중요합니다.
오픈코드 데스크톱은 공식 사이트에서 운영체제에 맞는 설치 파일을 받아 설치합니다.
기존 설치 방법이 필요하다면 블로그 #02편 「Mac & Windows 완벽 가이드: 오픈코드 데스크탑 및 CLI 설치법」을 함께 참고하세요.
초보자 안전 수칙
오픈코드는 프로젝트 파일을 읽고 수정할 수 있는 도구입니다. 처음에는 문서 전체나 바탕화면이 아니라, 실습용으로 새로 만든 빈 폴더를 작업 공간으로 지정하세요. 이 원칙은 #13편에서 자세히 다룬 내용입니다.
오픈코드를 실행하면 기본 제공 모델이 보일 수 있습니다. 영상에서는 모델 관리(Model) 메뉴에서 제공자를 추가하고, 인증을 마친 뒤 사용할 모델을 선택하는 흐름을 보여줍니다. 메뉴의 정확한 이름은 앱 버전에 따라 다를 수 있습니다.
영상 제작 당시에는 OpenCode Zen이라는 이름으로 소개되었지만, 현재 공식 문서에서는 계정·결제·모델 접근 등을 관리하는 서비스 이름을 OpenCode Console로 안내합니다. 따라서 초보자 입장에서는 “Zen 제공자를 연결한다”기보다 Console에서 크레딧을 충전하거나 구독/제공자를 설정한 다음, 오픈코드에서 Console 워크스페이스를 연결한다고 이해하는 편이 정확합니다.
현재 공식 제공자 안내에서는 연결 항목을 OpenCode Models로 표기하고, /connect에서 OpenCode를 선택해 Console에서 발급한 API 키를 입력하는 절차를 설명합니다. 데스크톱 화면의 메뉴 문구는 버전에 따라 다를 수 있지만, Console은 관리·결제 화면/서비스, OpenCode Models는 오픈코드 팀이 검증해 제공하는 모델 목록이라는 구분에 유의하세요.
OpenCode Go는 Console과 같은 이름의 제공자나 단순한 종량제 옵션이 아니라, 오픈 모델에 접근할 수 있는 별도의 구독 플랜입니다. Console에서는 크레딧을 사용할 수도 있고, Go 또는 다른 지원 옵션을 선택할 수도 있습니다. 가격·모델 제공 범위와 사용 한도는 바뀔 수 있으니 공식 Console 안내와 제공자 문서에서 결제 전에 확인하세요.
API 키는 비밀번호처럼 취급하고 공개 채팅, 블로그, 코드 저장소에 올리지 마세요.
ChatGPT 등 기존 구독을 연결할 수 있는지는 현재 오픈코드의 공식 제공자 목록과 해당 서비스 약관을 확인해야 합니다. 구독이 있다고 해서 API 사용료가 자동으로 포함된다고 단정하지 마세요.
모델 및 결제에 대한 상세한 안내는 이전 글 #05편(오픈코드 콘솔 및 선결제), #06편(무료 모델 활용)도 참고할 수 있습니다. #05편의 용어와 화면 설명은 작성 당시 기준일 수 있으므로, 현재는 OpenCode Zen 대신 OpenCode Console이라는 명칭과 최신 공식 안내를 기준으로 확인하세요. 가격 및 모델 가용성도 달라질 수 있습니다.
AI가 어디에서 작업할지를 먼저 정해야 합니다. 영상에서는 프로젝트 추가 기능을 사용해 폴더를 선택합니다.
~/Documents/opencode-first-project내 컴퓨터
└── Documents
└── opencode-first-project ← 오픈코드가 작업할 범위를 직접 지정
처음부터 중요한 업무 자료가 있는 폴더를 지정하지 말고, 실습용 폴더에서 먼저 익숙해지는 편이 안전합니다. 프로젝트를 왜 분리해야 하는지, 폴더를 어떻게 연결하는지는 #13편 「내 컴퓨터에 전용 AI 작업대 만들기」에 자세히 정리되어 있습니다.
영상에서는 설정 화면에서 파일 트리와 에이전트 표시 같은 UI 옵션을 켜고, 새 세션을 열어 변경 사항을 확인하는 과정을 소개합니다. 이 옵션은 화면을 살펴보기 편하게 해주는 표시 설정이지, 프로젝트 안전성을 대신 보장하는 기능은 아닙니다.
설정 메뉴를 열어 다음을 확인해 보세요.
영상 제작 당시 특정 옵션이 바로 나타나지 않는 상황도 소개하지만, 이는 현재 버전에서 동일하게 재현된다고 볼 수 없습니다. 화면이 다르면 앱을 최신 버전으로 확인하고, 설정 메뉴와 공식 문서를 기준으로 진행하세요.
이번 편에서는 설치 후 첫 프로젝트 작업대를 준비했습니다. 다음 #17편에서는 영상 속 회의록을 PDF로 정리하는 앱 제작 과정을 따라갑니다.
처음부터 중요한 프로젝트에 적용하지 말고, 이번 편에서 만든 빈 실습 폴더를 그대로 사용하면 안전하게 연습할 수 있습니다.
| 원본 영상: [Learn 80% of OpenCode Desktop in 20 Minutes! | Full Beginner Tutorial](https://youtu.be/npjJyQnLM6U) |
작성일: 2026년 11월 05일
태그: #오픈코드 #OpenCode #OpenCodeDesktop #초보자가이드 #모델제공자 #프로젝트폴더 #AI코딩 #시니어AI