install-sh/VIBE-WORK/261104/INSTALL-CODIUM-PHASE01.md

VSCodium (codium) 설치 스크립트 및 문서 추가 완료 보고서 (INSTALL-CODIUM-PHASE01)

1. 개요

Microsoft의 Visual Studio Code(VS Code) 오픈소스 코드베이스에서 원격 측정(Telemetry), 추적기, 독점 라이선스 요소를 모두 제거하고 **개발에 꼭 필요한 최소한의 핵심 기능만 남긴 순수 오픈소스 코드 에디터 VSCodium (codium)**의 크로스 플랫폼 자동 설치 스크립트(install-codium.sh, install-codium.ps1)를 구현하고 README.md 및 NECESSARY.md에 반영하였습니다.

flowchart LR
    subgraph Script["VSCodium 자동 설치"]
        SH["install-codium.sh<br/>(macOS Homebrew / Linux 공식 APT·RPM·AUR / GitHub Release 폴백)"]
        PS1["install-codium.ps1<br/>(Windows winget / GitHub Release UserSetup.exe 폴백)"]
    end
    subgraph Docs["문서 반영"]
        README["README.md<br/>3. 개발 유틸리티 섹션"]
        NEC["NECESSARY.md<br/>3. 개발 유틸리티 & 핵심 사용법"]
    end
    Script --> Docs

2. 세부 구현 내역

2.1. install-codium.sh (macOS / Linux)

• macOS: 공식 가이드대로 brew install --cask vscodium 설치 및 /Applications/VSCodium.app/Contents/Resources/app/bin/codium을 ~/.local/bin/codium에 심볼릭 링크 연결 (실패 시 GitHub Releases VSCodium-darwin-<arch>-<tag>.zip 직접 설치 폴백)
• Linux (Debian/Ubuntu/Mint): 공식 GPG 키(/usr/share/keyrings/vscodium-archive-keyring.gpg) 및 APT 저장소(https://download.vscodium.com/debs) 등록 후 codium 설치
• Linux (Fedora/RHEL/Rocky/openSUSE): 공식 RPM 저장소(https://download.vscodium.com/rpms/) 등록 후 dnf / yum / zypper를 통한 codium 설치
• Linux (Arch & 범용 폴백): yay/paru 지원 및 비루트·기타 배포판 환경을 위한 GitHub Releases(VSCodium-linux-<arch>-<tag>.tar.gz) 3단계 폴백 다운로드 지원

2.2. install-codium.ps1 (Windows PowerShell)

• 1차 설치: 공식 권장 winget install -e --id VSCodium.VSCodium 실행
• 2차 폴백: winget 미지원 또는 오류 발생 시 GitHub Releases API에서 VSCodiumUserSetup-<arch>-<version>.exe를 다운로드하여 무인 설치(/VERYSILENT) 및 PATH 자동 등록

2.3. 문서 업데이트 (README.md, NECESSARY.md)

• 3. 개발 유틸리티 카테고리에 VSCodium (codium) 추가
• VS Code에서 출발했으나 원격 측정(Telemetry)·추적기·독점 요소를 걷어내고 최소한의 필요한 핵심 기능만 남긴 순수 오픈소스 코드 에디터라는 점을 강조