문제 해결

OpenCode는 로그와 로컬 저장소에 진단 정보를 저장합니다.

로그

로그 파일 저장 위치:

• macOS/Linux: ~/.local/share/opencode/log/
• Windows: %USERPROFILE%\.local\share\opencode\log\

로그 파일은 타임스탬프로 이름이 지정됩니다 (예: 2025-01-09T123456.log). 최근 10개 파일이 유지됩니다.

상세도 증가:

opencode --log-level DEBUG

저장소

애플리케이션 데이터 위치:

• macOS/Linux: ~/.local/share/opencode/
• Windows: %USERPROFILE%\.local\share\opencode

도움 받기

1. GitHub Issues: github.com/anomalyco/opencode/issues
2. Discord 커뮤니티: opencode.ai/discord

일반적인 문제

OpenCode가 시작되지 않음

• 로그 파일에서 오류 메시지 확인
• --print-logs 플래그로 실행
• 최신 버전으로 업데이트: opencode upgrade

인증 문제

• /connect로 재인증
• API 키 유효성 확인
• 네트워크 접근 확인

모델 사용 불가

• 제공자 인증 확인
• 형식 확인: <providerId>/<modelId>
• opencode models 실행으로 모델 목록 확인

ProviderInitError

1. 제공자 문서 검토
2. 설정 초기화: rm -rf ~/.local/share/opencode
3. /connect로 재인증

제공자 패키지 문제

캐시 삭제:

rm -rf ~/.cache/opencode

복사/붙여넣기 작동 안함 (Linux)

클립보드 유틸리티 설치:

# X11
apt install -y xclip
 
# Wayland
apt install -y wl-clipboard