AI 서재
책으로 읽는 AI서재
한 권을 고르고, 목차에서 차례대로 읽을 수 있게 정리했습니다.
PDF 다운로드 책
다국어로 읽는 대학생 교양 인공지능
한국어 원문과 외국어 번역을 함께 실은 유학생용 교재입니다. 각 책 소개 페이지에서 PDF를 받을 수 있습니다.
[AI서재] 5장 개발 환경을 겁내지 않는 법
클로드 코드 완전정복
5장 개발 환경을 겁내지 않는 법
김경진 변호사
도입
처음 비행기 조종석 사진을 보면 압도됩니다. 수백 개의 버튼, 다이얼, 스위치, 화면이 빼곡합니다. 하지만 조종사에게 물어보면 이렇게 말합니다. "실제로 이착륙할 때 보는 계기는 여섯 개예요." VS Code도 마찬가지입니다. 화면 곳곳에 버튼과 패널이 있지만, 클로드 코드를 사용하는 데 필요한 것은 셋뿐입니다. 파일 탐색기, 클로드 코드 채팅창, 그리고 하단의 모드 선택기.
VS Code 설치부터 클로드 코드 확장 설치까지 단계별 안내
3장에서 설치 과정을 간략하게 다뤘습니다. 이 장에서는 각 단계에서 마주칠 수 있는 상황을 좀 더 세밀하게 살펴봅니다.
웹 브라우저를 열고 "Visual Studio Code"를 검색합니다. 공식 사이트에서 자신의 운영체제(윈도우, 맥, 리눅스)에 맞는 설치 파일을 내려받습니다. 다운로드가 끝나면 설치 프로그램을 실행합니다. 별다른 옵션을 건드릴 필요 없이 기본 설정으로 진행하면 됩니다.
VS Code를 처음 열면 환영 탭이 나타납니다. 새 파일 만들기, 폴더 열기, 연습 과정 안내 같은 링크가 보입니다. 이 화면은 닫아도 됩니다. 화면 왼쪽 세로 메뉴바에서 네모 네 개가 모인 아이콘(확장 메뉴)을 클릭합니다. 검색창에 "Claude Code"를 입력합니다. 앤트로픽 공식 확장이 검색 결과 상단에 나타나면, "Install" 버튼을 누릅니다.
설치가 완료되면 화면 오른쪽 상단에 앤트로픽 로고 모양의 작은 버튼이 생깁니다. 이 버튼이 클로드 코드 채팅창을 여는 입구입니다. 클릭하면 로그인을 요청합니다.
[그림 5-01: VS Code 왼쪽 확장 메뉴에서 Claude Code를 검색한 화면. Install 버튼이 강조 표시되어 있다.]
유료 구독 선택: Pro와 Max의 차이
클로드 코드는 앤트로픽의 유료 구독에 포함된 기능입니다. 무료 계정으로는 사용할 수 없습니다.
프로(Pro) 플랜은 월 17달러(한화 약 2만 3천 원)입니다. 클로드 코드와 오퍼스(Opus) 모델이 포함됩니다. 처음 시작하기에 충분합니다. 다만 일일 사용량에 제한이 있어서, 여러 워크플로우를 연이어 구축하거나 긴 대화를 이어가면 한도에 도달할 수 있습니다.
맥스(Max) 플랜은 사용 한도가 높습니다. 여러 세션을 동시에 열어 두거나, 큰 규모의 프로젝트를 지속적으로 작업하는 사용자에게 적합합니다. 한도에 신경 쓰지 않고 작업에 집중할 수 있다는 것이 가장 큰 이점입니다.
처음에는 프로 플랜으로 시작하고, 사용량이 늘어나면 맥스로 전환하는 것을 권장합니다. API 키를 직접 사용하는 방법도 있지만, 사용량에 따라 비용이 변동하므로 예측이 어렵습니다. 고정 비용의 구독 플랜이 비용 관리 측면에서 더 안정적입니다.
프로젝트 폴더 만들기와 탐색기 패널 이해
클로드 코드는 항상 프로젝트 폴더 안에서 동작합니다. 폴더를 열지 않으면 에이전트에게 작업 공간이 없는 것과 같습니다.
왼쪽 세로 메뉴바 최상단의 서류 아이콘(탐색기)을 클릭합니다. "아직 폴더를 열지 않았습니다(You have not yet opened a folder)"라는 문구가 보입니다. "Open Folder" 버튼을 누르고, 컴퓨터에서 빈 폴더를 선택합니다. 폴더가 없다면 바탕화면이나 문서 폴더에 새 폴더를 하나 만들어 둡니다.
폴더를 열면 왼쪽 탐색기 패널에 폴더 이름이 표시됩니다. 아직 파일은 없으니 비어 있습니다. 에이전트가 작업을 시작하면, 이 영역에 파일과 하위 폴더가 실시간으로 생겨납니다. 워크플로우 파일, 도구 파일, 설정 파일, 임시 데이터 — 에이전트가 만드는 모든 것이 여기에 나타납니다. 탐색기 패널에서 파일을 클릭하면 오른쪽에 파일 내용이 열리므로, 에이전트가 무엇을 만들었는지 직접 확인할 수 있습니다.
클로드 코드 인터페이스: 왼쪽은 파일, 오른쪽은 에이전트
화면 구성을 머릿속에 확실히 그려 두면 이후의 모든 작업이 편해집니다.
왼쪽 영역은 파일의 세계입니다. 에이전트가 생성한 워크플로우, 도구, 데이터, 설정 파일이 모두 이곳에 쌓입니다. 오른쪽 영역은 에이전트의 세계입니다. 메시지를 입력하고, 에이전트의 사고 과정을 관찰하고, 질문에 답하고, 실행 결과를 확인하는 곳입니다.
VS Code에는 VS Code 자체의 AI 에이전트 기능(코파일럿(Copilot) 등)이 내장되어 있을 수 있습니다. 이것은 클로드 코드와 별개입니다. VS Code의 자체 채팅 패널이 열려 있다면 닫아 두는 것이 혼동을 줄입니다. 오른쪽 상단의 앤트로픽 로고 버튼을 눌러 열리는 패널만 사용하면 됩니다.
여러 개의 탭을 오른쪽 영역에 열어 둘 수도 있습니다. 에이전트 채팅 탭 하나, 파일 내용 탭 하나를 동시에 열어서 에이전트의 대화를 보면서 생성된 파일 내용을 확인하는 것도 가능합니다. 필요에 따라 에이전트 채팅 세션을 여러 개 동시에 실행할 수도 있습니다. 각 세션은 독립적인 대화 맥락을 가집니다.
[그림 5-02: VS Code 화면 레이아웃 안내. 왼쪽 파일 탐색기, 오른쪽 클로드 코드 채팅 패널, 하단 모드 선택기가 표시된 전체 화면.]
권한 모드: 계획, 확인, 자동 편집, 바이패스
클로드 코드 채팅창 하단에 모드 선택 메뉴가 있습니다. 에이전트에게 부여하는 자율성의 수준을 조절하는 장치입니다.
계획 모드(Plan Mode)에서 에이전트는 읽기와 조사만 수행합니다. 파일을 생성하거나 코드를 작성하지 않습니다. 계획을 세우고, 질문을 하고, 접근 방식을 제안합니다. 새로운 워크플로우를 기획할 때 가장 먼저 사용해야 하는 모드입니다.
편집 전 확인(Ask Before Edits) 모드에서는 에이전트가 파일을 생성하거나 수정하기 전에 매번 승인을 요청합니다. 변경 내용을 하나하나 검토하고 싶을 때 적합합니다.
자동 편집(Edit Automatically) 모드에서는 에이전트가 파일 수정은 자동으로 수행하되, 시스템 명령어(터미널 명령어) 실행은 승인을 요청합니다.
바이패스 권한(Bypass Permissions) 모드는 에이전트에게 전권을 위임합니다. 파일 생성, 수정, 삭제, 터미널 명령어 실행 모두를 승인 없이 수행합니다. 이 모드는 VS Code 설정에서 별도로 활성화해야 합니다.
설정(Settings)에서 "Claude Code"를 검색하고, "Allow Dangerously Skip Permissions"를 체크합니다. 이름에 "dangerously"가 포함되어 있는 이유는, 에이전트가 모든 작업을 사용자 확인 없이 진행하기 때문입니다.
권장되는 작업 흐름은 이렇습니다. 계획 모드에서 계획을 세우고, 계획이 만족스러우면 바이패스 권한 모드로 전환하여 실행합니다. 이때 에이전트가 작업하는 과정을 화면에서 지켜보면서, 방향이 어긋나면 즉시 개입합니다. 에이전트를 밤새 혼자 돌려놓고 자리를 비우는 것은 아직 권장되지 않습니다. 에이전트 곁에서 감독하되, 매 단계마다 버튼을 누르는 번거로움을 줄이는 것이 바이패스 권한 모드의 올바른 활용법입니다.
조종석의 계기판이 더 이상 두렵지 않은 순간이 옵니다. 탐색기 패널에서 파일이 생겨나는 것을 보고, 채팅창에서 에이전트의 생각을 읽고, 모드를 전환하여 자율성의 수위를 조절하는 것이 자연스러워지는 순간입니다. 그 다음에 알아야 할 것은, 에이전트가 워크플로우와 도구를 어떤 구조로 정리하는가 하는 문제입니다. 그것을 설명하는 프레임워크의 이름은 세 글자입니다.
이 책이 잠시라도 당신 곁에 머물렀다면, 다음 이야기가 세상에 나올 수 있도록 후원해 주세요.
(자발적 후원 부탁 구좌 : 농협 302-1096-0948-81 예금주 : 김경진)