AX Lab — 개발 환경 자동 설치
==================================================

이 압축 파일에는 아래가 들어 있습니다.

  ax-lab-1-install.bat        Windows 1단계 — Git / Node.js / VS Code / GitHub CLI
  ax-lab-2-claude-code.bat    Windows 2단계 — Claude Code
  ax-lab-3-check.bat          Windows 3단계 — 확인
  ax-lab-macos.command        macOS — 확인 + 빠진 것 안내
  README-KR.txt                 이 파일


Windows — 이 순서대로 하세요
--------------------------------------------------

  1) ax-lab-1-install.bat 을 두 번 누릅니다.
     관리자 권한을 묻는 창이 뜨면 [예]를 누르세요.

  2) 설치가 끝나면 그 창을 반드시 닫습니다.

  3) ax-lab-2-claude-code.bat 을 두 번 누릅니다.

  4) 그 창도 닫고, ax-lab-3-check.bat 을 두 번 눌러 확인합니다.


창을 닫으라고 하는 이유
--------------------------------------------------

프로그램이 설치되면 시스템은 "이 프로그램은 여기 있다"는 경로 정보를
새로 기록합니다. 그런데 이미 열려 있는 창은 그 정보를 다시 읽지 않습니다.

그래서 설치한 창에서 바로 확인하면, 멀쩡히 설치된 도구도 없다고 나옵니다.
창을 닫고 새로 열면 해결됩니다. 단계를 파일로 나눈 이유가 이것입니다.


실행하기 전에 열어보시기를 권합니다
--------------------------------------------------

.bat 파일을 마우스 오른쪽 버튼으로 누르고 [편집] 또는
[연결 프로그램] → [메모장] 을 선택하면 안에 무엇이 들어 있는지 그대로 보입니다.

1단계 파일이 실제로 실행하는 명령은 이 네 줄이 전부입니다.

  winget install -e --id Git.Git
  winget install -e --id OpenJS.NodeJS.LTS
  winget install -e --id Microsoft.VisualStudioCode
  winget install -e --id GitHub.cli

2단계는 이 한 줄입니다.

  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd

Anthropic 공식 설치 방식입니다. Node.js 가 없어도 설치되고, 이후
업데이트도 알아서 됩니다. 설치 위치는 다음과 같습니다.

  %USERPROFILE%\.local\bin\claude.exe

이건 이 책의 스크립트에만 해당하는 이야기가 아닙니다. 인터넷에서 받은
실행 파일을 열어보지 않고 돌리는 습관은 언젠가 값비싼 대가를 치릅니다.
AI 에게 코드를 맡기는 사람일수록 이 습관은 더 중요해집니다.

스크립트를 쓰지 않고 위 명령을 PowerShell 에 직접 붙여 넣어도 결과는 같습니다.
그 편이 무슨 일이 벌어지는지 더 잘 보입니다.


winget 이 없다고 나오면
--------------------------------------------------

Microsoft Store 에서 "앱 설치 관리자"를 설치하거나 업데이트한 뒤
다시 실행하세요. 또는 아래에서 직접 받아 설치해도 됩니다.

  Git        https://git-scm.com/downloads/win
  Node.js    https://nodejs.org
  VS Code    https://code.visualstudio.com/download
  GitHub CLI https://cli.github.com


macOS
--------------------------------------------------

맥에는 설치 스크립트를 따로 두지 않았습니다. 자동화로 줄어드는 수고가
윈도우보다 훨씬 적기 때문입니다. Git 은 대부분의 맥에 이미 들어 있고,
VS Code 는 받은 앱을 응용 프로그램 폴더로 끌어다 놓으면 끝납니다.

대신 ax-lab-macos.command 는 무엇이 있고 무엇이 없는지 확인해주고,
빠진 것의 설치 방법을 알려줍니다. Claude Code 는
그 자리에서 설치할 수 있습니다.
Node.js 가 없어도 됩니다 — Windows 와 마찬가지입니다.

  실행 방법: 파일을 마우스 오른쪽 버튼으로 누르고 [열기] 를 선택하세요.
  (두 번 누르면 확인되지 않은 개발자라는 경고가 뜰 수 있습니다)

  처음에 권한 오류가 나면 터미널에서 한 번만:
    chmod +x ax-lab-macos.command

Homebrew 를 이미 쓰고 있다면 아래 두 줄로 대신할 수 있습니다.

  brew install --cask visual-studio-code
  brew install gh

단, Node.js 는 Homebrew 로 설치하지 마세요. brew 의 node 는 LTS 가 아니라
최신 버전을 설치합니다. nodejs.org 에서 LTS 를 받는 편이 안전합니다.
