처음 만나는 AI와 Claude Code

부록. 첫 작업의 명령과 점검표

부록. 첫 작업의 명령과 점검표

이 부록은 실습 중 막혔을 때 찾아보는 짧은 참고 페이지입니다. 명령은 터미널에 입력합니다. Claude Code 대화창에는 자연어 요청을 입력합니다. 둘을 혼동하면 명령이 실행되지 않거나 요청이 전달되지 않습니다.

터미널에서 쓰는 명령

• claude --version: 설치를 확인합니다. 버전 번호가 나오면 실행 파일을 찾은 것입니다.

• cd ~: 자신의 홈 폴더로 이동합니다.

• mkdir reading-club-practice: 연습용 폴더를 만듭니다.

• cd reading-club-practice: 그 폴더로 이동합니다.

• pwd: 현재 폴더의 경로를 확인합니다.

• ls: 현재 폴더의 파일 이름을 확인합니다.

• claude: 현재 폴더에서 대화를 시작합니다.

• claude -c: 현재 폴더의 최근 대화를 이어 갑니다.

• claude -p "질문": 한 번 답을 받고 종료합니다. 이 책의 실습에는 필요하지 않지만 명령 목록에서 만나게 됩니다.

운영체제나 터미널 설정에 따라 폴더 경로를 표시하는 방식은 다릅니다. claude의 인수와 명령은 공식 CLI 참조에서 확인합니다.

대화창에 넣는 요청 네 가지

1. 탐색: “지금 어느 폴더에서 작업 중이야? 파일을 알려줘. 아직 바꾸지 마.”

2. 생성: “이 폴더에 ‘동네 책모임’ 안내 페이지 index.html을 만들어 줘. 모르는 시간·장소·신청 방법은 ‘추후 안내’로 표시해.”

3. 동작 추가: “책 제목과 나눌 질문을 저장하고 새로고침 후에도 볼 수 있는 준비 카드를 index.html에 추가해 줘. 외부 전송은 하지 마.”

4. 확인: “어떤 파일을 바꿨고 실제로 무엇을 확인했어? 내가 브라우저에서 확인할 항목도 알려줘.”

5. 확장: “두 번째 카드를 저장해도 첫 카드가 남고 각 카드를 고칠 수 있게 해 줘. 이미지 첨부도 선택적으로 추가해 줘.”

본문에는 각 요청에 필요한 맥락과 조건이 더 들어 있습니다. 이 부록의 문장은 핵심만 기억하기 위한 축약형입니다.

완료 점검표

• Claude Code가 reading-club-practice 폴더에서 시작되었습니다.

• 그 폴더에 index.html 파일이 있습니다.

• 파일을 브라우저에서 열 수 있습니다.

• ‘동네 책모임’과 처음 오는 사람을 위한 안내가 보입니다.

• 알 수 없는 시간·장소·신청 방법을 지어내지 않았습니다.

• 책 제목과 질문을 저장하면 준비 카드에 보이고, 새로고침 후에도 남습니다.

• 빈 입력은 저장되지 않고, 삭제 후 새로고침해도 카드가 돌아오지 않습니다.

• 두 장 이상을 저장하고 한 장을 수정·삭제해도 다른 카드가 남습니다.

• 선택한 이미지가 새로고침 후에도 보이고, 이미지만 제거할 수 있습니다.

• 준비 카드는 신청이나 서버 전송이 아닌 이 브라우저의 개인 메모임을 구분합니다.

• Claude Code의 완료 보고와 내가 직접 확인한 내용을 구분할 수 있습니다.

• 책의 예시와 모양이 달라도 요청한 사실·조건·확인 기준을 충족하는지 판단할 수 있습니다.

막힌 항목이 있다면 해당 장으로 돌아가 그 단계만 다시 해 봅니다. 설치가 막혔다면 1장, 파일이 없다면 2장, 수정이 보이지 않는다면 3장을 참고하면 됩니다.

선택 확장 실습을 했다면 실제 .xlsx 파일을 내보낸 뒤 다시 가져와 글과 이미지가 보존되는지도 확인합니다. 잘못된 파일을 가져와도 기존 카드는 사라지지 않아야 합니다.

참고 링크

• https://code.claude.com/docs/en/cli-reference