본문으로 건너뛰기

시코딩 몰라도 PowerShell 오류 두 번 뚫고 미리보기 띄운 날

오토골프vaa

2026.07.23

소개

시코딩 몰라도 PowerShell 오류 두 번 뚫고 미리보기 띄운 날

npm 실행이 막히는 오류와 node_modules가 깨지는 오류를 순서대로 해결하고 로컬 미리보기를 띄운 기록

한 줄 요약

코딩을 전혀 모르는 내가, 학습허브 사이트 미리보기를 띄우다가 Windows 보안 정책 오류와 설치 깨짐 오류를 연달아 만났다. 둘 다 AI가 알려준 명령어 한 줄씩으로 풀었다.

이런 분들께 도움돼요

  • Windows에서 npm 명령을 처음 써보는 비개발자

  • npm : 이 시스템에서 스크립트를 실행할 수 없으므로... 오류를 만난 분

  • Cannot find module 같은 오류로 미리보기가 안 뜨는 분

Before — 뭐가 문제였나

템플릿을 설치하고 학습메이트까지 만든 뒤, “이제 내 사이트를 미리보기로 띄워줘”라고 했다. PowerShell 창을 열어서 npm install, npm run dev를 입력했는데 바로 막혔다.

npm : 이 시스템에서 스크립트를 실행할 수 없으므로 C:\Program Files\nodejs\npm.ps1 파일을 로드할 수 없습니다.
복사

어떻게 — 막힘과 해결

막힘 1: PowerShell 실행 정책

Windows가 보안상 기본적으로 스크립트 실행을 막아둔 상태였다. 아래 명령 한 줄로 지금 계정에서만 정책을 풀었다.

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
복사

물어보면 Y를 입력하고 엔터. 그 다음 npm install, npm run dev를 다시 실행하면 된다.

막힘 2: 설치가 중간에 깨짐

정책은 풀렸는데, 이번엔 npm run dev에서 다른 오류가 났다.

Error [ERR_MODULE_NOT_FOUND]: Cannot find module '...\node_modules\shiki\dist\index.mjs'
복사

설치(npm install)가 중간에 뭔가 문제가 있어서 일부 파일이 덜 깔린 상태였다. 지우고 다시 까는 걸로 해결했다.

Remove-Item -Recurse -Force node_modules; npm install; npm run dev
복사

After — 결과

astro v4.16.19 ready in 381 ms
┃ Local    http://localhost:4321/
복사

이 주소를 브라우저에 붙여넣으니 내 사이트 첫 화면이 떴다.

느낀 점

오류 메시지만 보면 겁부터 났는데, 막상 원인은 둘 다 “명령어 한 줄”로 풀리는 문제였다. 처음엔 답답했지만, 오류 메시지를 그대로 복사해서 물어보기만 하면 되는구나 싶었다.

재사용 자산 — 막히면 이 순서로

  1. npm : 이 시스템에서 스크립트를 실행할 수 없으므로... 오류 → Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned 실행 후 Y

  2. Cannot find module ... 오류로 미리보기가 안 뜨면 → Remove-Item -Recurse -Force node_modules; npm install 로 재설치

  3. 오류 메시지는 지레짐작하지 말고 화면에 뜬 그대로 복사해서 AI에게 붙여넣기. 원인 진단이 훨씬 빠르다.도하고자 했던 것과 그 이유를 알려주세요.

(내용 입력)

진행 방법

어떤 도구를 사용했고, 어떻게 활용하셨나요?

Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.

Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.

Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)

(내용 입력)

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

과정 중에 어떤 시행착오를 겪었나요?

도움이 필요한 부분이 있나요?

앞으로의 계획이 있다면 들려주세요.

(내용 입력)

도움 받은 글 (옵션)

참고한 지피터스 글이나 외부 사례를 알려주세요.

(내용 입력)

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

아루나 프로필 이미지
아루나2026.07.24

라이브 중에 오류가 나셔서 많이 당황하셨겠어요! 그래도 ai와 함께 잘 풀어가셔서 다행입니다. 제대로 메타학습을 하셨네요.^^ 정말 잘하셨습니다. 사실 좋아보이는 탬플릿으로 막힘없이 잘하는게 좋아보이지만 사실 진짜 실력은 막혀도 뚫어내는데 있습니다. 어제 한뼘 성장하셨어요!

유피테르 프로필 이미지
유피테르2026.07.29

PowerShell 실행 정책과 node_modules 설치 오류를 각각 원인에 맞는 명령어로 해결하고, 결국 `http://localhost:4321/`에서 직접 사이트 첫 화면까지 확인하신 과정이 정말 인상적입니다. 특히 오류 메시지를 추측하지 않고 그대로 복사해 해결의 단서로 활용하신 덕분에, 코딩을 몰라도 실제 결과까지 연결해내셨네요. 두 오류와 해결 순서를 재사용할 수 있게 정리해주셔서 같은 문제를 만난 분들에게 큰 도움이 될 것 같습니다.

김준희 프로필 이미지
김준희2026.07.30

PowerShell에서 처음 보는 빨간 오류가 두 번이나 나오면 꽤 겁났을 텐데, 오류 메시지를 그대로 복사해서 하나씩 해결해간 과정이 좋네요. Set-ExecutionPolicy랑 node_modules 재설치 흐름은 Windows에서 처음 npm 쓰는 분들한테 바로 도움이 될 것 같습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기