설치와 첫 세션

Claude Code는 파일을 직접 열고 고치는 도구입니다. 같은 엔진을 세 창구에서 쓸 수 있다 보니, 막상 설치하려 하면 어디서부터 시작할지 막막해집니다. 답은 셋을 다 아는 것이 아니라 지금 하는 일에 맞는 하나를 고르는 것입니다.

일에 맞는 창구를 고르는 기준은 단순합니다. 터미널을 쓰면 CLI, 코드 편집기를 쓰면 VS Code 확장, 둘 다 낯설면 Desktop 앱입니다. 디자이너라면 시안 폴더를 열어 둔 VS Code에서 확장으로 바로 붙이는 편이 손에 익습니다. 기획자와 마케터는 터미널 없이 시작할 수 있는 Desktop 앱이나 VS Code 확장이 진입 장벽이 낮고, 반복 작업을 자동화까지 이어 붙이려는 경우에만 CLI로 넘어갑니다.

처음이라면 지금 하는 일에 가장 가까운 하나만 고릅니다. 셋을 다 깔 필요는 없고, 나중에 다른 창구가 필요해지면 그때 더합니다. 다만 Claude Code는 무료 claude.ai 플랜에서는 열리지 않습니다. Pro 이상 구독이나 Console 계정으로 로그인해야 하며, 회사 계정으로 팀 안에서 쓴다면 Team·Enterprise 구독 여부를 먼저 확인합니다.

설치 창구 세 개를 전부 까는 것은 안티패턴입니다. 계정 로그인 상태와 접근 권한을 창구마다 따로 확인해야 해서 관리 부담만 늘어납니다. 하나로 시작해 실제로 부족할 때 다음 창구를 더하는 편이 낫습니다.

설치 명령은 위 단계에 정리해 두었습니다. 설치를 마쳤다면 아래 실습으로 Claude Code가 이 폴더를 얼마나 볼 수 있는지 바로 확인해 보세요.

새 세션을 열면 Claude Code는 작업 폴더를 확인하고 요청을 기다립니다. 파일을 새로 만들거나 고치기 전에는 승인을 묻는 것이 기본 동작이라, 무엇이 바뀌는지 먼저 보고 결정할 수 있습니다.

권한 모드는 Shift+Tab으로 순환합니다. 기본값은 default 모드(화면 표시자에는 Manual로 나타납니다)이고, 변경마다 승인을 묻습니다. acceptEdits 모드는 승인을 건너뛰고 바로 적용하고, plan 모드는 계획만 먼저 받아 실행은 승인 후로 미룹니다.

마케터라면 캠페인 카피 초안 파일 하나를 만들어 달라고 요청해 보는 것이 첫 세션으로 적당합니다. 승인 창에 뜬 파일명과 변경 요약을 읽고 나서 승인하면, 무엇이 어디에 만들어지는지 감이 잡힙니다.

acceptEdits로 바꿔 둔 채 다른 작업으로 넘어가는 것은 안티패턴입니다. 이후 요청까지 확인 없이 적용되어 의도치 않은 변경이 쌓입니다. 세션을 마칠 때는 모드를 default로 되돌려 둡니다.

진행 중인 응답이나 도구 호출을 멈추려면 Esc를 누릅니다. 입력창이 비어 있는 상태에서 Esc를 두 번 누르면 rewind 메뉴(체크포인트 복원)가 열려 이전 상태로 되돌릴 수 있습니다.

승인과 되돌리기 흐름은 말보다 한 번 겪어보는 편이 빠릅니다. 아래 실습을 그대로 붙여넣어 첫 승인 창을 직접 봐 보세요.