opencode-guide

[시니어 직장인의 AI 탐구기 #02] Mac & Windows 완벽 가이드: 오픈코드(OpenCode) 데스크탑 및 CLI 설치법

“도구는 좋은 것 같은데, 설치부터 막히면 어쩌죠?”
새로운 소프트웨어를 설치할 때 검은 화면의 터미널 창이나 영문 에러 메시지를 마주하면 시작하기도 전에 피로감이 밀려오곤 합니다.

안녕하세요. 시니어 회사원의 시선에서 AI 실무 활용법을 나누는 블로그의 두 번째 글입니다.

지난 글에서는 오픈코드(OpenCode)가 왜 시니어 직장인에게 강력한 디지털 비서가 될 수 있는지 소개해 드렸습니다. 이번 글에서는 내 컴퓨터(Mac 또는 Windows)에 오픈코드를 설치하는 방법을 기초부터 차근차근 정리해 드립니다.

마우스 클릭으로 편하게 쓰는 데스크탑(Desktop) 버전과 가볍고 빠른 CLI(터미널) 버전을 모두 다루니, 본인에게 편한 방식을 선택해 따라와 보세요.

1. 시작하기 전에: 데스크탑 vs CLI, 무엇을 골라야 할까?

구분	데스크탑 앱 (Desktop)	CLI / TUI (터미널)
추천 대상	터미널 창이 낯설고 마우스 조작이 편한 분	빠른 속도와 가벼운 리소스를 선호하는 분
인터페이스	일반 윈도우/맥 프로그램 형태의 GUI 창	명령 프롬프트 / 터미널 창 기반 인터페이스
장점	설치가 직관적이고 시각적 메뉴가 편리함	키보드 중심의 빠른 조작, 서버 및 자동화 연계 용이

💡 시니어 팁: 터미널 명령어가 익숙하지 않으시다면 먼저 데스크탑 버전으로 시작해 보시는 것을 추천합니다. 두 버전 모두 동일한 핵심 엔진과 AI 기능을 공유합니다.

2. Mac(macOS) 사용자 설치 가이드

A. Mac 데스크탑 버전 설치 (추천)

설치 파일 다운로드
- 본인의 Mac CPU 종류(Apple Silicon M시리즈 vs Intel)에 맞춰 다운로드합니다.
  - Apple Silicon (M1/M2/M3/M4 등): Mac ARM64 DMG 다운로드
  - Intel Mac: Mac x64 DMG 다운로드 (내 Mac 종류 확인: 화면 좌측 상단 사과 마크  > ‘이 Mac에 관하여’ 클릭)
설치 진행
- 다운로드된 .dmg 파일을 더블 클릭하여 엽니다.
- 나타나는 창에서 OpenCode 아이콘을 Applications(응용 프로그램) 폴더로 드래그 앤 드롭합니다.
실행 및 보안 확인
- 응용 프로그램 폴더에서 OpenCode를 실행합니다.
- 혹시 “확인되지 않은 개발자가 배포했기 때문에 열 수 없습니다”라는 경고가 뜨면:
  - 시스템 설정 > 개인정보 보호 및 보안으로 이동하여 [확인 없이 열기]를 클릭해 주시면 정상 실행됩니다.

B. Mac CLI(터미널) 버전 설치

터미널 앱(Spotlight에서 ‘터미널’ 검색)을 열고 아래 방법 중 하나를 선택해 입력합니다.

방법 1. 자동 설치 스크립트 (가장 간단한 방법)

curl -fsSL https://opencode.ai/v2/install | bash

방법 2. Homebrew를 이용하는 방법 (개발 환경이 갖춰진 경우)

brew install anomalyco/tap/opencode-v2

방법 3. Node.js(npm)를 이용하는 방법

npm install -g @opencode/cli

설치가 완료되면 터미널에 아래 명령어를 입력하여 정상 작동하는지 확인합니다:

opencode --version

실행할 때는 작업하려는 디렉터리에서 opencode를 입력하고 Enter를 치면 멋진 TUI 환경이 열립니다.

3. Windows(윈도우) 사용자 설치 가이드

A. Windows 데스크탑 버전 설치 (추천)

설치 파일 다운로드
- 일반적인 윈도우 PC(Intel/AMD 64비트)를 사용 중이시라면 아래 링크를 클릭합니다:
  - Windows 64비트 (일반 PC): Windows x64 설치 파일(.exe) 다운로드
  - (ARM 기반 윈도우 서피스 등의 기종인 경우: Windows ARM64 .exe)
설치 실행
- 다운로드한 .exe 파일을 실행합니다.
- 혹시 파란색 “Windows의 PC 보호” (Microsoft Defender SmartScreen) 창이 뜬다면:
  - [추가 정보]를 클릭한 후 나타나는 [실행] 버튼을 누르면 정상적으로 설치가 진행됩니다.
설치가 완료되면 바탕화면 또는 시작 메뉴에서 OpenCode를 실행합니다.

B. Windows CLI(터미널) 버전 설치

윈도우 환경에서 명령줄 인터페이스(CLI)를 사용하려면 PowerShell 또는 명령 프롬프트(CMD)를 관리자 권한으로 실행합니다.

방법 1. Node.js(npm) 환경을 통한 설치

PC에 Node.js가 설치되어 있다면 아래 한 줄로 전역 설치가 가능합니다:

npm install -g @opencode/cli

방법 2. 독립 실행 압축파일(ZIP) 다운로드

Node.js 설치 없이 실행 바이너리를 직접 사용하고 싶다면:

Windows x64 ZIP 다운로드 링크에서 압축파일을 받습니다.
원하는 작업 폴더(예: C:\tools\opencode)에 압축을 풉니다.
해당 폴더 경로를 윈도우 시스템 환경 변수 (PATH)에 추가하거나, 해당 폴더 안에서 cmd를 열어 opencode.exe를 실행합니다.

4. 설치 후 첫 실행: AI 엔진 연결하기

오픈코드를 실행했다면 이제 AI 두뇌를 연결해 줄 차례입니다.

오픈코드는 여러 LLM 제공자(Anthropic Claude, OpenAI, Google Gemini 등)와 손쉽게 연동됩니다.

오픈코드 실행 창(또는 터미널 TUI)에서 명령 입력줄에 /connect를 입력합니다.
연동하고 싶은 AI 서비스(예: Anthropic, OpenAI, Google)를 선택합니다.
보유하고 계신 API 키를 입력하거나 브라우저 인증을 완료하면 끝납니다!

💡 보유한 API 키가 없으신가요?
오픈코드 콘솔(OpenCode Console)을 통해 월 구독형(예: OpenCode Go) 플랜을 활용하시거나, Google AI Studio에서 무료로 발급받을 수 있는 Gemini API 키로 가볍게 테스트해 보시는 것도 좋은 방법입니다.

5. 시니어 직장인을 위한 체크포인트 FAQ

Q1. 회사 업무 PC라 보안 프로그램 때문에 설치가 막혀요.

사내 보안 정책상 외부 .exe 실행이나 비인가 프로그램 설치가 차단된 경우가 있습니다. 이 경우 보안 담당 부서에 오픈소스 개발 도구 사용 승인을 요청하시거나, 개인 노트북/재택 PC에서 먼저 테스트해 보시는 것을 권장합니다.

Q2. 데스크탑 앱과 터미널 버전 중 어떤 것이 파일 접근에 더 유리한가요?

두 버전 모두 사용자가 지정한 프로젝트 작업 폴더 내의 파일을 읽고 쓰는 권한을 동일하게 가집니다. 사용하기 편한 화면을 고르시면 됩니다.

Q3. 프로그램을 종료하려면 어떻게 하나요?

데스크탑 앱: 일반 창 닫기(X 버튼) 또는 Ctrl + Q (Mac: Cmd + Q)
터미널(CLI): Ctrl + C를 두 번 누르거나 /exit 또는 /quit을 입력하면 안전하게 종료됩니다.

6. 마치며 & 다음 글 예고

축하합니다! 이제 여러분의 PC에 24시간 언제든 지시를 기다리는 유능한 AI 조수가 배치되었습니다.

설치라는 첫 번째 관문을 통과하셨으니, 다음 [시니어 직장인의 AI 탐구기 #03]에서는 “내 업무 폴더를 오픈코드와 연결하고, 엑셀 파일 수십 개를 10초 만에 분석 요약하는 실전 프롬프트 작성법”을 실습 위주로 소개해 드리겠습니다.

설치 과정에서 막히는 부분이 있다면 언제든 댓글로 남겨주세요!

작성일: 2026년 10월
태그: #오픈코드 #OpenCode설치 #Mac설치 #윈도우설치 #CLI설치 #데스크탑버전 #AI업무비서 #직장인생산성