메모

[메모] opencode 우분투에 설치 및 사용 방법

KING

10 2월 2026 — 10 min read

📝 Memos에서 자동 발행됨
🕐 작성일: 2026-02-10
✨ AI가 보충 설명을 추가했습니다 🔍 웹 조사 자료를 바탕으로 작성되었습니다

opencode 우분투에 설치 및 사용 방법

개요

최근 개발자들 사이에서 AI 코딩 보조 도구의 활용이 필수가 되어가고 있습니다. 이러한 흐름 속에서 OpenCode는 터미널 환경에서 다양한 대규모 언어 모델(LLM)을 활용하여 개발 생산성을 혁신적으로 향상시킬 수 있는 오픈 소스 AI 코딩 에이전트입니다. 코드 작성, 디버깅, 문서화 등 개발 과정 전반에 걸쳐 강력한 지원을 제공하며, 특히 Ubuntu 사용자를 위한 간편한 설치와 활용법은 많은 개발자들에게 매력적인 선택지가 됩니다.

OpenCode는 OpenAI의 GPT, Anthropic의 Claude, Google의 Gemini 등 여러 AI 모델을 유연하게 연결하여 사용할 수 있는 확장성을 자랑합니다. 단순히 코드를 생성하는 것을 넘어, 사용자의 질문에 답하고, 코드 스니펫을 설명하며, 심지어 특정 작업을 수행하는 에이전트 역할을 수행하기도 합니다. 이 포스트에서는 Ubuntu 환경에서 OpenCode를 설치하고, 기본 사용법부터 더 강력한 기능을 제공하는 oh-my-opencode 설치 및 활용법까지 상세하게 다루어 보겠습니다.

지금부터 OpenCode를 설치하고 설정하여, 여러분의 터미널을 강력한 AI 코딩 파트너로 변모시키는 방법을 알아보겠습니다. 간편한 설치 스크립트 하나면 바로 시작할 수 있으며, 몇 가지 설정만으로 여러분의 개발 워크플로우를 한 차원 더 업그레이드할 수 있을 것입니다.

상세 가이드

1. OpenCode 설치 방법

OpenCode는 여러 가지 방법으로 Ubuntu에 설치할 수 있습니다. 가장 간단하고 권장되는 방법부터 알아보겠습니다.

1.1. 가장 간편한 방법: 자동 설치 스크립트 (권장)

이 방법은 OS를 자동으로 감지하고, 최적의 실행 파일을 다운로드하며, 환경 변수 설정까지 한 번에 처리해줍니다. 터미널에 다음 명령어를 입력하세요:

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

1.2. npm을 이용한 설치

Node.js가 시스템에 설치되어 있다면, npm을 사용하여 전역으로 설치할 수 있습니다.

npm install -g opencode-ai

1.3. Bun을 이용한 설치 (더 빠른 설치)

Bun이 설치되어 있다면, npm보다 빠르게 OpenCode를 설치할 수 있습니다.

bun add -g opencode-ai

1.4. 설치 확인

어떤 방법으로 설치했든, 다음 명령어로 OpenCode가 정상적으로 설치되었는지 확인할 수 있습니다.

opencode --version

만약 OpenCode vX.X.X와 같은 버전 정보가 출력되면 성공적으로 설치된 것입니다.

2. OpenCode 기본 사용 방법

설치가 완료되면 OpenCode를 실행하고 AI 모델을 연결하여 사용할 수 있습니다.

2.1. OpenCode 실행

터미널에서 다음 명령어를 입력하여 OpenCode를 실행합니다.

opencode

2.2. 모델(API) 연결

OpenCode가 실행되면, /connect 명령어를 입력하여 AI 모델을 연결할 수 있습니다.

/connect

ENTER를 누르면 키보드 화살표 키를 사용하여 다음과 같은 AI 모델 중 하나를 선택할 수 있습니다.

Anthropic (Claude)
OpenAI (GPT, Codex)
Google (Gemini)

선택한 후에는 각 서비스에서 발급받은 API 키를 입력하라는 프롬프트가 나타납니다. 유효한 API 키를 입력하면 해당 AI 모델과 OpenCode가 연결되어 사용할 준비가 됩니다.

3. Oh-my-opencode 설치 (선택 사항: 고급 기능)

oh-my-opencode는 OpenCode의 기능을 더욱 강력하게 만들어주는 플러그인으로, 여러 AI 에이전트를 통합 관리하고 더 복잡한 작업을 수행할 수 있도록 돕습니다.

3.1. 사전 요구사항: Bun 설치

oh-my-opencode를 설치하려면 먼저 Bun이 시스템에 설치되어 있어야 합니다. Bun이 없다면 다음 명령어를 통해 설치하세요.

curl -fsSL https://bun.com/install | bash

설치 후에는 터미널을 다시 시작하거나, 다음 명령어를 실행하여 환경 변수를 적용합니다.

source ~/.bashrc

Bun이 제대로 설치되었는지 확인합니다.

bun --version

3.2. oh-my-opencode 설치

Bun 설치가 완료되었다면, 다음 명령어를 사용하여 oh-my-opencode를 설치합니다.

bunx oh-my-opencode install

npm을 사용하는 Ubuntu/Debian Snap 환경에서는 다음 명령어를 사용할 수 있습니다.

npx oh-my-opencode install

설치 과정 중에 Claude, OpenAI, Gemini 등 보유하고 있는 구독 서비스에 대한 질문이 나타납니다. 보유한 서비스를 선택하면 opencode.json 파일이 자동으로 구성되어 설정 과정을 간소화할 수 있습니다.

실제 사용 예시

OpenCode는 터미널 환경에서 다양한 개발 작업을 AI의 도움을 받아 처리할 수 있습니다.

코드 생성 및 개선:
- "Python으로 웹 스크래핑 코드를 작성해줘."
- "이 JavaScript 함수를 더 효율적으로 리팩토링해줘."
- "다음 파이썬 코드에 대한 주석을 달아줘."
디버깅 및 오류 해결:
- "이 오류 메시지의 의미가 뭐야? 해결 방법은?"
- "다음 코드를 분석해서 발생할 수 있는 잠재적인 버그를 찾아줘."
문서화 및 설명:
- "이 API 엔드포인트에 대한 사용 예시와 설명을 생성해줘."
- "특정 알고리즘의 동작 방식을 쉽게 설명해줘."
oh-my-opencode를 활용한 고급 작업: oh-my-opencode를 통해 특정 도구나 서브 에이전트를 지정하여 더욱 전문적인 작업을 요청할 수 있습니다. 예를 들어, 웹 개발 에이전트를 통해 특정 UI 컴포넌트 코드를 생성하거나, 데이터 분석 에이전트를 통해 데이터 전처리 스크립트를 요청하는 등의 작업이 가능합니다. opencode.json 설정에 따라 다양한 전문가 에이전트를 활용할 수 있습니다.

OpenCode 실행 후 /connect 명령어로 AI 모델을 연결한 다음, 마치 채팅하듯이 터미널에 질문이나 요청을 입력하면 AI가 답변을 제공합니다.

opencode
/connect
(모델 선택 후 API 키 입력)
나: JavaScript로 배열에서 중복을 제거하는 가장 효율적인 방법을 알려줘.
(AI가 코드와 설명을 제공)

💡 유용한 팁

자동 설치 스크립트 활용: curl -fsSL https://opencode.ai/install | bash 명령은 OpenCode 설치의 가장 빠르고 확실한 방법입니다. OS 감지부터 환경 변수 설정까지 자동으로 처리해주므로, 복잡한 설정 없이 바로 시작할 수 있습니다.
Bun을 통한 설치 및 관리: Bun은 npm에 비해 더 빠르고 효율적인 패키지 매니저입니다. Bun이 설치되어 있다면 bun add -g opencode-ai 명령어를 통해 OpenCode를 빠르게 설치하고 관리할 수 있으며, oh-my-opencode도 Bun을 기반으로 합니다.
oh-my-opencode로 생산성 극대화: oh-my-opencode는 OpenCode를 위한 '올인원' 플러그인으로, 마치 Oh My Zsh가 Zsh 쉘의 생산성을 높이듯이 OpenCode의 기능을 확장합니다. 여러 AI 에이전트 통합, 자동 설정 등 고급 기능을 통해 작업 효율을 극대화할 수 있습니다.
API 키 보안 관리: OpenCode에 연결하는 Anthropic, OpenAI, Google 등의 API 키는 매우 중요한 개인 정보입니다. 안전하게 보관하고, 절대 외부에 노출되지 않도록 주의해야 합니다. /connect 명령어를 통해 안전하게 입력하세요.
opencode.json 활용: oh-my-opencode 설치 시 구독 중인 AI 서비스 선택을 통해 opencode.json 파일이 자동으로 구성됩니다. 이 설정 파일은 OpenCode의 동작 방식을 세밀하게 제어할 수 있으므로, 필요에 따라 직접 수정하여 자신만의 워크플로우를 구축할 수 있습니다.

⚠️ 주의사항

API 키 유출 주의: OpenCode는 AI 서비스와의 연동을 위해 API 키를 사용합니다. 이 키가 유출될 경우 불필요한 과금이 발생하거나 악용될 수 있으므로, 키 관리에 각별히 유의해야 합니다.
비용 발생 가능성: OpenCode 자체는 오픈 소스이지만, 연결하는 Claude, OpenAI, Gemini와 같은 상용 AI 모델은 사용량에 따라 요금이 부과될 수 있습니다. 특히 oh-my-opencode와 같이 여러 에이전트를 활용할 경우 토큰 소모량이 늘어날 수 있으므로, 사용량을 주기적으로 확인하는 것이 좋습니다.
Bun 환경 변수 설정: oh-my-opencode를 사용하기 위해 Bun을 설치했다면, source ~/.bashrc 명령을 실행하거나 터미널을 재시작하여 Bun의 환경 변수(PATH)가 제대로 설정되었는지 확인해야 합니다. 그렇지 않으면 bunx 명령어를 찾지 못해 설치에 실패할 수 있습니다.