NotMyself/new-windows-dev-pc: Windows 개발 환경 자동화 설정

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)

요구 사항	세부 사항	설치
Windows 10/11	향상된 기능을 위해 Windows 11 권장	사전 설치됨
관리자 권한 (Administrator Access)	시스템 수준 설치를 위해 필요	스크립트가 자동으로 권한 상승 처리
PowerShell 7+	현대적인 크로스 플랫폼 PowerShell	누락 시 자동 설치
인터넷 연결	패키지 다운로드를 위해 필요	안정적인 연결 확인
개발자 모드 (Developer Mode)	선택 사항이지만 심볼릭 링크를 위해 권장	설정 → 개발자용

# 관리자 권한으로 실행 (권한 상승 자동 처리)
.\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
# 기존 설정 강제 덮어쓰기
...

계층 (Layer)	Windows 환경	WSL 환경
셸 (Shell)	Oh My Posh가 포함된 PowerShell 7	개발 도구가 포함된 Bash
터미널 (Terminal)	테마가 적용된 Windows Terminal	WSL 터미널 통합
개발 (Development)	Visual Studio 2022 Professional	.NET SDK, Node.js
코드 에디터 (Code Editor)	31개 이상의 확장 프로그램이 포함된 VSCode	WSL 확장 프로그램 통합
AI 어시스턴트 (AI Assistant)	9개의 에이전트가 포함된 Claude Code	Bash에 최적화된 Claude Code
패키지 관리 (Package Management)	WinGet, Chocolatey	APT, NPM
버전 관리 (Version Control)	VSCode가 통합된 Git	Claude Code 식별 정보가 포함된 Git
자격 증명 관리 (Credential Management)	1Password CLI	1Password WSL 통합

필수적인 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 셸

카테고리	도구	개수	비고
Windows & CLI	PowerToys, Windows Terminal, PowerShell 7, Oh My Posh	4	향상된 Windows 기능
개발 환경 (Development Environment)	Git, Git LFS, GitHub CLI, .NET SDK, fnm, Azure CLI, Claude	7	핵심 개발 런타임
IDE 및 에디터 (IDEs & Editors)	Visual Studio 2022 Pro, VSCode, SSMS, Azure Data Studio, JetBrains Toolbox	5	완전한 IDE 생태계
패키지 관리 (Package Management)	WinGet (자동 설치)	1	패키지 관리 기반
글꼴 (Fonts)	레지스트리 통합이 포함된 Cascadia Code	1	합자(ligatures)가 포함된 프로그래밍 글꼴
VSCode 확장 프로그램 (VSCode Extensions)	31개 이상의 큐레이션된 확장 프로그램	31+	풀스택 개발 지원
글로벌 NPM 패키지 (Global NPM Packages)	TypeScript, ESLint, Prettier, Markdownlint, Live Server	5+	필수 개발 도구

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

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

구성 요소 (Component)	대상 위치 (Target Location)	저장소 소스 (Repository Source)	주요 기능 (Features)
Git 설정 (Git Configuration)	~/.gitconfig	settings/git/.gitconfig	VSCode 통합, 유용한 별칭 (aliases)
VSCode 설정 (VSCode Settings)	%APPDATA%\Code\User\	settings/vscode/	설정, 키 바인딩 (keybindings), 31개 이상의 확장 프로그램 (extensions)
PowerShell 프로필 (PowerShell Profile)	$PROFILE	settings/pwsh/Microsoft.PowerShell_profile.ps1	1Password가 포함된 강화된 프로필
Oh My Posh 테마 (Oh My Posh Theme)	~/.theme.omp.json	settings/pwsh/.theme.omp.json	개발자 중심의 프롬프트 (prompt) 테마
Windows Terminal	여러 위치	settings/windows-terminal/settings.json	Windows 11 최적화
Claude Code	~/.claude/	settings/claude/	WSL 최적화 구성
Hosts 파일 (Hosts File)	C:\Windows\System32\drivers\etc\hosts	settings/etc/hosts	네트워크 구성

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

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

에이전트 (Agent)	전문 분야 (Specialization)	주요 기능 (Key Capabilities)
🔧 azure-devops	Azure DevOps 운영	스프린트 관리 (Sprint management), YAML 파이프라인 (YAML pipelines), 작업 항목 수명 주기 (work item lifecycle), API 통합 (API integration)
⚡ csharp	현대적 C# 개발	C# 12+ 기능, .NET 8+ 프레임워크, 클린 아키텍처 (clean architecture), SOLID 원칙
📝 markdown	문서 생성	CommonMark 표준, Azure DevOps 위키 (wiki) 호환성, 자동 포맷팅 (automated formatting)
🧪 mstest	.NET 단위 테스트 (unit testing)	MSTest.Sdk, NSubstitute 패턴, 테스트 커버리지 (test coverage), CI/CD 통합
⚙️ command-expert	CLI 개발	명령 디자인 패턴 (Command design patterns), 인자 파싱 (argument parsing), 자동화 스크립팅 (automation scripting)
🏗️ agent-expert	에이전트 생성	에이전트 아키텍처 (Agent architecture), 프롬프트 엔지니어링 (prompt engineering), 통합 패턴 (integration patterns)
📋 feature-prompt	기능 개발	요구사항 공학 (Requirements engineering), 수락 기준 (acceptance criteria), 이해관계자 커뮤니케이션 (stakeholder communication)
🔌 mcp-expert	모델 컨텍스트 프로토콜 (Model Context Protocol)	MCP 서버 구성, 프로토콜 준수, 커스텀 개발
📚 readme-maintainer	문서 관리	계층적 README 업데이트, 상향식 처리 (bottom-up processing), 교차 참조 검증 (cross-reference validation)

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 # 구성 스크립트
...

문제 사항	증상	해결 방법	예방 조치
PowerShell 버전	구성 스크립트가 실행되지 않음	PowerShell 7 이상을 설치하거나 pwsh .\configure.ps1 실행	$PSVersionTable을 사용하여 버전 확인
개발자 모드 (Developer Mode)	심볼릭 링크 (Symbolic link) 생성이 실패함	설정 → 개발자용에서 활성화	스크립트 실행 전 활성화
UAC 권한 상승	권한 문제로 스크립트 실패	UAC 프롬프트가 나타나면 "예" 클릭	PowerShell을 관리자 권한으로 실행
WSL 미설치	WSL 설정 실패	WSL 기능을 활성화하고 컴퓨터 재부팅	wsl --list --verbose 확인
1Password 통합	환경 변수가 작동하지 않음	.\settings\1password\setup-environment-vault.ps1 실행	OP CLI 설치 여부 확인
VSCode 확장 프로그램	확장 프로그램이 설치되지 않음	VSCode가 PATH에 있는지 확인하고 터미널 재시작	code --version 확인
Claude Code WSL	WSL에서 Claude가 작동하지 않음	WSL 도구 설치 여부 확인	WSL 개발 환경 확인

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

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

구성 요소 (Component)	문서 (Documentation)	중점 분야 (Focus Areas)
설치 스크립트 (Installation Scripts)	installs/README.md	모듈형 설치, 실행 순서, WSL 설정
Claude Code	settings/claude/README.md	9개의 AI 에이전트 (AI agents), WSL 통합, 보안
Git 설정 (Git Configuration)	settings/git/README.md	VSCode 통합, 별칭 (aliases), 워크플로 (workflows)
VSCode 설정 (VSCode Setup)	settings/vscode/README.md	31개 이상의 확장 프로그램 (extensions), 생산성 기능
터미널 설정 (Terminal Configuration)	settings/windows-terminal/README.md	Windows 11 기능, 테마
PowerShell 프로필 (PowerShell Profile)	settings/pwsh/README.md	1Password 통합, Oh My Posh
네트워크 설정 (Network Configuration)	settings/etc/README.md	Hosts 파일 관리, 보안

저장소 포크 (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 통합을 검증하세요 (해당하는 경우)

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