클로드 코드 CLI와 친해지는 첫 걸음

claude.ai vs 클로드 CLI — 같은 부탁 시켜보기

같은 일을 웹(claude.ai)과 CLI(클로드 코드)에 각각 시켜보고, 무엇이 다른지 직접 느껴보세요.

데스크탑에 test 폴더 만들어줘.

→ 웹은 직접 폴더를 못 만들고 "이렇게 만드세요" 하고 방법만 알려줍니다.

데스크탑에 test 폴더 만들어줘.

→ CLI는 실제로 내 컴퓨터에 test 폴더를 만들어 줍니다. (실행 전 허락을 물으면 → 허용)

💡 웹 AI = 말로 답하는 상담원 · CLI AI = 내 컴퓨터에서 직접 일하는 비서

내 컴퓨터 사양·정보 확인하기

클로드를 설치하거나 문제를 물어볼 때, 내 컴퓨터가 맥인지 윈도우인지·사양이 어떤지 알아야 합니다. 아래 명령을 맥은 터미널, 윈도우는 PowerShell에 붙여넣어 확인하세요.

system_profiler SPHardwareDataType SPSoftwareDataType

systeminfo

💡 확인한 사양 화면을 캡처해 두면, 다음 단계(설치 질문)에서 그대로 첨부할 수 있어요.

화면 캡처(스크린샷) 단축키

에러 화면이나 내 컴퓨터 정보를 클로드에게 보여줄 때 스크린샷이 가장 정확합니다. 손으로 옮겨 적지 말고 화면을 그대로 캡처하세요.

스크린샷을 claude.ai에 첨부해 '자동 업데이트되는 전역 설치 명령어' 받기

내 컴퓨터 정보(사양) 스크린샷을 claude.ai 채팅에 첨부하고, 아래 프롬프트를 그대로 붙여넣어 물어보세요. 자동으로 업데이트까지 되는 버전으로, 내 환경에 맞는 설치 명령을 하나씩 복사할 수 있게 알려줍니다. (윈도우는 WSL로 설치하지 않는 방식으로 받습니다.)

여기에 클로드 코드 CLI를, 전체적으로 자동으로 업데이트까지 되는 버전으로 전역 설치하는 방법(명령어)을 알려줘. 윈도우의 경우 WSL로 설치하지 않을 거야. 공식문서를 확인해서, 나는 초보자니까 초등학생도 이해할 정도로 쉽게 알려주고, 명령어를 복사하여 하나씩 붙여넣을 수 있게 단계별로 알려줘.

💡 설치 명령은 슬라이드 9(맥)·10(윈도우)에도 그대로 정리되어 있어요. 둘 중 내 컴퓨터에 맞는 것을 쓰면 됩니다. (공식 설치 방식은 모두 자동 업데이트를 지원하며, 윈도우도 WSL 없이 PowerShell로 설치합니다.)

설치했는데 오류가 날 때 — 경로(PATH) 문제 해결

설치 후 claude 를 입력했는데 "command not found" 같은 오류가 나면, 대부분 경로(PATH) 문제입니다. 오류 문구를 캡처하거나 복사해서 claude.ai에 붙여넣고, 아래 프롬프트로 정확한 한 줄 해결책을 받으세요.

아래는 내가 클로드 코드를 설치한 뒤 터미널에 뜬 오류야. (여기에 오류 문구 또는 스크린샷 붙여넣기) 나는 [맥 / 윈도우] 사용자야. 이 경로(PATH) 문제를 해결하는 명령어를 알려줘. 가능하면 터미널에 한 번 붙여넣어 끝낼 수 있게 정확한 한 줄로 알려주고, 왜 그런지는 한 줄로만 설명해줘.

💡 맥은 보통 슬라이드 9의 source ~/.zshrc 한 줄이면 해결됩니다. 그래도 안 되면 위 프롬프트로 물어보세요.

첫 대화 예시 — 복사해서 그대로 써보기

위 슬라이드의 예시들을 한 줄씩 복사해 클로드 프롬프트(>)에 붙여넣어 보세요.

이 문단을 초등학생도 알게 쉽게 요약해줘: (여기에 판결문·기사 붙여넣기)

이 폴더에 있는 파일들 목록을 정리해줘

바탕화면의 메모.txt 를 읽고 핵심만 3줄로 알려줘

방금 이 화면 스크린샷인데, 무슨 에러인지 설명해줘

/help

오늘 나눈 대화를 정리해서 회의록.md 파일로 만들어줘

파일·폴더를 클로드 CLI에 넣는 법 (드래그앤드롭 / 경로 복사)

클로드에게 특정 파일·폴더를 맡길 때, 터미널 창으로 끌어다 놓으면 경로가 자동으로 입력됩니다.

방법 ① 드래그앤드롭 — 파일/폴더를 클로드가 실행 중인 터미널 창 안으로 끌어다 놓기 → 경로가 자동 입력 → 앞에 부탁을 붙여 전송

방법 ② 드래그앤드롭이 안 될 때 — 경로 복사

• 🍎 Mac: 파일 우클릭 → ⌥ Option 누르기 → "(파일명) 경로 복사" 클릭
• ⊞ Windows: 파일 Shift + 우클릭 → "경로로 복사" 클릭

→ 복사한 경로를 클로드 프롬프트에 붙여넣기

이 파일을 읽고 핵심만 3줄로 정리해줘: (여기에 복사한 경로 붙여넣기)

마음가짐 — 궁금하면 무조건 클로드에게 물어본다

모르는 것은 혼자 끙끙대지 말고 바로 클로드에게 물어보세요.

• 클로드 CLI 설치 전 → claude.ai(웹·앱)에게 물어보기
• 클로드 CLI 설치 후 → 클로드 CLI에게 물어보기
• 에러가 나면 → 손으로 옮겨 적지 말고 스크린샷·복사 그대로 붙여넣기
• 뭐든지 클로드를 활용해 해결하기

나는 컴퓨터 초보자야. 지금 (상황 설명 또는 에러 붙여넣기). 초등학생도 이해할 만큼 쉽게, 따라 할 수 있게 한 단계씩 알려줘.

.md 파일과 .json 파일이란?

💡 한마디로: .md = 사람이 읽는 메모 · .json = 프로그램이 읽는 설정/데이터

내 데스크탑에 example.md 와 example.json 파일을 각각 하나씩 예시 내용으로 만들어줘. 그리고 둘의 차이를 초보자가 이해하기 쉽게 설명해줘.

원하는 폴더에서 터미널 여는 법

CLAUDE.md(다음 슬라이드)는 "그 파일이 있는 폴더에서 claude를 실행"해야 적용됩니다. 그래서 특정 폴더에서 터미널 여는 법을 알아둬야 합니다.

pwd

CLAUDE.md 만들기 실습 — 자체 명령어 & 자연어

CLAUDE.md를 만드는 두 가지 방법입니다. 둘 다 클로드 CLI 안에서 합니다.

/init

이 폴더에 CLAUDE.md 파일을 만들어줘. 내용: 1) 항상 존댓말로 답하기 2) 내 직업은 (직업 입력) 3) 추측한 내용은 추측이라고 분명히 밝히기

방금 만든 CLAUDE.md 규칙을 잘 기억하고 있는지, 한 줄로 다시 말해줘.

전역 CLAUDE.md vs 폴더별 CLAUDE.md

이 내용을 전역 CLAUDE.md(~/.claude/CLAUDE.md)에 추가해줘: (항상 적용할 규칙 입력)

지금 이 폴더에만 적용되는 CLAUDE.md를 만들어줘: (이 폴더 전용 규칙 입력)

💡 우선순위: 둘 다 있으면 폴더별 규칙이 전역 규칙보다 우선 적용됩니다.

공통자료실 '옵시디언에 기억장치 붙이기' 자료로 설정하기

공통자료실에서 「옵시디언에 기억장치 붙이기」 파일을 내려받은 뒤, 클로드 CLI 창으로 드래그앤드롭(또는 경로 복사)해서 첨부하고, 아래 프롬프트를 순서대로 입력하세요.

방금 첨부한 문서를 읽고, 여기에 적힌 그대로 내 옵시디언에 '기억장치'를 설정해줘. 나는 초보자니까 중간중간 무엇을 하는지 쉽게 설명하면서 진행해줘.

이제 같은 문서에 있는 '파라메모법'까지 이어서 설정해줘. 내가 직접 해야 하는 부분이 있으면 초등학생도 이해하기 쉽게 알려줘.

'파라메모법'에 대해 인터넷에서 조사해서, 초보자용 가이드 문서로 정리해 옵시디언 볼트에 .md 파일로 저장해줘. 출처도 함께 적어줘.

공통자료실 '클로드 채널스로 텔레그램 봇 연결하기' 자료로 설정하기

공통자료실에서 「클로드 채널스 사용하여 텔레그램 봇 연결하기」 파일을 내려받아 클로드 CLI에 첨부한 뒤, 아래 프롬프트를 입력하세요.

방금 첨부한 문서를 읽고, 여기에 적힌 그대로 클로드 채널스로 내 텔레그램 봇을 연결(설정)해줘. 진행하면서 지금 무엇을 하는지 쉽게 설명해줘.

이 설정 중에서 내가 직접 손으로 해야 하는 부분(예: 텔레그램 앱에서 누르기, 토큰 복사 등)만 따로 모아서, 초등학생도 이해하기 쉽게 순서대로 알려줘.

휴대폰에서 봇에게 — 복사해서 그대로 보내보기

연동되면 휴대폰 텔레그램에서 한국어로 그냥 보내면 됩니다. 위 슬라이드의 예시를 한 줄씩 복사해 보내보세요. (사진·파일도 함께 전송 가능)

오늘 전주 날씨 알려줘

이 폴더의 회의록.docx 읽고 핵심 결정만 표로 정리해줘

오늘 일정 정리해줘

환자 안내문 초안을 더 쉽게 다듬어줘

가정통신문을 학부모가 읽기 쉽게 고쳐줘

이 문서 속 글자를 텍스트로 추출해줘

✅ ⑦ 권한 승인: 봇이 작업 허락을 물으면, 그 메시지에 적힌 "yes 코드"를 그대로 답장하면 됩니다. (고정된 명령어가 아니라, 그때그때 봇이 알려주는 코드를 보내는 거예요.)

마무리 습관 — "니가 해!"

클로드 CLI가 "이렇게 하세요", "○○를 하세요" 하고 나에게 일을 시키려 하면, 망설이지 말고 클로드에게 다시 시키세요. 클로드는 내 컴퓨터에서 직접 일하는 비서입니다.

니가 해.

니가 절대 하지 못하는 것을 제외하고는, 니가 다 해.

언제 쓰나요?

• "터미널에 이 명령어를 입력하세요" → 니가 해.
• "이 파일을 이렇게 수정하세요" → 니가 해.
• "폴더를 만들고 옮기세요" → 니가 해.

💡 클로드가 직접 할 수 없는 일(예: 휴대폰에서 버튼 누르기, 외부 사이트 로그인)만 내가 하고, 나머지는 모두 클로드에게 맡기세요.