목차

Wiki/시작하기

다시 열기

  1. 11. 폴더를 찾습니다
  2. 22. 실습 웹을 띄웁니다
  3. 33. 그만할 때
  4. 4안 될 때
  5. 5띄우고 나서

다시 열기

수업이 끝나고 집에서 혼자 실습 웹을 다시 띄우는 순서입니다. 새로 설치하는 것이 아니라, 이미 있는 폴더를 찾아서 여는 것뿐입니다.

1. 폴더를 찾습니다

포크한 저장소를 컴퓨터 어디에 두었는지 기억나지 않아도 됩니다. Cursor가 기억하고 있습니다.

  1. Cursor를 엽니다.
  2. File → Open Recent (한국어 메뉴는 파일 → 최근 항목 열기) 를 누릅니다.
  3. 목록에 opencircuit 이 들어간 폴더가 있습니다. 그것을 고릅니다.

목록에 없으면 컴퓨터에서 폴더 이름으로 찾습니다.

  • Windows — 파일 탐색기에서 내 PC 를 고르고 오른쪽 위 검색 칸에 opencircuit 을 칩니다.
  • Mac — Finder에서 +F 를 누르고 opencircuit 을 칩니다. 검색 범위를 이 Mac 으로 바꿉니다.

찾은 폴더는 다음에 또 헤매지 않도록 바탕화면에 바로가기를 만들어 두면 편합니다.

2. 실습 웹을 띄웁니다

Cursor에서 그 폴더를 연 상태로 터미널을 엽니다. Ctrl/⌘+` 입니다.

Mac

bash
./start.sh

Windows — 터미널 오른쪽 위에서 PowerShell 을 고른 뒤

powershell
.\start.ps1

처음 한 번은 부품을 내려받느라 몇 분 걸립니다. 두 번째부터는 빠릅니다.

실습 웹: http://127.0.0.1:1234 가 찍히고 브라우저가 저절로 열리면 된 것입니다. 안 열리면 그 주소를 브라우저에 직접 칩니다.

3. 그만할 때

터미널에서 Ctrl+C 를 누릅니다. 창을 그냥 닫아도 됩니다.

다시 하려면 2번만 반복하면 됩니다. 폴더를 다시 찾을 필요는 없습니다.

안 될 때

이런 일이 생기면이렇게 합니다
command not found 또는 '.\start.ps1'을(를) 인식할 수 없습니다폴더를 잘못 열었습니다. 그 폴더 안에 start.sh 가 보이는지 확인합니다
Windows에서 이 시스템에서 스크립트를 실행할 수 없으므로PowerShell에 Set-ExecutionPolicy -Scope Process Bypass -Force 를 먼저 칩니다. 이 창에서만 풀립니다
까만 창에 빨간 글씨가 잔뜩 나온다그 글을 지우지 말고 그대로 복사해서 Cursor 채팅에 붙여 넣고 "오류를 해결해줘" 라고 합니다. 막힐 때
브라우저는 열리는데 화면이 비어 있다주소가 127.0.0.1:1234 가 맞는지 보고, 새로고침합니다

혼자 풀지 못해도 괜찮습니다. 화면을 캡처해서 단톡방이나 배준형에게 보내 주세요.

띄우고 나서

무엇부터 할지는 한 바퀴 돌기 에 있습니다.

《2026 오픈서킷 부산: 아트앤테크 프랙티스》 수업 자료 · 글·기획 배준형