VS Code에서 OpenCode 사용하는 방법: 설치·작업·오류 해결 7가지

확장은 OpenCode CLI를 대체하지 않습니다. 통합 터미널에서 opencode --version을 실행하고 찾을 수 없다면 PATH부터 고칩니다. 실제 저장소를 열어 Git 상태와 제외 파일을 확인하고, 일반 세션에서 Provider와 모델을 시험하세요. 인증, 네트워크, IDE 문제를 분리해야 불필요한 재설치를 피할 수 있습니다.

저장소를 열고 새 통합 터미널에서 opencode를 실행합니다. 공식 IDE 문서에 따르면 확장이 자동 설치됩니다. 이후 Ctrl+Esc 또는 Cmd+Esc를 시험합니다. Marketplace 수동 설치는 CLI나 Provider 정상 여부를 증명하지 않습니다. 새 세션은 Ctrl+Shift+Esc 또는 Cmd+Shift+Esc로 열고, 두 세션이 같은 파일을 동시에 수정하지 않게 하세요.

문제를 설명하는 가장 작은 코드 블록만 선택합니다. Windows/Linux의 Alt+Ctrl+K, macOS의 Cmd+Option+K로 @File#L37-42 같은 참조를 삽입할 수 있습니다. 큰 수정 뒤에는 줄 번호를 다시 확인하세요. 컨텍스트는 이해를 돕지만 파일 및 명령 권한을 무시하지 않습니다.

git status로 시작하고 결과와 변경 금지 파일을 명확히 합니다. 터미널을 보면서 작업 경로와 명령을 확인하고, 수정 뒤에는 Source Control diff와 가장 작은 관련 테스트를 실행합니다. 이전 지시가 섞이면 새 세션을 열고 작업 경계를 다시 설명하세요. 변경 파일마다 한 명의 소유자를 두는 것이 안전합니다.

터미널이 로컬, WSL, SSH, 컨테이너 중 어디를 가리키는지 확인합니다. 비밀 키, 고객 데이터, 운영 설정을 선택하지 마세요. CLI와 확장은 개발 환경에서 실행되지만 모델 요청은 Provider로 전송될 수 있습니다. 배포, 데이터베이스, 결제, 인증 작업에는 사람의 명시적 승인을 유지합니다.

자동 설치가 실패하면 통합 터미널에서 opencode를 실행하고 PATH 변경 후 VS Code를 재시작합니다. code --version도 확인하세요. Cursor, Windsurf, VSCodium은 각각 cursor, windsurf, codium을 사용합니다. 단축키만 작동하지 않으면 키 충돌을 찾고, 세션은 열리지만 모델이 실패하면 Provider, 프록시, 사용 제한을 점검합니다.

opencode, code, Provider가 정상인데 IDE 명령만 없을 때 재설치합니다. 확장을 제거하고 모든 창을 닫은 뒤 저장소를 다시 열어 새 통합 터미널에서 opencode를 실행하세요. 터미널이 있는 다른 IDE에서도 CLI는 쓸 수 있습니다. EDITOR="code --wait"는 /editor와 /export용이며 확장을 대신하지 않습니다.