# Clinic-OS 지원 환경
이 문서는 Clinic-OS 클라이언트 설치·운영 환경의 단일 진실 원천(SOT)입니다. 다른 문서에서
지원 범위를 설명할 때는 별도 목록을 만들지 말고 이 문서를 참조하세요.
| 환경 | 상태 | Node.js 설치 | 셸 안내 | 알려진 제약 |
|---|---|---|---|---|
| GitHub Codespaces | 지원 | devcontainer가 준비 | 기본 터미널 사용 | Codespace 준비가 끝난 뒤 진행 |
| macOS | 지원 | Homebrew 또는 nvm | 기본 셸 사용 | 없음 |
| WSL Ubuntu | 지원 | apt 또는 nvm | Ubuntu 터미널 사용 | 프로젝트를 WSL 파일 시스템에 두는 것을 권장 |
| Windows 네이티브 | 지원 (2026-08-03 canary) | Node.js MSI 직접 설치 (`winget` 비권장) | PowerShell은 `npm` 대신 `npm.cmd` 사용; cmd.exe는 `npm` 사용 가능 | Git `user.name`/`user.email`을 미리 설정; 최초 빌드의 `npx` ENOENT 문제는 v1.65.x에서 수정됨 |
Windows 네이티브 행의 운영 정보는
[Windows Native ClinicOS Verification — Live Findings](./internal/2026-08-03-windows-native-corepull-canary-findings.md)에서
도출했습니다. 당시 cmd.exe와 PowerShell 양쪽에서 업데이트, 빌드, Cloudflare 배포 및 실제
서빙 응답까지 검증했습니다.
## Windows 네이티브 시작 전 확인
1. Node.js 공식 MSI와 Git for Windows를 설치합니다.
2. Git 커밋 신원 정보를 설정합니다.
```powershell
git config --global user.name "이름"
git config --global user.email "이메일"
```
3. PowerShell에서는 `npm.cmd run <script>` 형태를 사용합니다. 시스템 실행 정책을 바꿀
필요가 없습니다. cmd.exe에서는 일반적인 `npm run <script>`가 동작합니다.
환경별 상세 절차는 [Windows 호스트 가이드](./WINDOWS_GUIDE.md)와
[Codespaces 설치 가이드](./CODESPACES_SETUP_GUIDE.md)를 참고하세요.