무료 AI 모델을 사용하기 위한 Windows에 OpenCode 데스크톱 앱과 CLI 설치하기

핵심 요약

OpenCode는 프로젝트의 코드를 살펴보고 개발 작업을 돕는 AI 코딩 도구입니다. Windows에서는 창으로 사용하는 데스크톱 앱과 터미널에서 명령으로 실행하는 CLI를 선택할 수 있습니다. 이 글에서는 두 설치 방법과 설치 후 첫 응답을 확인하는 과정을 설명합니다.

데스크톱 앱은 공식 페이지에서 Windows용 설치 파일을 내려받습니다. CLI는 Node.js와 함께 제공되는 npm으로 설치하는 방법을 기준으로 진행합니다. 공식 문서는 Windows에서 WSL 사용도 권장하므로, Linux 개발 환경이 필요한 경우를 위한 선택 경로도 함께 안내합니다. 공식 설치 문서, Windows 안내

데스크톱 앱과 CLI 선택하기

CLI는 명령줄 인터페이스의 약자입니다. opencode를 실행하면 터미널 안에 대화형 화면인 TUI가 열립니다. 데스크톱 앱은 별도의 창에서 작업하며, 앱이 열린다는 사실과 PowerShell에서 CLI 명령을 찾을 수 있다는 사실은 각각 확인해야 합니다. CLI 사용 안내

두 가지를 모두 사용할 계획이라면 데스크톱 앱과 CLI 절차를 차례로 진행합니다. 한 가지만 필요한 경우에는 해당 설치 절차와 완료 확인표를 확인하면 됩니다.

시작하기 전에

• Windows 설정 → 시스템 → 정보 → 시스템 종류에서 프로세서 종류를 확인합니다. 공식 데스크톱 다운로드에는 Windows x64가 표시됩니다. ARM PC에서는 x64 안내만으로 네이티브 지원을 판단하지 않습니다.
• CLI를 npm으로 설치하려면 Node.js와 npm이 필요합니다. 데스크톱 설치 파일을 실행하기 위한 선행 단계로 Node.js를 설치할 필요는 없습니다.
• 사용할 AI 제공자의 인증 방법과 이용 조건을 확인합니다. 프로그램 설치와 모델 사용 권한은 별개이며, 선택한 제공자와 모델에 따라 비용이 발생할 수 있습니다.
• 처음에는 중요한 원본 프로젝트 대신 연습용 폴더나 복사본으로 시작합니다. AI가 제안한 파일 변경과 명령은 내용을 확인한 뒤 적용합니다.

이 차이는 공식 다운로드 페이지와 공식 저장소에서 비교할 수 있습니다. 여기서는 두 패키지를 같은 제품 버전이나 호환 가능한 교체품으로 단정하지 않습니다.

검증 환경

아래의 버전 출력과 화면 확인은 학습자가 수행할 확인 항목입니다. 특정 PC에서 설치가 성공했다는 시험 기록은 아닙니다.

본문

1. Windows에 OpenCode 데스크톱 앱 설치하기

공식 설치 파일 내려받기

1. 브라우저에서 OpenCode 다운로드를 엽니다.
2. OpenCode Desktop 영역의 Windows (x64) 다운로드를 선택합니다.
3. 다운로드가 끝나면 파일 탐색기의 다운로드 폴더에서 설치 파일을 찾습니다.

공식 README의 Windows 설치 파일 이름은 opencode-desktop-windows-x64.exe입니다. 릴리스에 따라 파일명이 달라질 수 있으므로 이름을 검색해서 임의 사이트에서 받기보다 공식 다운로드 링크를 사용합니다. README에서는 데스크톱 앱을 베타로 소개합니다. 데스크톱 설치 안내

설치하고 앱 열기

다운로드한 설치 파일을 실행하고 설치 마법사에 표시되는 대상 폴더와 선택 항목을 확인합니다. 설치가 끝나면 시작 메뉴에서 OpenCode를 검색해 엽니다. 설치 화면의 버튼 이름과 선택 항목은 버전에 따라 달라질 수 있습니다.

Windows가 실행 경고를 표시하면 내려받은 주소와 파일 속성의 게시자·서명 정보를 먼저 확인합니다. 파일 출처를 확인할 수 없다면 실행을 중단하고 공식 링크에서 다시 내려받습니다.

앱이 열리면 프로젝트 또는 폴더를 여는 항목에서 연습용 폴더를 선택합니다. 제공자 연결이나 모델 선택 화면이 나타나면 사용할 제공자의 인증 절차를 따릅니다. 세부 메뉴 이름은 설치한 버전의 화면을 기준으로 확인합니다.

데스크톱 앱에서 모델 선택하기

모델은 입력한 질문을 해석하고 답변이나 코드를 만드는 AI입니다. 제공자는 그 모델을 사용할 수 있도록 서비스를 제공하는 곳입니다. 사용할 모델을 선택한 다음 짧은 질문으로 응답을 확인하면 됩니다.

입력창 왼쪽 아래의 현재 모델 이름과 아래쪽 화살표를 클릭합니다. 아래 화면에서는 빨간 테두리 안의 Exo Free가 해당 버튼이며, 마우스를 올리면 Choose model 안내가 표시됩니다. 옆의 Default가 아니라 모델 이름을 선택합니다.

Select model 창이 열리면 목록에서 사용할 모델을 클릭합니다. 아래 화면은 Muse Spark 1.3 항목을 강조한 예시입니다. 이 화면의 현재 선택 체크 표시는 아직 Exo 옆에 있으므로, 강조된 항목이 이미 선택된 것으로 해석하지 않습니다. Muse Spark 1.3을 사용하려면 해당 항목을 클릭한 뒤 입력창 아래 모델 이름이 바뀌었는지 확인합니다.

모델 정보에는 Provider(제공자), Inputs(지원 입력 종류), Reasoning(추론 관련 정보), Context(문맥 처리 한도) 같은 항목이 표시될 수 있습니다. 필요한 입력 종류를 지원하는지 확인하되, 문맥 한도 숫자가 크다는 이유만으로 답변이 더 정확하다고 판단하지 않습니다.

화면의 Free는 캡처 당시의 무료 표시입니다. 제공 모델과 이용 조건은 달라질 수 있으므로 실제 선택 화면의 안내를 확인합니다. 특정 모델이 목록에 없으면 같은 이름을 찾기 위해 설치를 반복하지 말고 현재 사용할 수 있는 모델을 선택합니다. 추가 모델이 필요하면 창 아래 Add more models from popular providers 영역에서 제공자를 선택하고 표시되는 인증 절차를 진행합니다.

선택 후 입력창의 모델 이름을 확인하고 본문 4번의 질문을 보냅니다. 모델 이름이 바뀌는 것과 실제 응답이 성공하는 것을 각각 확인합니다. 이 화면은 모델 선택 방법의 예시이며, 강조된 모델의 성능을 비교하거나 사용을 필수로 지정한 것은 아닙니다.

프로젝트와 모델을 선택한 뒤 본문 4번의 첫 질문으로 응답을 확인합니다. 여기까지 정상적으로 동작하면 데스크톱 앱의 기본 사용 준비를 확인한 것입니다. PowerShell 명령 사용이 필요하면 다음 CLI 설치를 진행합니다.

2. Windows에 OpenCode CLI 설치하기

Node.js와 npm 준비하기

Node.js 공식 다운로드에서 Windows용 LTS 설치 프로그램을 선택합니다. PC의 아키텍처에 맞는 파일로 설치하고 npm 구성 요소를 포함합니다. 설치가 끝나면 기존 터미널을 닫고 Windows Terminal 또는 PowerShell을 새로 엽니다.

다음 명령은 Windows PowerShell에서 실행합니다. 사용자 폴더로 이동한 다음 Node.js와 npm의 버전이 각각 출력되는지 확인합니다. cd가 실패하면 후속 명령을 실행하지 않습니다.

cd -LiteralPath $env:USERPROFILE -ErrorAction Stop
node --version
npm.cmd --version

두 명령 모두 버전을 표시해야 다음 단계로 진행합니다. npm.cmd는 PowerShell에서 npm의 Windows 명령 파일을 직접 선택하는 표기입니다. npm.ps1 실행 정책 오류가 발생하는 환경에서도 먼저 이 명령 파일을 사용할 수 있는지 확인할 수 있습니다. 1

OpenCode 패키지 설치하기

같은 Windows PowerShell에서 다음 명령을 실행합니다. -g는 현재 프로젝트의 의존성으로 추가하지 않고 npm의 전역 설치 위치에 설치한다는 뜻입니다.

cd -LiteralPath $env:USERPROFILE -ErrorAction Stop
npm.cmd install -g opencode-ai

이 패키지명은 공식 Intro의 Windows 설치 절에 제시되어 있습니다. 명령이 오류 없이 끝난 뒤 새 PowerShell 창에서 설치 상태를 확인합니다.

cd -LiteralPath $env:USERPROFILE -ErrorAction Stop
opencode --version
opencode --help

버전과 도움말이 표시되면 CLI 실행 파일을 찾을 수 있는 상태입니다. 아직 AI 제공자 인증이나 모델 응답까지 확인한 것은 아닙니다. 명령을 찾지 못하거나 스크립트 실행 오류가 나오면 본문 6번을 먼저 확인합니다.

처음 프로젝트에서 실행하기 전에도 opencode --version과 opencode --help를 먼저 실행해 설치된 CLI가 응답하는지 확인합니다. 버전 번호와 도움말 출력은 CLI 실행 확인일 뿐, 대화 화면이나 프로젝트 데이터베이스가 정상이라고 보장하지 않습니다. 멈춤이나 오류가 있으면 같은 명령을 반복 실행하거나 초기화하지 말고 아래 문제 해결 절차를 따릅니다.

3. 프로젝트에서 CLI 시작하고 제공자 연결하기

현재 폴더 아래에 프로젝트 폴더 만들기

처음 연습한다면 현재 폴더 아래에 project1이라는 폴더를 만들고 그 폴더 안으로 이동합니다. project1은 예시 이름이므로 원하는 프로젝트 이름으로 바꿀 수 있습니다. 이름을 바꾸면 폴더 생성·이동·실행 명령에서도 같은 이름을 사용합니다.

아래 명령은 Windows PowerShell 또는 VS Code의 로컬 PowerShell 터미널에서 실행합니다. 먼저 터미널의 현재 위치가 project1을 만들려는 부모 폴더인지 확인합니다. 화면 예시처럼 사용자 폴더에서 시작해도 되고, 원하는 작업 폴더로 먼저 이동해도 됩니다. mkdir은 하위 폴더를 만들고 cd는 그 안으로 이동합니다.

mkdir project1
cd project1

아래 화면에서는 C:\Users\shopb 아래에 project1을 만들고 이동했습니다. 마지막 프롬프트가 PS C:\Users\shopb\project1>로 바뀐 것으로 현재 위치를 확인할 수 있습니다. 자신의 PC에서는 사용자 이름과 부모 경로가 다를 수 있습니다.

명령이 실패하면 다음 줄을 실행하지 말고 경로와 오류를 확인합니다. project1이 이미 있다면 새로 만들거나 삭제하지 말고 기존 내용을 확인한 뒤 이동합니다. 기존 프로젝트로 작업할 경우에는 폴더 생성 단계를 건너뛰고 파일 탐색기 주소 표시줄에서 그 프로젝트의 전체 경로를 복사합니다.

프로젝트 폴더에서 OpenCode 실행하기

현재 터미널 위치가 project1 안인지 확인한 뒤 OpenCode를 실행합니다. 터미널을 새로 열었거나 기존 프로젝트를 사용한다면 cd 경로를 해당 프로젝트 폴더에 맞춥니다. 폴더 이동에 실패하면 OpenCode를 실행하지 않습니다.

pwd
opencode

대화형 화면이 열리면 다음 명령을 OpenCode 입력창에 입력합니다. PowerShell에 입력하는 명령과 구분합니다.

/connect

목록에서 사용할 제공자를 고르고 화면에 표시되는 로그인 또는 API 키 입력 절차를 진행합니다. 인증정보는 제공자가 안내하는 입력란에 넣고 프로젝트 파일이나 공유할 대화에 적지 않습니다. 연결 후 사용할 모델을 선택합니다. 제공자 연결 시작 안내

터미널 명령으로 인증을 진행하려면 OpenCode를 종료한 뒤 opencode auth login을 사용할 수도 있습니다. 연결 목록 확인 명령은 opencode auth list이며, 목록에 표시된다는 사실만으로 실제 모델 호출이 성공했다고 판단하지 않습니다. CLI 인증 명령

CLI에서 모델 선택하기

제공자 연결 후 OpenCode 대화형 입력창에서 다음 명령을 입력하고 사용할 모델을 선택합니다. 위의 데스크톱 화면과 CLI의 목록 모양은 다를 수 있습니다. 공식 모델 선택 안내

/models

명령을 입력하면 /models가 선택된 명령 메뉴가 나타납니다. Enter를 눌러 모델 목록을 엽니다.

목록에서 사용할 수 있는 모델을 선택합니다. 아래 예시에서는 Muse Spark 1.3 Free가 선택된 상태로 강조되어 있습니다. 목록과 무료 표시는 제공자 연결, 계정 권한, 버전에 따라 달라질 수 있습니다. 화면에 Free라고 표시되어도 이용 한도나 조건이 계속 동일하다고 단정하지 말고 현재 제공자의 안내를 확인합니다.

모델을 고른 뒤 variant 선택 화면이 열리면 Default를 그대로 사용하거나 목록의 다른 설정을 선택할 수 있습니다. Variant는 같은 모델에서 사용할 추론 설정의 선택지입니다. 아래 화면에는 minimal, low, medium, high, xhigh가 보이지만, 제공 항목은 모델과 제공자에 따라 다릅니다. 의미가 불분명하면 Default를 유지합니다. 모델 variant 안내

선택이 끝나면 입력창 아래 현재 모델 이름을 확인합니다. 다음 화면은 Muse Spark 1.3 Free가 현재 모델로 표시된 예시입니다. 이 확인은 선택값이 반영되었음을 보여 주며, 모델 응답이나 작업 품질을 검증한 것은 아닙니다.

선택한 모델이 화면에 표시되는지 확인한 뒤 다음 절의 첫 질문을 보냅니다. 목록에 모델이 나타나지 않으면 제공자 연결 상태와 해당 계정의 모델 접근 권한을 확인합니다.

4. 첫 질문으로 동작 확인하기

데스크톱 앱 또는 CLI 입력창에서 다음처럼 요청합니다.

현재 열린 프로젝트의 최상위 폴더와 주요 파일의 역할을 간단히 설명해 줘.
파일을 수정하거나 설치 명령을 실행하지 말고, 읽을 수 없는 항목은 따로 알려 줘.

요청을 보낸 뒤에는 프로젝트 트리와 주요 파일에 관한 응답을 확인합니다. 다음 화면처럼 읽을 수 없는 파일이나 내용을 구분해 말하는지 살펴보고, admin-*.js처럼 파일명만으로 역할을 추정한 설명은 확정된 사실로 받아들이지 않습니다. 실제 파일을 열어 확인하거나 추가로 질문합니다.

응답에서 실제 프로젝트 이름과 파일 구성이 맞는지 확인합니다. 로그인 오류, 사용량 제한, 결제 또는 모델 접근 오류가 나오면 오류 문구에 맞춰 제공자 설정을 확인합니다. 단순히 대화 화면이 열리는 것과 모델이 응답하는 것은 서로 다른 확인 단계입니다.

방금 만든 project1이 비어 있다면 파일이 없다는 응답이 나올 수 있습니다. 빈 폴더라는 실제 상태를 정확히 설명하는지 확인하고, 아직 만들지 않은 파일을 설명하는 응답과 구분합니다.

CLI에서 프로젝트 규칙 파일을 만들고 싶다면 첫 응답 확인 후 /init을 사용할 수 있습니다. 이 명령은 프로젝트를 분석해 AGENTS.md를 생성하는 절차이므로 설치 확인에 필수는 아닙니다. 기존 규칙 파일이 있다면 내용을 먼저 보존하고 실행 후 변경점을 확인합니다. 프로젝트 초기화 안내

5. 선택 사항으로 WSL에 CLI 설치하기

WSL은 Windows 안에서 Linux 환경을 사용하는 기능입니다. OpenCode 공식 문서는 Windows에서의 개발 도구 호환성과 터미널 사용을 위해 WSL을 권장합니다. Windows 네이티브 CLI를 먼저 설치해야 하는 것은 아닙니다. WSL이 없다면 Microsoft의 WSL 설치 안내를 먼저 따라 Linux 배포판과 사용자 계정을 준비합니다.

아래 명령은 PowerShell이 아닌 WSL의 Ubuntu 등 Linux 터미널에서 실행합니다. 공식 설치 스크립트를 내려받아 Bash로 실행하므로 실행 전에 주소를 확인합니다.

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

설치가 끝나면 WSL 터미널을 새로 열고 확인합니다.

cd ~ && opencode --version

프로젝트가 WSL의 ~/code/my-app에 있다면 다음과 같이 시작합니다. 실제 프로젝트 경로로 바꾸고 폴더 이동이 성공한 경우에만 실행되도록 &&를 유지합니다.

cd ~/code/my-app && opencode

Windows의 C:\Projects\my-app은 일반적인 WSL 마운트에서 /mnt/c/Projects/my-app으로 접근합니다. 공식 문서는 원활한 작업을 위해 프로젝트를 WSL 파일 시스템에 두는 방식도 제안합니다. Windows와 WSL은 설치 경로와 설정 저장 위치가 다르므로, 한쪽의 설치·인증 상태를 다른 쪽에 그대로 적용하지 않습니다. WSL 설치와 파일 접근 안내

6. 설치 중 자주 만나는 문제 해결하기

npm 또는 OpenCode 명령을 찾지 못할 때

설치 직후라면 터미널을 완전히 닫고 다시 엽니다. Windows PowerShell에서 현재 설치 위치를 확인합니다.

cd -LiteralPath $env:USERPROFILE -ErrorAction Stop
Get-Command node,npm.cmd,opencode -All -ErrorAction SilentlyContinue
npm.cmd prefix -g
npm.cmd list -g --depth=0

목록에 opencode-ai가 있는지 확인합니다. Windows에서 npm 전역 실행 파일은 전역 prefix 폴더에 연결되며, 그 폴더가 PATH에 포함되어야 명령 이름으로 실행할 수 있습니다. npm.cmd prefix -g가 출력한 실제 폴더를 Windows의 사용자 환경 변수 Path에서 확인합니다. 변경할 때는 기존 값을 지우지 않고 필요한 항목만 추가한 뒤 터미널을 다시 엽니다. npm 폴더 구조

PowerShell이 ps1 파일 실행을 막을 때

오류에 npm.ps1 또는 opencode.ps1과 실행 정책이 언급되면 Windows 명령 파일을 직접 지정해 확인합니다.

cd -LiteralPath $env:USERPROFILE -ErrorAction Stop
npm.cmd --version
opencode.cmd --version

위 명령이 동작하면 프로젝트 폴더에서도 opencode 대신 opencode.cmd로 실행할 수 있습니다. .cmd 파일도 찾을 수 없다면 실행 정책보다는 설치 상태와 PATH를 먼저 점검합니다. 이 절차를 위해 시스템 전체 실행 정책을 변경하지 않습니다.

실행 후 터미널이 검게 바뀌고 멈춘 것처럼 보일 때

OpenCode CLI는 기본 실행 시 터미널 안에서 대화형 화면(TUI)을 엽니다. 화면이 전환되는 동안 잠깐 검게 보일 수 있지만, 글자가 나타나지 않은 채 계속 입력에 반응하지 않는 상태는 정상 실행으로 판단하지 않습니다. 검은 화면만으로 터미널 표시 문제, 데이터베이스 문제, 서비스 문제 중 원인을 확정할 수 없습니다. CLI 안내

먼저 Ctrl+C를 눌러 현재 실행을 끝냅니다. 반응이 없으면 새 PowerShell 창을 열고 설치된 실행 파일과 버전을 확인합니다.

Get-Command opencode -All | Select-Object CommandType, Source
opencode --version
opencode --help

같은 opencode 명령이라도 설치 버전에 따라 제공하는 하위 명령이 다릅니다. 예를 들어 사용자 환경의 1.18.35에서 opencode service status는 서비스 상태를 보여 주지 않고 일반 도움말을 출력했습니다. 이 버전에서 service 명령이 지원된다는 뜻이 아닙니다. service status 또는 service restart를 안내받더라도 먼저 opencode --help에 해당 명령이 실제로 있는지 확인합니다. 지원되지 않는 명령의 도움말 출력만으로 백그라운드 서비스 상태를 진단할 수 없습니다.

터미널 표시 문제인지 확인할 때는 Windows Terminal의 새 PowerShell 탭에서 같은 프로젝트를 실행해 볼 수 있습니다. 검은 화면이 다시 나타나면 Ctrl+C로 종료한 뒤 로그를 출력해 재현합니다.

cd -LiteralPath "$env:USERPROFILE\project1"
opencode --print-logs --log-level DEBUG

사용자 폴더 아래 project1을 만든 예시입니다. 다른 위치나 기존 프로젝트를 사용한다면 cd 경로를 실제 프로젝트 경로로 바꿉니다. 로그에 인증 키나 토큰이 보이면 공유 전에 값을 가립니다. 최신 CLI의 공식 문제 해결 문서는 로그를 먼저 확인하고 --print-logs로 터미널에 표시하도록 안내합니다. OpenCode 문제 해결

Database is not empty and has no session table 오류가 나타날 때

위 데이터베이스 오류가 출력되면 TUI 색상이나 화면 표시만의 문제로 다루지 않습니다. OpenCode가 현재 사용하는 저장소에서 예상한 세션 테이블을 찾지 못했다는 오류입니다. 버전 변경, 서로 다른 설치본의 데이터 공유, 이전 실행 중단 등은 가능한 조사 방향일 수 있지만, 오류 한 줄만으로 원인을 단정할 수 없습니다.

이 경우 반복해서 opencode --mini, opencode web 또는 재시작 명령을 실행하지 않습니다. 같은 저장소에 접근하면 같은 오류가 날 수 있고, 추가 실행이 진단을 복잡하게 만들 수 있습니다. 사용자 데이터와 인증 정보가 있을 수 있으므로 OpenCode 데이터 폴더나 데이터베이스 파일을 삭제·초기화·덮어쓰지 않습니다.

PowerShell에서 다음 읽기 전용 정보를 모읍니다.

Get-Command opencode -All | Select-Object CommandType, Source
Get-ChildItem Env:OPENCODE* | Select-Object Name
opencode debug --help

Get-Command는 중복 설치 여부와 실행 경로를 확인합니다. 환경 변수 명령은 변수 이름만 출력하므로 민감한 값 전체를 노출하지 않습니다. 필요할 때는 각 변수의 값도 로컬에서 확인하되 공유 전 API 키·토큰·암호를 가립니다. opencode debug --help는 현재 버전이 제공하는 진단 명령을 확인하는 용도이며, 도움말에 없는 명령을 추측해 실행하지 않습니다.

오류가 반복되면 최근 OpenCode 로그와 저장소 경로를 확인하고, 진단 자료에는 설치 버전·실행 파일 경로·오류 전문·마지막 실행 시각을 함께 기록합니다. 공식 문제 해결 문서는 Windows 로그를 %USERPROFILE%\.local\share\opencode\log에서 확인하도록 안내합니다. 실제 데이터 파일이나 로그를 옮기거나 수정하기 전에 백업·복구 방법을 정하고 원인을 확인합니다. 로그와 저장 위치

사용자 환경에서 opencode --mini도 Database is not empty and has no session table로 끝났습니다. 따라서 이 옵션을 모든 검은 화면의 사전 해결책으로 사용하지 않습니다. 오류가 발생한 상태에서는 위의 버전·경로·환경 변수 이름·진단 도움말 결과를 기준으로 설치본과 저장소를 구분해 다음 조치를 정합니다.

CLI는 실행되지만 AI가 응답하지 않을 때

오류 메시지에서 인증 실패인지, 선택 모델의 접근 권한 문제인지, 네트워크 오류인지 구분합니다. 제공자 연결을 다시 확인하고, 동일한 오류가 계속되면 발생 시각·버전·제공자·오류 문구를 기록합니다. 기록을 공유할 때 API 키와 토큰을 제거합니다. 추가 진단은 공식 문제 해결 문서를 따릅니다.

이전 버전이 실행되거나 업데이트가 필요할 때

여러 설치 방법을 섞었다면 Get-Command opencode -All로 후보 경로를 확인합니다. npm으로 설치한 이 글의 패키지를 업데이트할 때는 다음을 실행합니다.

cd -LiteralPath $env:USERPROFILE -ErrorAction Stop
npm.cmd install -g opencode-ai@latest

설치 성공 후 터미널을 다시 열고 버전을 확인합니다. Scoop·Chocolatey 등으로 설치한 사본에 npm 설치를 덧붙여 해결하려 하지 말고, 실제 사용 중인 설치 방법을 먼저 확인합니다.

주의 사항과 한계

다운로드 화면과 CLI 패키지 안내가 달라지는 시기에는 설치한 패키지명과 버전을 함께 기록해야 문제를 재현하기 쉽습니다. 이 글의 명령을 다른 패키지 계열의 명령과 섞지 않습니다.

데스크톱 앱의 세부 화면, ARM PC에서의 실행, 조직의 보안 정책이 적용된 PC에서의 설치 결과는 별도 확인이 필요합니다. Windows 네이티브 설치의 문제가 지속되면 공식 Windows 안내의 WSL 경로를 검토합니다.

다음 단계

첫 응답을 확인했다면 작은 프로젝트에서 설명 요청부터 시작하고, 실제 파일 변경을 맡기기 전에 Git 커밋이나 복사본으로 복구 지점을 마련합니다.

이전글: 추후 연결

다음글: 추후 연결

참고 자료 및 출처

• OpenCode 다운로드 — Windows 데스크톱 다운로드와 페이지에 표시된 CLI 설치 명령
• OpenCode 공식 저장소 — npm 패키지와 Windows 데스크톱 설치 파일
• OpenCode 시작 안내 — Windows 설치, 제공자 연결과 프로젝트 초기화
• OpenCode CLI — 대화형 실행과 인증 명령
• OpenCode 모델 안내 — CLI의 모델 선택과 제공자·모델 구분
• OpenCode Windows와 WSL — WSL 설치와 파일 경로 구분
• OpenCode 문제 해결 — 오류 진단
• Node.js 다운로드 — Windows용 Node.js 설치 프로그램
• npm 폴더 구조 — Windows 전역 설치와 실행 파일 위치