opencode-guide

[시니어 직장인의 AI 탐구기 #13] 내 컴퓨터에 전용 AI 작업대 만들기! 오픈코드 새 프로젝트 생성 및 폴더 연결 완벽 가이드

“오픈코드를 켜긴 했는데, 내 컴퓨터의 어떤 폴더를 어떻게 연결해야 안전하고 효율적으로 일할 수 있을까요?”
AI에게 아무 데서나 일하라고 하면 중요한 개인 파일이 훼손되거나 엉뚱한 데이터를 읽어버립니다. AI 비서에게 ‘전용 책상(프로젝트 폴더)’을 배정해 주는 것이 실무의 가장 중요한 출발점입니다.

안녕하세요. 시니어 회사원의 시선에서 AI 실무 도구를 가장 쉽고 실용적으로 해설하는 블로그의 열세 번째 글입니다.

우리는 앞선 글들에서 오픈코드의 기본 화면 구조부터 다양한 모델 연동, 그리고 유용한 스킬(Skills)과 MCP 플러그인까지 든든하게 장착했습니다.

이제 본격적으로 내 업무(예: 인사 규정 정리, 회계 데이터 분석, 소방 설비 점검 등)를 시작할 차례입니다. 그런데 이때 가장 먼저 해야 할 작업이 바로 “새 프로젝트를 생성하고 내 컴퓨터의 특정 폴더를 오픈코드에 연결하는 일”입니다.

이번 글에서는 도대체 왜 프로젝트를 분리해서 생성해야 하는지 그 결정적인 이유와 함께, 마우스 클릭 3번으로 내 컴퓨터 폴더를 오픈코드와 연결하는 방법을 완벽하게 정리해 드립니다.

1. 왜 프로젝트를 생성하고 특정 폴더에 연결해야 할까?

많은 초보자분들이 “그냥 아무 폴더나 바탕화면 전체를 열어두고 AI를 쓰면 안 되나요?”라고 질문하십니다.

하지만 오픈코드는 일반 챗봇과 달리 내 PC의 파일을 직접 읽고, 쓰고, 삭제하고, 스크립트를 실행하는 ‘자율 에이전트(Agent)’입니다. 따라서 프로젝트 폴더를 명확히 지정하지 않으면 치명적인 문제가 발생할 수 있습니다.

┌────────────────────────────────────────────────────────────────────────┐
│                   [ 프로젝트 폴더를 지정해야 하는 4대 이유 ]             │
├────────────────────────────────────────────────────────────────────────┤
│ 1. 안전한 작업 반경 통제 (보안 격리): 사내 기밀 및 시스템 폴더 침범 방지 │
│ 2. AI 집중도 극대화 (토큰 절약): 쓸데없는 파일 검색 배제, 정답률 상승     │
│ 3. 업무별 독립 환경 구축: 프로젝트마다 다른 AI 모델, 스킬, 규칙 적용 가능 │
│ 4. 완벽한 백업 및 복원: Git 버전 관리와 1:1 매칭되어 1초 만에 되돌리기 가능│
└────────────────────────────────────────────────────────────────────────┘

[표] 전체 PC 연결 vs 독립 프로젝트 폴더 연결 비교

비교 항목 바탕화면/전체 드라이브 연결 시 위험성 전용 프로젝트 폴더 연결 시 강점
보안 및 안전성 개인 사진, 공인인증서, 타 부서 문서 등 실수 수정 위험 지정된 폴더 안에서만 작동하므로 다른 개인 파일 100% 안전
AI 탐색 속도 수십만 개의 불필요한 시스템 파일을 뒤지느라 느려짐 해당 업무 파일 수십 개만 빠르게 색인하여 전광석화 응답
비용 (토큰 소비) 관련 없는 파일들까지 컨텍스트에 포함되어 토큰 낭비 꼭 필요한 데이터만 읽어 API 비용 최소화 (비용 절감)
히스토리 관리 온갖 잡다한 대화가 한곳에 뒤섞여 이전 기록 찾기 불가 업무 프로젝트별로 대화와 작업 기록이 일목요연하게 분리

2. [마우스 클릭 3번] 오픈코드 데스크탑에서 새 프로젝트 연결하기

터미널을 몰라도 누구나 마우스만으로 10초 만에 새 작업대를 만들 수 있습니다.

[1단계] 내 컴퓨터에서 새 작업 폴더 만들기

  1. 맥의 파인더(Finder) 또는 윈도우의 파일 탐색기를 엽니다.
  2. 내가 원하는 안전한 위치(예: 문서 또는 외장 SSD 등)에 새 폴더를 만듭니다.
    • 예시 폴더명: 2026_소방설비_프로젝트 또는 exam03
  3. 그 폴더 안에 작업할 원본 파일(엑셀, HWP, 텍스트 문서 등)을 넣어둡니다.

[2단계] 오픈코드 화면에서 ‘폴더 열기’ 클릭

  1. 오픈코드 데스크탑(Desktop) 앱을 실행합니다.
  2. 화면 좌측 상단 헤더 영역을 보시면 현재 작업 중인 폴더 이름(예: exam02)이나 네모 격자 아이콘(⊞)이 보입니다.
  3. 이 부분을 마우스로 클릭하면 드롭다운 메뉴가 나타납니다.
  4. 메뉴에서 Open Folder... (또는 새 프로젝트 열기)를 클릭합니다.
    • (단축키: Mac Cmd + O / Windows Ctrl + O)

[3단계] 1단계에서 만든 폴더를 선택하고 [열기] 클릭

  1. 내 컴퓨터의 파일 선택 창이 열립니다.
  2. 1단계에서 만들어 둔 2026_소방설비_프로젝트 폴더를 찾아 선택하고 [열기(Open)] 버튼을 누릅니다.
  3. 오픈코드 창이 부드럽게 새로고침되면서 좌측 상단에 방금 선택한 2026_소방설비_프로젝트 이름이 큼직하게 뜹니다.

🎉 축하합니다!
이제 오픈코드는 오직 이 폴더만을 바라보는 전용 안전 작업실(샌드박스)을 구축했습니다.

3. [보너스] 터미널(CLI) 환경에서 1줄로 새 프로젝트 시작하기

터미널 환경을 선호하시는 직장인이나 개발자분들은 키보드 명령어 한 줄로 새 프로젝트를 띄울 수 있습니다.

오픈코드 우측 Terminal 창(또는 맥 터미널)에서 아래 명령어를 실행합니다:

# 1. 새 폴더를 만들고 해당 폴더로 이동
mkdir -p ~/Documents/신규업무프로젝트 && cd ~/Documents/신규업무프로젝트

# 2. 해당 폴더를 작업대로 오픈코드 실행
opencode .

opencode . 명령어의 마침표(.)는 “현재 내가 위치한 이 폴더를 프로젝트 작업 공간으로 열어라”라는 표준 명령어입니다.

4. 실무자를 위한 프로젝트 관리 꿀팁 3가지

팁 1: 프로젝트 간 1초 전환 (Workspace Switch)

화면 좌측 상단의 워크스페이스 격자 아이콘(⊞)을 누르면 최근에 작업했던 프로젝트 폴더 목록이 나옵니다. 클릭 한 번으로 exam02에서 2026_소방설비_프로젝트로 즉시 넘나들 수 있습니다.

팁 2: 프로젝트 전용 맞춤 설정 (.opencode/ 폴더)

프로젝트 폴더 안에 .opencode라는 숨김 폴더를 만들어두면:

팁 3: 프로젝트 시작 직후 추천 첫마디 (프롬프트)

새 폴더를 연결한 후 대화창에 이렇게 먼저 물어보세요:

💬 “현재 프로젝트 폴더에 어떤 파일들이 들어있는지 파일 목록을 확인하고, 각 파일의 성격을 파악해서 간단히 브리핑해줘.”

AI가 폴더 내 문서를 스스로 훑어보고 현재 작업대의 상태를 완벽히 파악한 뒤 지시를 대기합니다.

5. 핵심 조작법 및 단축키 요약표

작업 구분 Desktop (GUI) 조작 Terminal (CLI) 명령어 기능 설명
폴더 열기 좌측 상단 헤더 클릭 ➡️ Open Folder opencode /경로/폴더명 지정한 폴더를 새 프로젝트 작업대로 오픈
단축키 열기 Cmd + O (Mac) / Ctrl + O (Win) opencode . (현재 폴더) 마우스 없이 단축키로 폴더 선택창 호출
프로젝트 전환 좌측 상단 사각 격자 아이콘(⊞) 클릭 opencode session 최근 작업한 프로젝트 목록을 보고 즉시 스위칭
현재 위치 확인 좌측 상단 굵은 글씨 폴더명 확인 pwd 지금 AI가 바라보고 있는 내 PC 폴더 경로 확인

6. 에필로그

목수가 일할 때 연장과 자재를 아무렇게나 바닥에 흩뿌려두지 않고 전용 작업대에 정돈해 두듯, 오픈코드 사용자에게 ‘독립된 프로젝트 폴더’는 안전하고 깔끔한 업무를 위한 기본 중의 기본입니다.

오늘 배운 방법대로 업무 주제별로 폴더를 깔끔하게 분리해 보세요. 폴더 하나가 하나의 강력한 AI 작업실이 되어 여러분의 업무를 완벽하게 서포트해 줄 것입니다.

다음 글에서는 “프로젝트 폴더 안에 실제 업무 엑셀 파일들을 넣고, 수식이 깨진 데이터 정제부터 피벗 분석 보고서 생성까지 단 10초 만에 끝내는 실전 데이터 분석 비법”을 함께 진행해 보겠습니다.

작성일: 2026년 10월 31일
태그: #오픈코드 #OpenCode #프로젝트생성 #폴더연결 #보안격리 #샌드박스 #작업공간 #직장인생산성 #스마트워크 #시니어AI