CodeGym 설치 프로그램: 여러분의 컴퓨터에 무엇을 하는가

CodeGym 설치 프로그램은 관리자 권한을 요구하고, 컴퓨터에 프로그램을 열 개쯤 설치합니다. 이 순간 경계심이 드는 건 자연스럽고, 또 올바른 반응입니다. 자기 컴퓨터를 아끼는 사람이라면 누구든 물어볼 권리가 있습니다. 이 프로그램이 내 컴퓨터에 정확히 무엇을 하려는 걸까?

이 글은 그 질문에 빠짐없이, 숨김없이 답합니다. 무엇이 설치되는지, 어디에 놓이는지, 무엇은 건드리지 않는지, 어떤 데이터를 수집하는지, 그리고 이 모든 것을 되돌리는 방법까지.

설치 프로그램을 쓰고 싶지 않다면 쓰지 않으셔도 됩니다. 설치 프로그램 없이도 과정을 진행할 수 있습니다. 필요한 것은 전부 직접 설치하는 방법을 강의에서 단계별로 안내합니다. 설치 프로그램은 그 반복 작업을 덜어 줄 뿐입니다.

1. 왜 필요한가

이 과정에는 꽤 많은 도구가 필요합니다. Claude Code 자체, 개발 환경, 언어, 빌드 도구. 도구마다 설치 방법도 설정도 제각각이고, 일부는 서로 연결하고 로그인까지 해야 합니다.

이 모든 것을 손으로 할 수도 있습니다. 하지만 몇 시간이 걸리는 작업이고, 실수하기 쉬운 데다 나중에 왜 실행이 안 되는지 한참 찾아 헤매게 됩니다. 설치 프로그램은 같은 일을 한 번의 실행으로 끝냅니다. 지루하지만, 결과는 예측 가능합니다.

2. 무엇이 설치되나

아래는 컴퓨터에 새로 생기는 것의 전체 목록입니다.

Claude Code와 음성 입력

Claude Code CLI - 이 과정의 핵심 도구, 바로 그 AI 에이전트입니다. claude.ai에서 제공하는 Anthropic 공식 설치 프로그램으로 설치되며, 항상 최신 버전입니다.

Handy - 음성 인식 유틸리티입니다. 작업을 타이핑하는 대신 에이전트에게 말로 불러 줄 수 있게 해 줍니다. 함께 내려받는 음성 인식 모델 Parakeet V3(약 456MB)는 인터넷 없이 여러분의 컴퓨터에서 동작합니다.

Claude Code 플러그인 두 개 - Anthropic 공식 마켓플레이스의 superpowers와 frontend-design.

개발 환경

IntelliJ IDEA - 이 과정의 기본 IDE입니다. 플러그인 세 개가 함께 설치됩니다. Python 지원, CodeGym 플러그인(과제를 제출해 검사받기), Claude Code 플러그인(IDE 안에서 바로 쓰는 에이전트 패널).

Visual Studio Code - 두 번째 IDE로, 원하면 쓸 수 있게 나란히 설치됩니다. 같은 구성에서 플러그인 두 개가 들어갑니다. CodeGym(베타 버전)과 공식 Claude Code 확장입니다.

언어와 유틸리티

Node.js 24 - 과정의 프로젝트와 결과 검사가 이 위에서 돌아갑니다.
Python 3.14 - 스크립트와 일부 과제용.
Java 25 (Eclipse Temurin) - CodeGym 플랫폼의 기반.
Gradle 9.5.1 - Java 프로젝트 빌드.
Git - 프로젝트 이력을 저장합니다. 과정을 진행하다 보면 필요해집니다. Windows에서는 Git Bash가 함께 설치됩니다.

설정과 로그인

과정의 AI 서버 접속 설정 파일, CodeGym 플러그인 구성, 그리고 Claude Code 학습 프로필(에이전트의 작업 규칙, 보조 기법, 게임과 웹 프로젝트용 템플릿)이 들어갑니다. 모두 여러분에게 맞게 미리 채워져 있으니 키를 입력하거나 로그인할 필요가 없습니다.

시스템별 차이

macOS에서는 Homebrew(패키지 관리자)가 설치되어 있지 않으면 설치 프로그램이 Homebrew도 설치합니다. Git, Python, VS Code가 Homebrew를 통해 설치되기 때문입니다.

Linux에서는 Node.js, Python, Microsoft(VS Code용) 저장소가 추가됩니다. Debian에서는 Python 3.14가 설치되지 않습니다. 설치 프로그램이 보고서에서 이 사실을 숨기지 않고 알려 주니, 직접 설치해야 합니다.

3. 어디에 설치되나

설치 프로그램은 시스템 곳곳에 파일을 흩어 놓지 않습니다. 모든 것이 예측 가능한 위치에 있으니, 나중에 무엇이 어디에 들어갔는지 확인하고 싶을 때 뒤지지 않고도 찾을 수 있습니다.

프로그램

시스템	위치
Windows	`Program Files`, `C:\Gradle`
macOS	`/Applications`, `/opt`
Linux	`/opt`

홈 폴더의 디렉터리 세 개

.claude-codegym - Claude Code 학습 프로필입니다. 설정, 에이전트의 작업 규칙, 보조 기법이 들어 있습니다.

.codegym - CodeGym 플러그인 로그인 설정과 실행 명령 두 개(아래에서 설명합니다).

.codegym-backups - 설치 프로그램이 변경한 파일의 백업과 변경 기록입니다. 최근 10회 실행분 또는 30일치가 보관됩니다.

그 밖에 Claude Code 자체는 ~/.local/bin에, 음성 인식 모델은 Handy 데이터 폴더에 설치됩니다.

시스템 설정에서 바뀌는 것

PATH 변수 - 과정의 명령을 터미널에서 실행할 수 있게 하기 위해서입니다. Windows에서는 레지스트리를, macOS에서는 .zprofile 파일을, Linux에서는 /etc/profile.d/codegym.sh와 .profile을 수정합니다.

macOS와 Linux에서는 저희가 추가한 줄이 # CODEGYM START와 # CODEGYM END 마커로 감싸져 있습니다. 눈으로 바로 확인할 수 있고, 되돌리기를 하면 정확히 그 줄만 지워지며 여러분의 설정은 건드리지 않습니다.

Windows 레지스트리 - 항목 세 개뿐입니다. Gradle 경로, 과정 명령 경로, 그리고 IntelliJ IDEA 라이선스 계약 동의.

4. 명령 두 개: claude와 claude-native

미리 알아 두면 좋은 중요한 부분입니다.

이 과정에는 자체 Claude Code 설정이 있습니다. 학습 서버 연결, 에이전트의 작업 규칙, 과정 캐릭터. 이것을 여러분의 개인 설정과 섞으면 안 되기 때문에 둘을 분리해 두었습니다.

claude - 과정 프로필로 Claude Code를 실행합니다. 과정을 공부할 때 쓰는 것이 이쪽입니다.

claude-native - 저희가 없는 것처럼 여러분 개인의 Claude Code를 실행합니다. 여러분 자신의 설정, 여러분의 계정 그대로입니다.

동작 방식은 이렇습니다. 두 명령 모두 .codegym/bin 폴더에 있는 작은 스크립트로, 같은 실제 Claude Code를 실행하되 서로 다른 설정 폴더를 가리키게 합니다. 저도 두 명령을 모두 씁니다. 과정 공부에는 과정용을, 나머지 일에는 제 것을 씁니다.

설치 프로그램은 여러분 개인의 Claude Code 프로필을 읽지도, 바꾸지도, 삭제하지도 않습니다. 이미 프로필이 있었다면 그대로 남습니다.

실용적인 팁 하나. 명령은 새 터미널 창에서부터 쓸 수 있습니다. 설치 직후 이미 열려 있던 창에서 claude를 입력하면 그 창은 아직 이 명령을 모릅니다. 새 창을 열면 됩니다.

5. 저희가 하지 않는 일

아마 이 글에서 가장 중요한 부분일 겁니다. 설치 프로그램은 "해를 끼치지 말라"는 원칙으로 만들어졌고, 그 원칙에서 다음과 같은 약속이 나옵니다.

이미 설치된 것은 삭제하거나 덮어쓰지 않습니다. 컴퓨터에 다른 버전의 Java, Python, Node, Git이 있다면 그대로 둡니다. 과정용 버전은 그 옆에 따로 설치됩니다.

버전 관리자는 건드리지 않습니다. nvm, pyenv, sdkman, asdf를 쓰고 있다면 설치 프로그램은 그대로 두고, 버전을 옆에 따로 설치했다는 사실을 보고서에서 알려 줍니다. 여러분의 pyenv를 망가뜨리는 건 저희가 가장 원하지 않는 일입니다.

이미 필요한 버전이 설치된 것은 다시 설치하지 않습니다. 다시 실행해도 설치된 것이 망가지지 않습니다. 설치 프로그램이 도구마다 확인하고 이미 준비된 것은 건너뜁니다.

저희가 설치하지 않은 IntelliJ IDEA는 건드리지 않습니다. JetBrains Toolbox로 설치한 IDEA가 있다면 그대로 두고, 과정용으로 별도의 IDEA를 설치한 뒤 그 사실을 알려 드립니다.

여러분이 이미 정한 동의 설정을 덮어쓰지 않습니다. IDEA 라이선스에 이미 동의했거나 사용 통계 수집을 설정해 두었다면, 그 설정은 여러분이 정한 그대로 남습니다.

자동 시작, 서비스, 시스템 정책에는 손대지 않습니다. 설치 프로그램은 자동 시작에 자신을 등록하지 않고, 서비스나 예약 작업을 만들지 않으며, 인증서를 설치하지 않고, 방화벽, hosts, DNS를 건드리지 않습니다.

AI 에이전트의 권한을 넓히지 않습니다. 학습 프로필은 Claude Code의 제한을 하나도 풀지 않습니다. 에이전트는 평소와 같은 보안 설정으로 동작하고, 언제나처럼 허락을 구합니다.

6. 어떤 데이터를 수집하나

여러분의 개인 키

내려받을 때 여러분의 계정에 연결된 개인 액세스 키가 압축 파일에 기록됩니다. CodeGym 플러그인과 Claude Code는 이 키로 알아서 계정에 로그인하기 때문에 키를 직접 입력할 필요가 없습니다. 키는 로그에 남지 않습니다. 비밀번호를 가리는 바로 그 필터가 키도 가립니다. 그리고 바로 이 키 때문에 압축 파일을 다른 사람에게 넘기면 안 됩니다.

설치 로그

설치하는 동안 자세한 로그가 기록됩니다. 어떤 단계가 실행됐는지, 컴퓨터에 이미 무엇이 있었는지, 무엇이 성공했고 무엇이 실패했는지. 이 로그는 여러분의 디스크에 남습니다. 어디로도 전송되지 않습니다.

문제가 생기면 보낼지 말지는 여러분이 정하고, 보낸다면 직접 보내게 됩니다. 로그 위치는 Windows에서는 임시 폴더(%TEMP%\codegym-install.log), macOS와 Linux에서는 설치 프로그램 바로 옆의 install.log 파일입니다.

비밀번호와 키는 로그에 들어가지 않습니다. 기록하기 전에 모든 줄이 필터를 거치고, 필터가 토큰과 비밀번호를 [SECRET] 표시로 바꿉니다. 여러분의 설정 파일 내용도 기록되지 않고, 설정 항목 이름만 남습니다.

언젠가 오류 보고서 자동 전송 기능이 생긴다면 미리 알려 드리고, 끌 수 있는 방법도 함께 제공하겠습니다.

학습 세션 로그

이건 별개의 이야기이고, 솔직하게 말씀드려야 할 부분입니다.

Claude Code 학습 프로필에는 작업 기록 기능이 설정되어 있습니다. 과정의 과제를 풀 때 프로젝트 폴더에 .codegym/cc-transcript.txt 파일이 만들어지고, 작업 흐름이 기록됩니다. 여러분이 에이전트에게 보낸 요청, 에이전트 응답의 앞부분, 에이전트가 수정한 파일, 실행한 명령.

왜 필요한가: 플랫폼은 이 로그로 과제 풀이를 검사합니다. 여러분의 "풀이 노트"인 셈입니다. 결과뿐 아니라 거기까지 어떻게 왔는지가 보입니다. 좀 꺼림칙하게 들린다는 거, 압니다. 하지만 로그가 없으면 플랫폼은 마지막에 나온 결과밖에 볼 수 없습니다.

알아 두어야 할 점:

로그는 여러분의 프로젝트 폴더에 있고, 직접 열어서 읽어 볼 수 있습니다.
로그는 스스로 어디로도 전송되지 않습니다 - 로그를 기록하는 파일에는 인터넷에 접속하는 코드가 한 줄도 없습니다.
로그 안의 비밀번호와 키는 설치 로그와 똑같이 가려집니다.
로그는 학습 프로필에서만 기록됩니다. claude-native로 실행하면 로그가 남지 않습니다.

AI 작업은 어느 서버를 거치나

숨기기보다 솔직하게 밝히는 게 더 중요한 사실이 하나 더 있습니다.

과정에서 쓰는 AI 이용료는 CodeGym이 부담하고, AI 접속은 저희 서버 llm.codegym.cc를 거칩니다. 즉, 모델에 보내는 요청과 모델의 응답이 물리적으로 CodeGym 인프라를 통과합니다.

학생에게 무료로 제공되는 접속은 이런 구조로 되어 있습니다. 여러분 개인 계정으로 직접 작업해야 한다면, 바로 그럴 때 쓰시라고 claude-native 명령이 있습니다.

7. 확인하는 방법과 되돌리는 방법

이 글의 말을 그대로 믿으실 필요는 없습니다. 설치 프로그램에는 미리 살펴보고 나중에 되돌릴 수 있는 모드가 있습니다.

아무것도 설치하지 않고 살펴보기

--dry-run 플래그(Windows에서는 -DryRun)는 설치 프로그램을 "보여 주기만 하는" 모드로 실행합니다. 어떤 파일을 내려받고, 어디에 두고, PATH에 무엇을 추가할지 등 실제로 할 일의 전체 목록을 출력한 뒤, 아무것도 설치하지 않고 종료합니다.

솔직히 말씀드리면, 이 모드가 "아무것도 건드리지 않는다"고 하기는 어렵습니다. 이전 실행의 로그 파일을 덮어쓰고, 작업용 폴더를 만들고, 오래된 백업을 정리합니다. 다만 프로그램은 하나도 설치되지 않고, 설정과 PATH도 바뀌지 않습니다.

PATH를 건드리지 않기

--minimal 플래그(Windows에서는 -Minimal)는 프로그램은 모두 설치하지만 시스템 설정에 경로를 등록하지 않습니다. 대신 여러분이 직접 추가할 줄을 출력합니다. 환경을 자기 방식대로 맞춰 둔 분들을 위한 모드입니다(필요한지 잘 모르겠다면, 필요 없는 겁니다).

Windows에서는 이 모드가 아직 완전히 동작하지 않습니다. 과정 명령의 경로가 사용자 PATH에 여전히 추가됩니다. 되돌릴 수 있는 변경이긴 하지만, 지금은 플래그가 약속한 대로 딱 맞게 동작하지는 않습니다. 알고 있고, 고치겠습니다.

변경 사항 되돌리기

--rollback 플래그(Windows에서는 -Rollback)는 설치 프로그램이 바꾼 설정을 되돌립니다. PATH, 셸 프로필 파일, 구성 파일, 레지스트리 항목. 모든 변경은 변경 기록에 남고, 롤백은 정확히 그 기록에 따라 진행됩니다.

추가 안전장치도 있습니다. 설치 후에 여러분이 파일을 수정했다면 롤백은 그 파일을 건드리지 않습니다. 대신 그 사실을 알리고 백업이 어디 있는지 보여 줍니다.

롤백이 하지 않는 일: 설치된 프로그램은 삭제하지 않습니다. IntelliJ IDEA, Java, Node 등은 그대로 남습니다. 대신 설치 프로그램이 그 목록을 바로 쓸 수 있는 삭제 명령과 함께 출력하고, 무엇을 지울지는 여러분이 정합니다.

솔직하게 밝혀 둘 점이 하나 더 있습니다. Windows에서 Java, Node, Python 설치 프로그램은 저희 변경 기록을 거치지 않고 자기 경로를 직접 등록합니다. 이 항목들은 롤백으로 되돌릴 수 없습니다.

Windows에서는 설치가 끝날 때 설치 프로그램이 롤백 명령을 그대로 출력해 줍니다. 실행 방법은 다음과 같습니다.

PowerShell을 관리자 권한으로 엽니다. PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 "관리자 권한으로 실행"을 선택합니다.
설치 프로그램 폴더로 이동합니다.
다음 명령을 실행합니다.

powershell -NoProfile -ExecutionPolicy Bypass -File .\resources\Windows_install.ps1 -Rollback

무엇을 했는지 확인하기

작업이 끝나면 설치 프로그램이 보고서를 출력합니다. 단계 목록이 나오고, 단계마다 상태가 붙습니다. 완료, 건너뜀, 경고, 오류, 또는 "직접 해야 함". 실패를 숨기지 않습니다. 무언가 설치되지 않았다면 그 사실과 원인이 그대로 적힙니다.

설치 프로그램이 스스로 하지 못한 일은 모두 "직접 마무리하기"라는 별도 블록에 구체적인 명령과 함께 모입니다.

8. 직접 해야 하는 일

애초에 자동화할 수 없는 일도 있습니다.

Handy 권한. 처음 실행할 때 시스템이 마이크 접근 권한을 묻습니다(macOS에서는 "손쉬운 사용" 권한도). 이 권한이 없으면 음성 입력이 동작하지 않습니다. 권한은 사람만 줄 수 있습니다. 어떤 프로그램도 여러분 대신 해 줄 수 없습니다.

처음 실행할 때 나타날 수 있는 IntelliJ IDEA 창. 설치 프로그램이 라이선스에 미리 동의해 두지만, 그래도 라이선스 창이 뜨면 동의해 주세요.

9. 자주 묻는 질문

설치에 시간이 얼마나 걸리나요?

20-40분이고, 약 1GB를 내려받습니다. 시간은 대부분 IntelliJ IDEA와 음성 인식 모델에 들어갑니다.

관리자 권한은 왜 필요한가요?

프로그램이 시스템 폴더(Program Files, /opt, /Applications)에 설치되는데, 관리자 권한 없이는 그곳에 쓸 수 없습니다. 반면 설정과 프로필은 여러분의 사용자 폴더에 저장되고, 여러분의 것으로 남습니다.

설치 프로그램을 두 번 실행해도 되나요?

됩니다. 아무것도 망가지지 않습니다. 이미 설치된 것은 건너뜁니다. 실수로 두 번 실행하는 것도 막아 두었습니다. 두 번째 인스턴스는 설치가 이미 진행 중인 것을 확인하고 그냥 종료됩니다.

제 Claude Code 설정은 어떻게 되나요?

아무 일도 일어나지 않습니다. 학습 프로필은 별도 폴더에 있고, 여러분 개인 프로필은 읽지도 바꾸지도 않습니다. 개인 작업에는 claude-native 명령을 쓰시면 됩니다.

실행할 때 시스템이 경고를 표시합니다. 정상인가요?

네. 운영체제는 인터넷에서 내려받은 프로그램이면 무엇이든 이렇게 맞이합니다. 저희 설치 프로그램에는 아직 코드 서명 인증서가 없습니다. Windows에서는 "추가 정보"를 누른 다음 "실행"을 누르세요. macOS에서 개발자를 확인할 수 없다는 메시지가 나오면, 파일을 마우스 오른쪽 버튼으로 클릭해 "열기"를 선택하고 한 번 더 확인하세요.

설치 프로그램이 파일에서 "인터넷에서 다운로드됨" 표시를 지웁니다. 왜 그런가요?

그렇게 하지 않으면 시스템이 포함된 파일의 실행을 막아서 설치가 중간에 끊깁니다. Windows에서는 압축을 푼 폴더에서 이 표시를 지우고, macOS에서는 같은 폴더의 Gatekeeper 격리를 해제합니다. 표시는 설치 프로그램 자체의 파일에서만 지우며, 여러분의 다른 파일에는 손대지 않습니다.

압축 파일을 다른 사람에게 넘기면 안 되는 이유는?

안에 여러분의 개인 로그인 정보가 들어 있습니다. 압축 파일을 받은 사람은 여러분의 계정으로 작업할 수 있게 됩니다. 다운로드 링크는 공유해도 괜찮습니다. 링크를 쓰면 사람마다 각자의 압축 파일을 받습니다.

문제가 생겼습니다. 어떻게 해야 하나요?

마지막에 나온 보고서와 install.log 파일을 확인하세요. 어느 단계에서 왜 실패했는지 나와 있습니다. 그래도 잘 모르겠다면 이 파일을 고객 지원팀에 보내 주세요. 최후의 수단이 아니라 평범한 절차입니다.

10. 한 번에 다 설치하고 싶지 않다면

설치 프로그램은 과정의 필수 단계가 아니라, 시간을 아끼는 방법입니다. 설치 프로그램이 하는 일은 전부 강의에서 단계별로 다룹니다. Claude Code는 명령 하나로 설치되고, 설정은 파일 하나를 복사하면 끝입니다.

나머지 도구는 필요해질 때마다 하나씩 추가하면 됩니다. 필요한 시점이 오면 왜 필요한지도 이해하게 될 겁니다. 열 줄짜리 목록으로 한꺼번에 외우는 것보다 그렇게 하는 편이 기억에도 잘 남습니다.