For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/web/terminal-basics.md (or send Accept: text/markdown).
명령, 파일 및 구성
명령을 붙여 넣을 위치, 올바른 프로젝트 폴더를 여는 방법, .env 파일을 편집하는 방법, 서버를 중지하고 비밀을 공유하지 않고 설정 오류를 보고하는 방법을 알아보세요.
터미널에 명령어가 뜹니다
터미널은 컴퓨터에 대한 지침을 입력하는 창입니다. Visual Studio Code에서 먼저 파일 → 폴더 열기를 사용하여 supastack 폴더를 연 다음 터미널 → 새 터미널을 선택합니다. 새 터미널은 해당 폴더에서 시작됩니다. Windows에서는 터미널의 + 버튼 옆에 있는 메뉴를 사용하여 PowerShell를 선택합니다. macOS 또는 Linux 터미널에서 macOS/Linux 블록을 사용합니다.
명령 블록의 내용만 한 번에 하나씩 붙여넣고 Enter 키를 누릅니다. 주변 Markdown 백틱, PS C:\...와 같은 프롬프트 또는 예제 출력을 붙여넣지 마십시오. #으로 시작하는 줄은 설명입니다. 그들은 아무것도 실행하지 않습니다. 다음 명령을 입력하기 전에 각 설치 명령이 완료될 때까지 기다리십시오. 서버 명령은 계속 실행되며 중지할 때까지 새로운 프롬프트를 반환하지 않습니다.
터미널이 어떤 폴더를 사용하고 있는지 확인하세요
리포지토리 루트는 package.json, pnpm-workspace.yaml, 앱 및 패키지가 포함된 최상위 supasack 폴더를 의미합니다. 단계에 달리 명시되지 않는 한 해당 단계에서 명령을 실행하세요. 아래 명령은 현재 폴더를 인쇄합니다. 파일 목록에 package.json이 표시되어야 합니다. Windows에서는 PowerShell pwd 및 ls도 작동합니다.
목록에 apps/web 또는 apps/mobile의 내용만 표시되면 cd ../..를 입력하고 Enter를 눌러 루트로 돌아갑니다. 홈 폴더가 표시되면 cd를 입력하고 그 뒤에 공백을 입력하고 복제본의 전체 경로를 입력합니다. 공백이 포함된 경우 따옴표로 묶습니다. 일반적으로 편집기에서 프로젝트 폴더를 열고 새 터미널을 만드는 것이 더 쉽습니다.
pwd
ls구성은 터미널이 아닌 파일에 들어갑니다.
AI_PROVIDER=fake와 같은 블록은 구성 텍스트입니다. 편집기에서 명명된 .env 파일을 열고 AI_PROVIDER=로 시작하는 줄을 찾아 해당 값을 바꾼 다음 Ctrl + S(macOS에서는 Command + S)를 사용하여 저장합니다. 각 설정은 KEY=value 형식으로 한 줄을 차지합니다. Markdown 백틱을 추가하지 마세요. 하나의 파일에 동일한 키의 중복 복사본을 피하십시오.
데이터베이스 마이그레이션 명령에는 루트 .env를 사용하고, Next.js 웹 서버에는 apps/web/.env.local를, Expo에는 apps/mobile/.env.local를 사용합니다. Next 및 Expo는 자체 앱 폴더 내에서 실행되며 루트 .env를 자동으로 로드하지 않습니다. 데이터베이스 연결이 변경되면 루트 .env 및 apps/web/.env.local 모두에서 DATABASE_URL를 업데이트하여 마이그레이션과 서버가 동일한 데이터베이스를 사용하도록 합니다. 나중에 참조할 수 있도록 예제 파일을 변경하지 않고 유지하세요.
이름이 점으로 시작하는 파일은 파일 관리자에서 숨겨질 수 있습니다. 편집자의 탐색기에 표시됩니다. 파일 이름이 .env.local.txt가 아닌 정확히 .env.local인지 확인하세요. 이러한 로컬 파일은 비밀번호를 포함할 수 있으며 Git에서 제외됩니다. 해당 내용을 업로드하거나 지원 메시지에 붙여넣지 마십시오.
서버를 계속 실행하세요. 명령에 다른 터미널을 사용하십시오
작업하는 동안 개발 서버가 앱을 제공합니다. 튜토리얼에서 open localhost:3000이라고 나오면 터미널을 열어두세요. localhost는 이 컴퓨터를 의미합니다. :3000은 앱에서 사용하는 번호가 매겨진 문과 같은 포트입니다. URL를 터미널이 아닌 브라우저의 주소 표시줄에 넣으세요.
서버가 활성화된 동안 다른 명령을 실행하려면 편집기에서 터미널 → 새 터미널을 선택합니다. 새 터미널은 동일한 프로젝트에 대한 별도의 창입니다. 서버를 중지하려면 해당 터미널을 선택하고 Ctrl + C를 한 번 누릅니다. Windows에서 일괄 작업 종료를 묻는 메시지가 나타나면 Y를 입력하고 Enter 키를 누릅니다. 다시 시작하기 전에 일반 프롬프트가 나타날 때까지 기다리십시오.
웹 환경 설정을 편집한 후 아래 명령을 사용하여 웹 서버를 중지했다가 다시 시작합니다. 소스 파일을 저장하면 일반적으로 페이지가 자동으로 새로 고쳐지지만 환경이 변경되면 다시 시작해야 합니다. Expo 설정을 편집한 후 Expo를 중지한 다음 corepack pnpm --filter @supastack/mobile start --clear를 실행하여 캐시된 번들을 다시 시작하고 지웁니다.
corepack pnpm --filter @supastack/web dev실패를 읽고 유용한 도움을 요청하세요
설치 중에 빨간색 오류 텍스트가 반환되면 해당 단계에서 중지하세요. 앱을 계속 실행하기보다는 첫 번째 오류를 읽어보세요. 찾을 수 없는 명령은 일반적으로 도구가 누락되었음을 의미합니다. package.json이 없다는 것은 일반적으로 잘못된 폴더를 의미합니다. ECONNREFUSED는 일반적으로 필요한 서버나 데이터베이스가 실행되고 있지 않음을 의미합니다. EADDRINUSE는 다른 프로세스가 이미 해당 포트를 사용하고 있음을 의미합니다.
도움을 요청할 때 운영 체제, 가이드 URL 및 단계 번호, 입력한 정확한 명령 및 첫 번째 오류 메시지를 포함하십시오. 비밀번호, API 키, 토큰 및 데이터베이스 URL의 비밀번호 부분을 제거합니다. .env 파일을 보내지 마세요. 오류 스크린샷이 도움이 될 수 있지만 복사 가능한 텍스트가 진단하기 더 쉽습니다.