PowerShell 7+, Windows 11 최적화 및 필수적인 WSL 통합을 특징으로 하는 포괄적인 Windows 개발자 설정 자동화 저장소입니다. 현대적인 개발 워크플로우를 위해 간소화된 2단계 설치, 자동화된 도구 배포, 그리고 9개 이상의 특화된 AI 에이전트를 포함한 Claude Code 통합을 제공합니다.

⚡ 2단계 설정: 간단한 install.ps1

→ configure.ps1 프로세스

🐧 필수 WSL 통합: Ubuntu 22.04 개발 환경

🤖 9 Claude Code AI 에이전트: 도메인 특화 개발을 위한 전문 전문가

📦 30개 이상의 개발 도구: 자동화된 WinGet 패키지 설치

🔐 1Password 통합: 안전한 자격 증명 및 환경 변수 관리

💻 전문 IDE 설정: VSCode (31개 이상의 확장 프로그램) + Visual Studio 2022 Professional

🎨 향상된 터미널 경험: Windows Terminal + PowerShell 7 + Oh My Posh 테마

🔗 심볼릭 링크 (Symbolic Link) 관리: 실시간 업데이트가 가능한 중앙 집중식 구성

• 사전 요구 사항 (Prerequisites)
• 설치 및 설정 (Installation and Setup)
• 아키텍처 및 구성 요소 (Architecture and Components)
• 구성 세부 정보 (Configuration Details)
• Claude Code 통합 (Claude Code Integration)
• 사용 예시 (Usage Examples)
• 디렉토리 구조 (Directory Structure)
• 문제 해결 (Troubleshooting)
• 기여 가이드라인 (Contributing Guidelines)

# 관리자 권한으로 실행 (권한 상승 자동 처리)
.\install.ps1

설치되는 항목:

• ✅
  WinGet Package Manager- 포괄적인 오류 처리를 포함한 Windows 패키지 관리 - ✅
  30+ Development Tools- WinGet을 통한 IDE, 유틸리티 및 개발 환경 - ✅
  WSL Environment- Node.js, .NET SDK, Azure CLI, 1Password CLI가 포함된 Ubuntu 22.04 - ✅
  Cascadia Code Fonts- 합자(Ligatures) 및 레지스트리 통합 기능이 포함된 프로그래밍용 폰트 - ✅
  VSCode Extensions- 풀스택 개발을 위해 엄선된 31개 이상의 확장 프로그램 - ✅
  Global NPM Packages- Fast Node Manager (fnm)를 통한 필수 개발 패키지

# 대화형 설정 마법사
.\configure.ps1

설정 항목:

• ✅
  Claude Code for WSL- 개발 도구가 포함된 Bash 셸 최적화 - ✅
  1Password Integration- Windows 및 WSL을 위한 보안 환경 변수 - ✅
  Git Identity Management- 사용자 및 Claude Code 커밋을 위한 별도의 식별 정보 관리 - ✅
  Symbolic Link Creation- 중앙 집중식 설정 관리 - ✅
  PowerShell Profile- Oh My Posh 테마 및 생산성 함수 - ✅
  Interactive Guidance- 단계별 설명 및 확인 절차

# 자동 배포 (확인 절차 생략)
.\configure.ps1 -SkipConfirmation
# 기존 설정 강제 덮어쓰기
...

필수적인 WSL 통합은 포괄적인 Linux 개발 환경을 제공합니다:

Node.js LTS: NodeSource 저장소를 통한 최신 안정 버전
** .NET SDK**: 크로스 플랫폼 개발을 위한 Microsoft .NET 개발 플랫폼
Azure CLI: 완전한 Azure 명령줄 도구 및 인증
1Password CLI: 안전한 자격 증명 검색 및 환경 변수 관리

필수적인 NPM 패키지 (Essential NPM Packages): prettier, markdownlint-cli, typescript, eslint
빌드 도구 (Build Tools): make, build-essential, curl, wget, git
Claude Code 통합 (Claude Code Integration): 도구 권한 및 환경 최적화가 적용된 Bash 셸

이 설정은 시스템 위치에서 저장소 파일로 심볼릭 링크 (symbolic links)를 생성하여 다음과 같은 기능을 가능하게 합니다:

실시간 구성 업데이트 (Live Configuration Updates): 저장소 파일의 변경 사항이 시스템 설정에 즉시 반영됨
버전 관리 통합 (Version Control Integration): 모든 구성 변경 사항이 Git에서 추적됨
다중 기기 일관성 (Multi-Machine Consistency): 서로 다른 개발 환경에서도 동일한 구성 유지
간편한 복구 (Easy Restoration): 간단한 저장소 체크아웃(checkout)으로 모든 설정 복구

다중 경로 지원 (Multi-Path Support): Windows Terminal 설치 방식(표준 방식 vs Microsoft Store 방식)을 자동으로 감지합니다.
개발자 모드 감지 (Developer Mode Detection): 개발자 모드가 활성화된 경우 관리자 권한 없이 심볼릭 링크 (symbolic links)를 사용합니다.
백업 관리 (Backup Management): 기존 구성을 덮어쓰기 전에 백업을 생성합니다.
오류 복구 (Error Recovery): 명확한 복구 지침이 포함된 포괄적인 오류 처리 기능을 제공합니다.
대화형 안내 (Interactive Guidance): 상세한 설명과 함께 단계별 구성을 진행합니다.

이 저장소에는 도메인 특화 에이전트 (domain-specific agents)가 포함된 포괄적인 Claude Code 구성이 포함되어 있습니다:

Claude Code 설정은 WSL 개발에 최적화되어 있습니다:

{
"shell": "/bin/bash",
"env": {
...

향상된 기능을 위해 구성된 현대적인 MCP 서버들:

filesystem: 디렉토리 액세스 제어가 포함된 파일 작업
memory: 지속적인 대화 컨텍스트 및 메모리 관리
sequential-thinking: 구조화된 추론 및 문제 해결 워크플로
context7: 고급 컨텍스트 관리 및 지능형 검색

# 프로젝트 디렉토리로 이동
oss my-new-project
# Claude Code를 사용하여 프로젝트 구조 초기화
...

# 빠른 탐색 함수
oss [subdir] # ~/src/oss/[subdir]로 이동
work [subdir] # ~/src/ofm/[subdir]로 이동
...

# 컨텍스트와 작업에 따라 에이전트가 자동으로 활성화됩니다
# 에이전트 전문화 예시:
# C# 개발 작업 → csharp 에이전트
...

.\settings\az\setup-azure-service-principal.ps1

• 대화형 Azure CLI 인증 및 연결
• 기여자 (Contributor) 역할 할당을 포함한 서비스 주체 (Service principal) 생성
• 보안 환경 변수를 위한 1Password 자격 증명 저장
• 상세한 피드백을 통한 연결 테스트 및 검증

.\settings\1password\setup-environment-vault.ps1

• Windows 및 WSL 전반에 걸친 보안 환경 변수 관리
• 서비스 계정 설정을 통한 CLI 통합 구축
• Vault 생성 및 권한 관리
• 원활한 액세스를 위한 PowerShell 및 WSL 통합

new-windows-dev-pc/
├── 📄 install.ps1 # 메인 설치 스크립트
├── 📄 configure.ps1 # 구성 스크립트
...

# 시스템 진단
Get-ExecutionPolicy # PowerShell 실행 정책 확인
wsl --list --verbose # WSL 상태 및 버전 확인
...

각 구성 요소에는 포괄적인 문서가 포함되어 있습니다:

저장소 포크 (Fork the Repository): 개발을 위해 자신만의 포크를 생성하세요
기능 브랜치 생성 (Create Feature Branch): 설명적인 브랜치 이름을 사용하세요 (feature/add-python-support)
변경 사항 테스트 (Test Changes): Windows 10/11 및 WSL 환경 전반에서 기능을 검증하세요
문서 업데이트 (Update Documentation): README 파일이 변경 사항을 반영하도록 하세요
풀 리퀘스트 제출 (Submit Pull Request): 변경 사항과 수행된 테스트에 대한 명확한 설명을 제공하세요

• 함수에는 PascalCase를, 변수에는 $camelCase를 사용하세요

• 명확한 에러 메시지와 함께 포괄적인 에러 처리 (error handling)를 포함하세요

• Get-Help와 호환되는 주석과 함께 도움말 문서를 추가하세요

• 호환성을 위해 PowerShell 5.1 및 7+ 버전에서 테스트하세요

• CommonMark/GitHub Flavored Markdown 표준을 따르세요

• 일관된 헤딩 계층 구조와 서식을 사용하세요

• 구문 강조 (syntax highlighting)가 포함된 코드 예제를 포함하세요

• 구조적 변경이 있을 경우 목차 (table of contents)를 업데이트하세요

• 커밋하기 전에 JSON 구문을 검증하세요

• 일관된 들여쓰기를 사용하세요 (JSON은 2칸, PowerShell은 4칸)

• 도움이 되는 경우 주석을 포함하세요 (JSON이 아닌 파일의 경우)

• 깨끗한 환경 (clean environment)에서 구성 변경 사항을 테스트하세요

• 깨끗한 Windows 10 및 Windows 11 설치 환경에서 테스트하세요

• WSL 통합이 올바르게 작동하는지 확인하세요

• 모든 심볼릭 링크 (symbolic links)가 적절하게 생성되었는지 확인하세요

• 1Password 통합을 검증하세요 (해당하는 경우)

• 신규 설치와 업데이트 모두 테스트하세요