Window/Linux에서 Opencode설치 및 실행 방법

AI 코딩 도구는 이제 개발자의 일상적인 작업 도구가 되었다.
Claude Code, GitHub Copilot, Cursor와 같은 서비스는 코드 작성, 리뷰, 리팩토링까지 개발 전반에 깊게 관여하고 있다.

다만 이러한 도구들의 공통적인 한계도 분명하다. 대부분 유료 구독 기반이며, 소스 코드와 내부 동작 방식이 공개되어 있지 않고, 데이터 처리 방식 역시 사용자가 완전히 통제하기 어렵다!

 

이러한 배경 속에서 최근 개발자 커뮤니티에서는 다시 한 번 오픈소스 기반 AI 도구에 대한 관심이 높아지고 있다.
비용 문제를 넘어서,

 

1. 코드와 프롬프트 흐름을 직접 확인할 수 있고

2. 로컬 또는 사내 서버에서 실행할 수 있으며

3. 특정 벤더나 서비스 정책에 종속되지 않는 도구에 대한 수요가 커지고 있기 때문이다.

 

OpenCode는 이러한 흐름 속에서 주목받는 오픈소스 AI 코딩 에이전트이다.
완전히 공개된 코드 기반 위에서 동작하며, Claude, GPT, Gemini는 물론 로컬 LLM까지 폭넓게 지원한다는 점에서 상용 AI 코딩 도구의 대안이 될 수 있는 구조를 갖추고 있다

.

이 글에서는 OpenCode를 처음 접하는 사용자를 위해 설치 → 실행 → LLM 연결 → 기본 활용까지의 흐름을 정리하였다.
Windows와 서버(Linux) 환경을 모두 다루며,  바로 실행할 수 있는 명령 위주로 구성하였다.

 

• Windows 환경에서 OpenCode를 설치
• 설치 후 바로 사용할 수 있도록 LLM을 연결하는 방법,
• 서버(Linux) 환경에서의 설치 방법

 

---

윈도우에서 Opencode 설치하기

1️⃣ PowerShell을 관리자 권한으로 실행

이 단계가 필수이다.

• 시작 메뉴 → PowerShell 검색
• Windows PowerShell 우클릭 → 관리자 권한으로 실행

열린 창 상단에 Administrator: 표시가 있으면 정상임이다.

2️⃣ Chocolatey 설치 명령 실행

아래 전체를 그대로 복사해서 한 번에 붙여넣고 실행하면 됨이다.

3️⃣ PowerShell 완전히 닫고 다시 열기

환경변수(PATH) 반영을 위해 반드시 PowerShell 창을 닫았다가 다시 관리자 권한으로 실행해야 함이다.

4️⃣ Chocolatey 설치 확인

다시 실행한 PowerShell에서 아래 명령을 입력함이다.

 

 

5️⃣ OpenCode 설치

이제 정상적으로 OpenCode를 설치할 수 있다.

choco install opencode -y

설치 완료 후 다시 한 번 PowerShell을 닫고 열고 아래로 확인한다.

opencode --version

 

 

 

---

Opencode 시작하기

설치가 다 되었으면 PowerShell에 opencode라고 입력한다.

opencode

정상적으로 실행되면 위의 화면이 보인다

1️⃣ LLM 연결

현재는 모델이 연결되지 않은 상태이거나 기본 Zen 모델만 임시로 붙은 상태이다.
실사용을 위해서는 반드시 한 번은 연결해야 한다.

 

입력창에 그대로 입력하면 된다.

 

 

 

---

서버(Linux)에서 OpenCode 설치 방법 

아래 명령을  터미널에서  실행하면 된다.

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

 

 

설치 후 현재 쉘에 PATH 반영을 위해 아래 중 하나를 수행

source ~/.bashrc
# 또는
source ~/.profile

 

설치 확인:

opencode --version

 

이 상태에서 바로 실행하면 된다

opencode

 

 

OpenCode는 오픈소스이기 때문에 데이터가 어떻게 처리되는지 직접 확인할 수 있어서 보안에 민감한 환경에서도 안심하고 사용할 수 있다.

 

처음에는 기본 설정과 추천 모델(Zen 또는 기존 구독 연동)로 가볍게 사용해보고, 익숙해지면
프로젝트 초기화(/init), 세션 공유, 권한 설정, 워크플로우 자동화까지 점진적으로 활용 범위를 넓혀가는 것을 권장한다.