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/mobile/terminal-basics.md (or send Accept: text/markdown).
명령, 파일 및 구성
명령을 붙여넣을 위치, 올바른 프로젝트 폴더를 여는 방법, .env 파일 편집, Expo 서버 중지, 비밀을 공유하지 않고 설정 오류를 보고하는 방법을 배웁니다.
터미널에 명령어가 뜹니다
터미널은 컴퓨터에 대한 지침을 입력하는 창입니다. 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/mobile의 내용만 표시되면 cd ../.. 를 입력하고 Enter를 눌러 루트로 돌아갑니다. 홈 폴더가 표시되면 cd 다음에 공백과 클론의 전체 경로를 입력합니다. 공백이 포함된 경우 따옴표로 묶습니다. 일반적으로 편집기에서 프로젝트 폴더를 열고 새 터미널을 만드는 것이 더 쉽습니다.
pwd
ls구성은 터미널이 아닌 파일에 들어갑니다.
AI_PROVIDER=fake와 같은 블록은 구성 텍스트입니다. 편집기에서 명명된 .env 파일을 열고 AI_PROVIDER=로 시작하는 줄을 찾아 해당 값을 바꾼 다음 Ctrl + S(macOS에서는 Command + S)를 사용하여 저장합니다. 각 설정은 KEY=value 형식으로 한 줄을 차지합니다. Markdown 백틱을 추가하지 마세요. 하나의 파일에 동일한 키의 중복 복사본을 피하십시오.
Expo에는 apps/mobile/.env.local을 사용하고, 데이터베이스 마이그레이션 명령에는 루트 .env를 사용합니다. Expo는 루트 .env를 자동으로 로드하지 않습니다. Web 백엔드는 자체 apps/web/.env.local을 읽습니다. Mobile 전용 체크아웃에서 그 파일은 이 리포지토리가 아닌 별도의 백엔드 리포지토리에 속합니다. 백엔드 주소가 변경되면 apps/mobile/.env.local의 EXPO_PUBLIC_API_URL을 업데이트하고 Expo를 다시 시작합니다. 예제 파일은 참조용으로 그대로 유지합니다.
이름이 점으로 시작하는 파일은 파일 관리자에서 숨겨질 수 있습니다. 편집자의 탐색기에 표시됩니다. 파일 이름이 .env.local.txt가 아닌 정확히 .env.local인지 확인하세요. 이러한 로컬 파일은 비밀번호를 포함할 수 있으며 Git에서 제외됩니다. 해당 내용을 업로드하거나 지원 메시지에 붙여넣지 마십시오.
서버를 계속 실행하세요. 명령에 다른 터미널을 사용하십시오
Expo 개발 서버는 작업하는 동안 화면을 전화기 또는 시뮬레이터에 전달합니다. 튜토리얼에서 QR 코드 스캔을 요구하면 해당 터미널을 열어 두십시오. 서버 명령은 중지할 때까지 계속 실행되며 새 프롬프트를 반환하지 않습니다.
서버가 활성화된 동안 다른 명령을 실행하려면 편집기에서 터미널 → 새 터미널을 선택합니다. 새 터미널은 동일한 프로젝트에 대한 별도의 창입니다. 서버를 중지하려면 해당 터미널을 선택하고 Ctrl + C를 한 번 누릅니다. Windows에서 일괄 작업 종료를 묻는 메시지가 나타나면 Y를 입력하고 Enter 키를 누릅니다. 다시 시작하기 전에 일반 프롬프트가 나타날 때까지 기다리십시오.
Expo 설정을 편집한 후 Ctrl + C로 Expo를 중지한 다음 아래 명령을 실행하여 다시 시작하고 캐시된 번들을 지웁니다. 소스 파일을 저장하면 일반적으로 미리 보기가 자동으로 새로 고쳐지지만 환경 변경에는 다시 시작이 필요합니다.
corepack pnpm --filter @supastack/mobile start --clear실패를 읽고 유용한 도움을 요청하세요
설치 중에 빨간색 오류 텍스트가 반환되면 해당 단계에서 중지하세요. 앱을 계속 실행하기보다는 첫 번째 오류를 읽어보세요. 찾을 수 없는 명령은 일반적으로 도구가 누락되었음을 의미합니다. package.json이 없다는 것은 일반적으로 잘못된 폴더를 의미합니다. ECONNREFUSED는 일반적으로 필요한 서버나 데이터베이스가 실행되고 있지 않음을 의미합니다. EADDRINUSE는 다른 프로세스가 이미 해당 포트를 사용하고 있음을 의미합니다.
도움을 요청할 때 운영 체제, 가이드 URL 및 단계 번호, 입력한 정확한 명령 및 첫 번째 오류 메시지를 포함하십시오. 비밀번호, API 키, 토큰 및 데이터베이스 URL의 비밀번호 부분을 제거합니다. .env 파일을 보내지 마세요. 오류 스크린샷이 도움이 될 수 있지만 복사 가능한 텍스트가 진단하기 더 쉽습니다.