1장. 시작하기 - 설치부터 첫 대화까지

이 장의 목표

특정 설치 명령을 외우지 않고, 사용 중인 운영체제·계정·조직 정책에 맞는 공식 안내를 찾아 첫 작업을 검토 가능한 범위에서 수행한다.

시작 순서

1. Claude Code의 현재 공식 설치 문서에서 운영체제별 요구사항과 설치 방법을 확인한다.
2. 개인 계정·조직 계정·API 기반 인증 중 승인된 방식을 선택한다.
3. 고객 정보나 비밀값이 없는 테스트 저장소에서 실행한다.
4. 먼저 파일 목록, 프로젝트 지침, 테스트 방법을 읽게 한다.
5. 한 파일의 문구 수정처럼 되돌릴 수 있는 작은 변경을 요청한다.
6. 변경 내용과 테스트 결과를 사람이 검토한 뒤 커밋·배포 여부를 결정한다.

설치 명령, 인증 메뉴, 지원 환경은 자주 바뀐다. 이 강의에 복사된 과거 npm·brew 명령이나 토큰 설정을 사용하지 말고, 실행 직전에 공식 문서를 확인한다.

첫 요청 예시

이 저장소에서 먼저 다음만 확인해 주세요.

1. 프로젝트 지침 파일과 테스트 방법
2. 수정이 필요한 파일 후보
3. 변경 전에 확인해야 할 사실과 위험

파일을 바꾸거나 외부 동작을 실행하지 말고,
확인한 근거와 작은 작업 계획만 보여 주세요.

안전 기준

해도 되는 일	먼저 확인할 일
공개 코드 구조 설명	비공개 코드·고객 데이터의 사용 권한
문서 초안과 테스트 제안	실제 파일 변경과 테스트 실행 범위
읽기 전용 도구 연결	쓰기·발송·배포 권한과 승인자

API 키, 비밀번호, 세션 토큰은 대화·코드·스크린샷에 붙이지 않는다. 오류가 나더라도 민감 정보를 가린 메시지와 공식 문서로 원인을 좁힌다.