[OpenCode 실전기 2편] 10분 설치 가이드: 설치, 초기 설정, 첫 실행

왜 OpenCode가 필요할까?

웹에서 AI를 쓰면 코드를 복사하고 붙여넣는 일이 자주 생깁니다. 이 과정이 반복되면 공부 흐름이 끊기기 쉽습니다. OpenCode는 터미널(=명령어를 입력하는 창) 안에서 바로 AI와 대화하게 해 주는 도구라서, 파일 확인, 코드 질문, 수정 요청을 한 흐름으로 이어갈 수 있습니다.

처음 설치하는 학생도 크게 막히지 않도록, 설치부터 첫 실행까지를 짧고 실제적으로 정리해 보겠습니다.

준비물 목록

• 맥북과 인터넷 연결
• 터미널 앱 하나 (Terminal, iTerm2, Warp 중 아무거나)
• Homebrew 설치 완료
• 유료 모델을 쓸 계획이면 API 키 또는 로그인 계정 준비

⚠️ Homebrew가 아직 없다면 먼저 brew.sh에서 설치하고 오세요.

Step 1: Homebrew가 있는지 확인하기

처음에는 Homebrew로 설치하는 편이 가장 간단합니다.

버전 번호가 보이면 준비 완료입니다.

💡 버전 숫자가 다르게 나와도 괜찮습니다. 중요한 건 brew --version이 정상 동작하는지예요.

Step 2: OpenCode 설치하기

이제 Homebrew로 OpenCode를 설치합니다.

💡 나중에 업데이트할 때는 brew upgrade opencode를 사용하면 됩니다.

⚠️ 학교 공용 Mac이나 학원 컴퓨터에서는 설치 권한이 막혀 있을 수 있습니다. 그럴 때는 개인 기기에서 먼저 연습하는 편이 편합니다.

다른 설치 방법도 있지만, 처음에는 Homebrew 방식부터 따라가는 편이 가장 덜 헷갈립니다.

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

Step 3: 설치가 끝났는지 확인하기

설치가 끝났다면 먼저 버전부터 확인해 보세요. 가장 빠르게 성공 여부를 확인할 수 있습니다.

만약 아래처럼 command not found가 나오면 경로 설정이 아직 반영되지 않은 경우가 많습니다.

source ~/.zshrc는 터미널 설정을 다시 불러오는 명령입니다.

Step 4: 처음 실행해 보기

이제 프로젝트 폴더에서 OpenCode를 실행해 봅니다.

처음 실행하면 provider를 고르게 됩니다. 여기서 provider는 AI 서비스를 제공하는 회사라고 생각하면 됩니다.

💡 처음에는 하나만 연결해도 됩니다. 익숙해진 다음에 메인용과 백업용을 나누면 됩니다.

Step 5: 가장 먼저 해 둘 설정

설치 직후에는 아래 4가지만 해도 충분합니다.

• 자주 쓸 provider 1개 연결하기
• 문제가 생길 때 쓸 백업 provider 1개 생각해 두기
• 간단한 질문으로 응답이 오는지 확인하기
• 어디서 막혔는지 메모하기

너무 완벽하게 세팅하려고 하면 오히려 시작이 늦어집니다. 처음 30분은 "잘 되는지 확인"에 집중하세요.

설치 완료 확인

정말로 잘 되는지 마지막으로 간단한 질문을 넣어 보면 됩니다.

이 정도 응답이 오면 설치와 첫 실행은 성공입니다.

자주 하는 실수

⚠️ API 키는 비밀번호처럼 다뤄야 합니다. 친구에게 보내거나 GitHub에 올리면 안 됩니다.

오늘 여기서 해 볼 것

• opencode --version 다시 한 번 확인하기
• 내 프로젝트 폴더에서 opencode 실행하기
• 이 코드 설명해줘 한 번 물어보기

이제 설치는 끝났고, 다음 단계는 어떤 provider를 어떻게 조합하면 오래 안정적으로 쓸 수 있는지를 배우는 것입니다.

출처

• OpenCode 공식 문서: https://opencode.ai/docs/