> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 명령, 파일 및 구성

명령을 붙여넣을 위치, 올바른 프로젝트 폴더를 여는 방법, .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/desktop의 내용만 표시되면 cd ../.. 를 입력하고 Enter를 눌러 루트로 돌아갑니다. 홈 폴더가 표시되면 cd 다음에 공백과 클론의 전체 경로를 입력합니다. 공백이 포함된 경우 따옴표로 묶습니다. 일반적으로 편집기에서 프로젝트 폴더를 열고 새 터미널을 만드는 것이 더 쉽습니다.

```
pwd
ls
```


## 구성은 터미널이 아닌 파일에 들어갑니다.

AI_PROVIDER=fake와 같은 블록은 구성 텍스트입니다. 편집기에서 명명된 .env 파일을 열고 AI_PROVIDER=로 시작하는 줄을 찾아 해당 값을 바꾼 다음 Ctrl + S(macOS에서는 Command + S)를 사용하여 저장합니다. 각 설정은 KEY=value 형식으로 한 줄을 차지합니다. Markdown 백틱을 추가하지 마세요. 하나의 파일에 동일한 키의 중복 복사본을 피하십시오.

데이터베이스 마이그레이션 명령에는 루트 .env를, Web 백엔드에는 apps/web/.env.local을 사용합니다, Desktop 전용 체크아웃에서 그 파일은 별도의 백엔드 리포지토리에 속합니다. 데스크톱 셸은 .env 파일을 읽지 않습니다: SUPASTACK_APP_URL은 시작할 때 명령줄에서 전달하는 터미널 환경 설정이지 파일에 저장된 구성이 아닙니다. 예제 파일은 참조용으로 그대로 유지합니다.

이름이 점으로 시작하는 파일은 파일 관리자에서 숨겨질 수 있습니다. 편집자의 탐색기에 표시됩니다. 파일 이름이 .env.local.txt가 아닌 정확히 .env.local인지 확인하세요. 이러한 로컬 파일은 비밀번호를 포함할 수 있으며 Git에서 제외됩니다. 해당 내용을 업로드하거나 지원 메시지에 붙여넣지 마십시오.

[각 설정의 의미 찾기](https://supastack.dev/ko/docs/desktop/project-structure.md)


## 개발 명령을 계속 실행하고 다른 터미널에서 명령 사용

데스크톱 개발 명령은 Rust 셸을 컴파일하고 실행되는 동안 창을 엽니다. 창을 테스트하는 동안 해당 터미널을 열어 두십시오. 서버 명령은 중지할 때까지 계속 실행되며 새 프롬프트를 반환하지 않습니다.

서버가 활성화된 동안 다른 명령을 실행하려면 편집기에서 터미널 → 새 터미널을 선택합니다. 새 터미널은 동일한 프로젝트에 대한 별도의 창입니다. 서버를 중지하려면 해당 터미널을 선택하고 Ctrl + C를 한 번 누릅니다. Windows에서 일괄 작업 종료를 묻는 메시지가 나타나면 Y를 입력하고 Enter 키를 누릅니다. 다시 시작하기 전에 일반 프롬프트가 나타날 때까지 기다리십시오.

셸 설정을 변경한 후 Ctrl + C로 데스크톱 명령을 중지하고 다시 실행합니다. Rust 코어는 시작할 때마다 다시 컴파일됩니다. SUPASTACK_APP_URL 변경은 저장된 파일을 편집하는 것이 아니라 다음 실행에서 새 값을 전달하는 것을 의미합니다.

```
corepack pnpm --filter @supastack/desktop dev
```


## 실패를 읽고 유용한 도움을 요청하세요

설치 중에 빨간색 오류 텍스트가 반환되면 해당 단계에서 중지하세요. 앱을 계속 실행하기보다는 첫 번째 오류를 읽어보세요. 찾을 수 없는 명령은 일반적으로 도구가 누락되었음을 의미합니다. package.json이 없다는 것은 일반적으로 잘못된 폴더를 의미합니다. ECONNREFUSED는 일반적으로 필요한 서버나 데이터베이스가 실행되고 있지 않음을 의미합니다. EADDRINUSE는 ​​다른 프로세스가 이미 해당 포트를 사용하고 있음을 의미합니다.

도움을 요청할 때 운영 체제, 가이드 URL 및 단계 번호, 입력한 정확한 명령 및 첫 번째 오류 메시지를 포함하십시오. 비밀번호, API 키, 토큰 및 데이터베이스 URL의 비밀번호 부분을 제거합니다. .env 파일을 보내지 마세요. 오류 스크린샷이 도움이 될 수 있지만 복사 가능한 텍스트가 진단하기 더 쉽습니다.

[특정 설정 실패 문제 해결](https://supastack.dev/ko/docs/desktop/troubleshooting.md)


## 다음

[에이전트에게 설정 맡기기](https://supastack.dev/ko/docs/desktop/agent-setup.md)