3기 1차 과제 공지

AI 자율마스터 과정 3기 · 1차 과제와 2차 강의 준비사항

주최·주관 변호사 조성원 법률사무소 부설 조변의 지식연구소

보고 기한 · 2026. 7. 3. (금) 24:00까지보고 방법 · 단톡방에 한꺼번에 보고제출 방법 · 8항 보고서 템플릿 작성 후 .md 파일 업로드

1. 과제 보고 기한

⏰ 과제 보고 기한
항목 내용
보고 기한 2026. 7. 3. (금) 24:00까지
보고 방법 아래 모든 과제 및 준비사항을 이 단톡방에 한꺼번에 목록별로 보고
보고서 양식 8항의 복사용 보고서 템플릿 사용
📖 본 문서를 반드시 꼼꼼히 읽으며 그대로 따라 주세요 (매우 중요)

여러분의 귀한 시간을 들여 강의에 참여해주시고, 과제까지 해주시는 것에 먼저 깊이 감사드립니다. 그래서 더욱 간곡히 부탁드립니다.

본 문서는 "대강 훑어보는 공지사항"이 아니라, 한 줄 한 줄이 모두 필요한 이유가 있어서 작성된 실행 지침서입니다.

  • 각 과제에는 왜 해야 하는지(목적) 와 어떻게 해야 하는지(방법) 가 함께 적혀 있습니다. 목적을 이해하지 못한 채 기계적으로 따라 하시면, 과제는 완료되더라도 실제 체득은 되지 않습니다.
  • 특히 3항의 SSH·크롬 리모트 데스크탑(또는 맥 화면 공유) 원격 접속 설정 + Step 4 메인 PC 항상 켜짐 설정과 4항 다의 전원·절전 모드 주의사항은 한 단계라도 건너뛰시면 이후 모든 과제가 꼬이게 됩니다. 반드시 순서대로, 빠짐없이 진행해주세요.
  • 문서 중간중간의 경고(⚠️)·중요(⭐)·팁(💡) 박스는 건너뛰기 쉬운 부분이지만 실제로는 가장 중요한 내용이 담겨 있습니다. 반드시 모두 읽어주세요.
  • "어차피 나중에 보면 되지"라고 생각하고 미루시면, 기한이 임박해서 급하게 하려다 해결 못 할 문제가 반드시 발생합니다. 과거 1·2기 수강생분들도 동일한 어려움을 겪으셨습니다.

부탁드리는 것은 단 하나입니다. 이 문서를 처음부터 끝까지 한 번 꼼꼼히 정독해주시고, 그 후 각 항목을 순서대로 따라 주세요. 그것만 지켜주시면 과제는 반드시 완주하실 수 있고, 2차 강의에서 훨씬 풍성한 경험을 하시게 될 것입니다.

여러분의 성장을 진심으로 응원합니다.

2. 2차 강의 일정

📅 2차 강의 일정
항목 내용
일시 추후 공지 (단톡방 공지를 확인해주세요)
장소 추후 공지 (1차 강의와 동일 장소가 될 가능성이 높으나, 최종 공지를 기다려주세요)
상세 공지 3기 2차 강의 공지 참조 (구체적 내용·필수 준비사항·강의 후 마법들)

3. 메인 PC에 클로드 코드 CLI 환경 구축 + SSH 원격 접속 (가장 먼저!)

🖥️ 컴퓨터가 딱 한 대뿐인 분은 이 3항을 건너뛰셔도 됩니다 (꼭 먼저 읽어주세요)

이 3항은 노트북(리모컨)으로 멀리 있는 메인 PC를 원격 조종하기 위한 설정입니다. 따라서 컴퓨터가 한 대뿐인 분 — 즉 노트북 하나만, 또는 데스크탑(메인 PC) 하나만 쓰시는 분은 (그 한 대가 곧 메인 PC이므로) 원격 접속을 설정할 필요가 전혀 없습니다. 그냥 그 한 대로 과제를 진행하시면 됩니다. 🙂

✅ 한 대만 쓰시는 분이 "건너뛰어도 되는" 부분

건너뛰어도 되는 항목 이유
3항 Step 1 (Tailscale·SSH 접속) 원격으로 조종할 다른 PC가 없으므로 통로를 만들 필요가 없습니다
3항 Step 2 (노트북으로 메인 PC 원격 셋팅) 1차 강의 때 이미 본인 컴퓨터에 환경을 갖추셨으므로 원격 셋팅이 불필요합니다
3항 Step 3 (크롬 리모트 데스크탑 / 맥 화면 공유) 화면을 원격으로 띄울 대상이 없습니다
3항 Step 4 (메인 PC 항상 켜짐·절전 설정) 평소에는 불필요 — 단, 외출 중 휴대폰으로 텔레그램 봇(4항 다·4항 라)을 쓰고 싶을 때만 PC를 켜두시면 됩니다
5항 전체 (외부에서 노트북으로 같은 과제 다시 하기) 노트북 + 메인 PC 두 대가 있어야 가능한 "원격 재실습"이므로 통째로 건너뛰셔도 됩니다

▶️ 그래도 "반드시 하셔야 하는" 부분 (한 대만 쓰셔도 그대로 진행)

  • 4항 전체 — 본인의 그 한 대(=메인 PC)에서 그대로 진행 (질문/요청 30회, 옵시디언 기억장치, 텔레그램 봇 연결, 휴대폰 질문, 단체톡방, 랜딩페이지 만들기 모두)
  • 6항 2차 강의 준비사항 — 그대로 진행

💡 정리: 컴퓨터가 한 대뿐이면 → 3항·5항은 건너뛰고, 곧바로 4항부터 시작하세요. 이 문서에서 "메인 PC"라고 나오는 부분은 모두 여러분의 그 한 대를 가리킨다고 생각하시면 됩니다. 🙂

💡 왜 이것을 가장 먼저 해야 하나요?

2차 강의부터는 성능 좋은 메인 PC(사무실/집 데스크탑)에서 클로드 코드 CLI를 사용합니다. 노트북은 메인 PC에 접속하는 리모컨 역할만 합니다. 이하 모든 과제도 메인 PC에서 진행하므로, SSH 원격 접속 설정을 가장 먼저 완료해야 합니다.

⚠️ 반드시 지켜야 할 순서 (매우 중요!)
  1. Step 1 → Step 2 → Step 3 → Step 4는 반드시 노트북과 메인 PC가 같은 네트워크(같은 와이파이)에 있는 상태에서 진행하세요. (예: 집 또는 사무실에서 둘 다 같은 와이파이에 연결)
  2. 노트북에 이미 설치된 클로드 코드 CLI에게 도움을 요청하면서 진행하세요. 아래 각 단계에서 클로드 코드 CLI에게 어떻게 물어보면 되는지 안내해 드립니다.
  3. Step 1 (SSH 접속)이 가장 먼저 완료되어야, 노트북의 클로드 코드 CLI가 메인 PC에 원격으로 나머지 설정(Step 2·3·4)을 도와줄 수 있습니다.
  4. Step 2(메인 PC 환경 셋팅) → Step 3(크롬 리모트 데스크탑 또는 맥 화면 공유) → Step 4(메인 PC 항상 켜짐 + 절전 비활성화·잠금 시간 조절)까지 모두 완료해야, 외부에서 언제든 안정적으로 메인 PC에 접속할 수 있습니다. Step 4를 빠뜨리면 앞의 모든 설정이 무용지물이 됩니다.
  5. 같은 네트워크에서 Step 1 → Step 2 → Step 3 → Step 4가 모두 성공한 이후에, 외부 네트워크에서의 원격 접속(5항)을 시도하세요.

Step 1. Tailscale 설치 + 같은 네트워크에서 SSH 접속 (가장 먼저!)

  • 목적: 노트북에서 메인 PC를 원격으로 제어할 수 있는 통로를 먼저 만들기. 이 통로가 있어야 노트북의 클로드 코드 CLI가 메인 PC를 설정해줄 수 있습니다.
  • Tailscale이란?: 복잡한 네트워크 설정 없이 원격 접속을 가능하게 해주는 무료 도구입니다.
  • 사이트: https://tailscale.com (무료, 가입 필요)
📋 복사해서 쓰세요
진행 순서:
1. https://tailscale.com 에서 메인 PC와 노트북 모두에 Tailscale 설치
2. 같은 계정으로 양쪽 기기에서 로그인
3. 메인 PC에 SSH 서버 활성화
4. 노트북에서 메인 PC로 SSH 접속 테스트
  • 3번(SSH 서버 활성화)이 어려우시면, 노트북의 클로드 코드 CLI에게 이렇게 물어보세요:
📋 복사해서 쓰세요
내 메인 PC가 윈도우(또는 맥)인데, SSH 서버를 활성화하는 방법 알려줘
📋 복사해서 쓰세요
Tailscale 설치하고 두 컴퓨터를 연결하는 방법 알려줘
  • 같은 네트워크에서 노트북 → 메인 PC SSH 접속이 성공하면 Step 2로 진행

Step 2. 노트북의 클로드 코드 CLI로 메인 PC 전체 셋팅

🔑 핵심 진행 방식 (반드시 이렇게 하세요!)

아래 작업은 노트북의 클로드 코드 CLI를 실행하여 메인 PC에 SSH로 접속한 상태에서 진행하는 것입니다.

즉, 1. 노트북 터미널을 먼저 열고 2. 노트북 터미널에서 클로드 코드 CLI를 먼저 실행한 후 3. 그 클로드 코드 CLI에게 "SSH로 메인 PC에 접속해서 ○○ 해줘"라고 요청하는 방식

이것이 핵심입니다. 메인 PC 앞에 앉아서 직접 설정하는 것이 아니라, 노트북에서 클로드 코드 CLI를 실행한 후 그 클로드 코드 CLI가 SSH로 메인 PC에 접속해서 대신 설정해주는 방식입니다.

⭐ 가장 중요한 권장 사항

1차 강의 때 배운 방식 그대로 진행하시는 것을 강력 추천드립니다. 강의에서 직접 따라해본 순서와 방법대로 하나씩 재현해야 체득이 되고, 막히는 부분도 줄어듭니다. 아래 명령어 예시는 참고용일 뿐이며, 실제로는 1차 강의 때 했던 흐름을 그대로 따라가세요.

  • 목적: SSH 접속이 된 상태에서, 노트북의 클로드 코드 CLI에게 메인 PC 설정을 시키기. 직접 하나하나 설치할 필요 없이 클로드 코드 CLI가 원격으로 설정해줍니다.
  • 노트북의 클로드 코드 CLI에서 아래와 같이 요청하세요 (참고용 예시):
📋 복사해서 쓰세요
SSH로 메인 PC에 접속해서 Claude Code CLI를 설치해줘
📋 복사해서 쓰세요
메인 PC에 VS Code를 설치해줘
📋 복사해서 쓰세요
메인 PC에 옵시디언을 설치하고 기억장치를 설정해줘
📋 복사해서 쓰세요
메인 PC에 깃허브를 연결해줘
📋 복사해서 쓰세요
메인 PC에 텔레그램 봇을 설정해줘
📋 복사해서 쓰세요
메인 PC에 claude.md 파일을 만들어줘

Step 3. 크롬 리모트 데스크탑(Chrome Remote Desktop) 설치 및 설정

💡 왜 크롬 리모트 데스크탑도 필요한가요?

Step 1·2에서 설정한 SSH 접속은 "메인 PC의 터미널에 명령을 보내는 통로"입니다. 매우 강력하지만, 메인 PC의 화면 자체(시스템 알림 팝업, 로그인 창, 마우스 클릭이 필요한 인증 창, 윈도우/맥 설정 화면 등)를 직접 보고 조작할 수는 없습니다.

그런데 실제로 메인 PC를 원격으로 사용하다 보면 이런 상황이 반드시 생깁니다: - 메인 PC에서 갑자기 시스템 업데이트 알림이 떠 있어서 다른 작업이 막히는 경우 - OAuth 인증 팝업처럼 클릭 한 번이 필요한데 SSH로는 클릭이 안 되는 경우 - 메인 PC의 VS Code·옵시디언·브라우저 화면을 직접 눈으로 확인하고 싶은 경우 - 봇/서버가 멈춰서 메인 PC 화면을 봐야만 원인을 알 수 있는 경우 - 메인 PC가 자동으로 잠금 화면으로 들어가서 원격 작업이 막힌 경우

이럴 때 필요한 것이 크롬 리모트 데스크탑입니다. 이름 그대로 "메인 PC의 화면을 노트북에 그대로 띄워서 마우스·키보드로 직접 조작하게 해주는 도구"입니다. SSH가 "전화"라면, 크롬 리모트 데스크탑은 "화상 통화"에 가깝습니다. 둘은 서로 보완 관계입니다. 🖥️

즉, SSH는 평소에 자주 쓰는 메인 통로이고, 크롬 리모트 데스크탑은 SSH로는 해결 안 되는 시각적 상황을 위한 보조 통로입니다. 두 가지가 모두 준비되어 있어야 어떤 상황에서도 원격 작업을 안정적으로 이어갈 수 있습니다.

  • 목적: SSH로 해결되지 않는 시각적 상황(알림 팝업·인증 창·마우스 클릭 필요 작업 등)에 대응하기 위해, 메인 PC의 화면 자체를 노트북에서 보고 조작할 수 있는 통로를 만들어두기
  • 사이트: https://remotedesktop.google.com (구글 계정으로 무료 사용)

📋 진행 단계 (이 순서 그대로)

Step 3-0. Chrome 브라우저 설치 (메인 PC + 노트북 양쪽 모두) — 사전 준비
⭐ 왜 Chrome 브라우저가 꼭 필요한가요?

크롬 리모트 데스크탑은 이름 그대로 구글 Chrome 브라우저 위에서 작동하는 서비스입니다. 사파리·엣지·파이어폭스·웨일 등 다른 브라우저에서는 작동하지 않습니다. 따라서 메인 PC와 노트북 양쪽 모두에 Chrome이 먼저 설치되어 있어야 합니다.

이미 양쪽 모두에 Chrome이 설치되어 있으신 분은 이 단계를 건너뛰셔도 됩니다. Step 3-1로 바로 진행하세요.

  • 사이트: https://www.google.com/chrome/
  • 설치 방법 (운영체제별):

⊞ 윈도우 1. https://www.google.com/chrome/ 접속 2. "Chrome 다운로드" 버튼 클릭 3. 다운로드된 ChromeSetup.exe 파일을 더블클릭하여 실행 4. 자동으로 설치가 진행됩니다 (몇 분 소요) 5. 설치 완료 후 바탕화면 또는 시작 메뉴에서 Chrome 실행

🍎 맥(Mac) 1. https://www.google.com/chrome/ 접속 2. "Chrome 다운로드" 버튼 클릭 → googlechrome.dmg 파일 다운로드 3. 다운로드된 .dmg 파일을 더블클릭 → 열린 창에서 Chrome 아이콘을 Applications 폴더로 드래그 4. Launchpad 또는 Applications 폴더에서 Chrome 실행 5. 처음 실행 시 "확인되지 않은 개발자" 경고가 뜨면: - 시스템 설정 → 개인정보 보호 및 보안 → 하단의 "확인 없이 열기" 클릭

Step 3-0-1. Chrome에 본인 구글 계정으로 로그인 (양쪽 모두)
  • 설치한 Chrome 실행 → 우측 상단의 사람 모양 아이콘 클릭 → "동기화 사용 설정" 또는 "로그인"
  • 메인 PC와 노트북에 동일한 구글 계정으로 로그인 (이게 매우 중요합니다 — 아래 Step 3-1에서 같은 계정이어야 원격 접속이 가능)
  • 로그인 후 동기화를 켜두면 북마크·비밀번호 등도 자동 동기화되어 편리합니다
💡 설치가 어려우시면 클로드 코드 CLI에게 물어보세요
📋 복사해서 쓰세요
내 메인 PC가 윈도우(또는 맥)인데, Chrome 브라우저를 설치하고 내 구글 계정으로 로그인하는 방법을 단계별로 알려줘
Step 3-1. 메인 PC에 크롬 리모트 데스크탑 호스트(Host) 설치
  • 메인 PC에서 Chrome 브라우저로 https://remotedesktop.google.com 접속
  • 본인의 구글 계정으로 로그인
  • 좌측 또는 상단의 "원격 액세스(Remote Access)" 메뉴 클릭
  • "원격 액세스 설정" 또는 "Set up remote access" 버튼 클릭
  • 안내에 따라 Chrome Remote Desktop Host 프로그램 다운로드 및 설치
  • 설치 후 이 컴퓨터에 이름을 지정 (예: 내 메인 PC)
  • PIN 6자리 이상 설정 — 이 PIN은 노트북에서 접속할 때마다 입력하므로 기억하기 쉬운 것으로
  • "시작" 또는 "Start" 버튼 클릭하면 호스트가 활성화됨
  • 화면에 "이 컴퓨터는 온라인 상태입니다(Online)" 가 표시되면 완료
Step 3-2. 노트북에서 메인 PC에 원격 접속 테스트
  • 노트북에서 Chrome 브라우저로 https://remotedesktop.google.com 접속
  • 메인 PC와 동일한 구글 계정으로 로그인 (반드시 같은 계정이어야 합니다)
  • "원격 액세스" 메뉴 클릭
  • "원격 컴퓨터" 목록에 방금 등록한 메인 PC 이름이 보이는지 확인
  • 메인 PC 이름 클릭 → PIN 입력 → 접속
  • 노트북 화면에 메인 PC 화면이 그대로 나타나면 성공! 🎉
  • 마우스·키보드로 메인 PC를 직접 조작해보세요
Step 3-3. 외부 네트워크에서도 접속되는지 테스트
  • 노트북을 카페·다른 와이파이·핸드폰 핫스팟 등 집과 다른 네트워크에 연결
  • 위 Step 3-2와 동일한 방식으로 메인 PC에 접속이 잘 되는지 확인
  • 외부에서도 안정적으로 접속되면 완료
Step 3-3a. 🍎 맥 ↔ 맥 사용자 전용: 맥 화면 공유(VNC) — 크롬 리모트 데스크탑의 더 나은 대안
💡 메인 PC도 맥, 노트북도 맥이신 분은 여기를 주목하세요!

메인 PC와 노트북이 모두 맥(Mac)인 경우, 크롬 리모트 데스크탑 대신 macOS에 기본 내장된 "화면 공유(Screen Sharing)" 기능을 사용하실 수 있습니다. 이것은 기술적으로 VNC(Virtual Network Computing) 프로토콜을 사용하는 맥 전용 원격 화면 도구입니다.

크롬 리모트 데스크탑과 비교했을 때의 장점: - 🚀 맥끼리 최적화 — 맥 전용 프로토콜이라 화면 전송이 더 부드럽고 빠릅니다 - 📦 별도 설치 불필요 — Chrome 브라우저도, 확장 프로그램도 필요 없습니다. macOS에 이미 다 들어 있습니다 - ⌨️ 키보드 매핑 걱정 없음 — 양쪽 다 맥이므로 ⌘ + C, ⌘ + V, 한/영 전환 등 모든 단축키가 그대로 작동합니다 - 🔐 맥 로그인 계정으로 인증 — 별도 PIN 없이 메인 PC의 맥 사용자 이름·비밀번호로 접속

단점: - ❌ 맥 ↔ 맥 전용 — 한쪽이라도 윈도우면 사용 불가 (이 경우 크롬 리모트 데스크탑을 사용하세요) - 🌐 같은 네트워크에서는 바로 작동하지만, 외부 네트워크에서는 Tailscale이 필요 (Step 1에서 이미 설치하셨으므로 추가 작업은 없습니다)

🍎 어떤 분이 어떤 도구를 쓰면 좋은가요?

내 환경 추천 도구 이유
맥 노트북 → 맥 메인 PC 맥 화면 공유(VNC) 추천 설치 불필요, 빠르고 자연스러움, 키보드 완벽 호환
맥 노트북 → 윈도우 메인 PC 크롬 리모트 데스크탑 크로스 플랫폼 지원
윈도우 노트북 → 맥 메인 PC 크롬 리모트 데스크탑 크로스 플랫폼 지원
윈도우 노트북 → 윈도우 메인 PC 크롬 리모트 데스크탑 가장 간편
⭐ 맥 ↔ 맥이 아닌 분은 이 단계를 건너뛰세요

메인 PC 또는 노트북 중 하나라도 윈도우인 분은, 위 Step 3-0 ~ Step 3-3의 크롬 리모트 데스크탑 설정을 그대로 사용하시면 됩니다. 아래 VNC 설정은 건너뛰시고 Step 3-4로 진행하세요.

📋 맥 화면 공유(VNC) 설정 방법 (맥 ↔ 맥 전용)

Step A. 메인 PC(맥)에서 화면 공유 활성화

  1. 시스템 설정 열기 (⌘ + Space → "시스템 설정" 검색)
  2. 일반 → 공유 클릭
  3. "화면 공유(Screen Sharing)" 항목을 찾아 켜기(On) → 항목 오른쪽의 ⓘ (정보) 버튼 클릭
  4. 설정 팝업이 열리면 아래 항목을 확인하세요:
설정 항목 설정값 설명
화면 공유 켬 맨 위에 켜져 있어야 합니다
누구나 원격 제어 요청 가능 본인 선택 켜두면 접속 시 메인 PC에 승인 요청이 뜹니다 (꺼두어도 됩니다)
VNC 뷰어로 원격 제어 시 암호 사용 반드시 켜기 ⭐ 이것을 켜야 노트북에서 VNC로 접속할 수 있습니다
암호 직접 입력 ⭐ VNC 접속용 암호를 설정하세요. 💡 맥 로그인 비밀번호와 동일하게 설정하시면 헷갈리지 않아 편리합니다
다음 사용자의 접근을 허용 관리자 또는 모든 사용자 본인 계정이 관리자라면 "관리자"로 충분합니다
  1. 모든 설정을 마쳤으면 "완료" 버튼 클릭
⚠️ VNC 암호 설정은 필수입니다! (가장 중요)

"VNC 뷰어로 원격 제어 시 암호 사용"을 켜고 암호를 반드시 입력하셔야 합니다. 이 암호를 설정하지 않으면 노트북에서 VNC로 접속할 때 연결이 거부됩니다.

  • 이 암호는 크롬 리모트 데스크탑의 PIN과 비슷한 역할이라고 생각하시면 됩니다
  • 💡 맥 로그인 비밀번호와 동일하게 설정하시면 나중에 헷갈리지 않아 편리합니다
  • 반드시 기억해두세요 — 옵시디언 기억장치에 저장해두시는 것을 추천드립니다
💡 SSH로 원격에서도 켤 수 있습니다

SSH로 메인 PC에 접속한 상태에서 아래 명령을 실행하면 GUI를 열지 않고도 화면 공유를 활성화할 수 있습니다:

📋 복사해서 쓰세요
sudo launchctl load -w /System/Library/LaunchDaemons/com.apple.screensharing.plist

단, VNC 암호 설정은 GUI(시스템 설정)에서 직접 해주셔야 합니다.

Step B. 메인 PC의 Tailscale IP 확인 (한 번만 하면 됩니다)

접속할 때 Tailscale IP 주소를 사용합니다. 이 주소는 집에서든, 카페에서든, 어디서든 동일하게 작동하므로 한 가지 방법만 기억하시면 됩니다.

아래 세 가지 방법 중 편한 것 하나만 사용하시면 됩니다:

방법 1. Tailscale 앱에서 확인 (가장 쉬움) 🍎

  1. 메인 PC 화면 상단 메뉴바에서 Tailscale 아이콘 클릭 (작은 원형 아이콘)
  2. 표시되는 IP 주소를 메모 (예: 100.64.1.23)

방법 2. Tailscale 홈페이지에서 확인 (어디서든 가능) 🌐

  1. 아무 기기에서 브라우저로 https://login.tailscale.com/admin/machines 접속
  2. 본인 계정으로 로그인
  3. 기기 목록에서 메인 PC 이름 찾기 → 옆에 표시된 IP 주소 메모
  4. 💡 이 방법은 메인 PC 앞에 있지 않아도, 노트북이나 휴대폰에서도 확인할 수 있어 편리합니다

방법 3. 터미널 명령으로 확인 💻

  1. 메인 PC에서 터미널 열기 (또는 노트북에서 SSH로 메인 PC에 접속한 상태에서)
  2. 아래 명령 실행:
📋 복사해서 쓰세요
tailscale ip
  1. 출력되는 IP 주소를 메모 (예: 100.64.1.23)
💡 IP를 외우기 어려우시면

클로드 코드 CLI에게 이렇게 물어보세요:

📋 복사해서 쓰세요
내 메인 맥 PC의 Tailscale IP 주소를 확인해줘. 그리고 그 IP를 옵시디언 기억장치에 "메인 PC Tailscale IP"라는 제목으로 저장해줘

이렇게 해두면 어디서든 옵시디언만 열면 IP를 바로 확인할 수 있습니다. 🙂

Step C. 노트북(맥)에서 메인 PC에 접속 (집이든 외부든 방법 동일!)

  1. Finder 열기
  2. 상단 메뉴 → 이동(Go) → 서버에 연결...(Connect to Server...) (단축키: ⌘ + K)
  3. 주소 입력란에 vnc:// 뒤에 Step B에서 확인한 본인 메인 PC의 Tailscale IP를 입력합니다:
vnc://본인의-Tailscale-IP

예를 들어, Step B에서 확인한 IP가 100.64.1.23이었다면:

📋 복사해서 쓰세요
vnc://100.64.1.23

⚠️ 위 100.64.1.23은 예시입니다. 반드시 본인이 Step B에서 확인한 IP 주소로 바꿔 입력하세요!

  1. "연결(Connect)" 클릭
  2. Step A에서 설정한 VNC 암호 입력 (맥 로그인 비밀번호와 동일하게 설정하셨다면 그 비밀번호를 입력하시면 됩니다)
  3. 메인 PC 화면이 노트북에 그대로 나타나면 성공! 🎉
📌 왜 Tailscale IP 하나로 통일하나요?

Tailscale IP는 집 와이파이에서든, 카페에서든, 핫스팟에서든 어디서나 동일하게 작동합니다. 네트워크 환경에 따라 접속 방법을 바꿀 필요가 없어 헷갈릴 일이 없습니다. Step 1에서 Tailscale을 이미 설치하셨으므로 추가 작업도 없습니다. 🙂

Step D. 접속 테스트

  1. 같은 네트워크 테스트: 노트북과 메인 PC가 같은 와이파이에 있는 상태에서 vnc://Tailscale-IP로 접속 → 성공 확인
  2. 외부 네트워크 테스트: 노트북을 카페·핫스팟 등 다른 네트워크에 연결 → 동일한 주소 vnc://Tailscale-IP로 접속 → 성공 확인
  3. 양쪽 모두 안정적으로 접속되면 완료 ✅
⚠️ 접속 시 "화면 공유 품질" 선택 — 반드시 "화면 공유"(표준) 를 선택하세요!

접속할 때 "화면 공유"와 "가상 디스플레이" (또는 유사한 고품질 옵션) 중 선택하는 화면이 나올 수 있습니다.

선택지 결과 추천
화면 공유 (표준) 메인 PC 화면을 그대로 공유 — 메인 PC 모니터에도 화면이 계속 표시됨 ✅ 이것을 선택하세요
가상 디스플레이 (고품질) 해상도는 더 좋지만, 메인 PC의 실제 모니터 화면이 꺼집니다 ❌ 비추천

"가상 디스플레이"를 선택하면 메인 PC 모니터가 꺼져서, 메인 PC 앞에 앉아 있는 가족이나 동료가 "컴퓨터가 고장 났나?" 하고 당황할 수 있고, 메인 PC에서 직접 작업하려 할 때도 번거로워집니다. "화면 공유(표준)"를 선택하시면 메인 PC 화면은 그대로 유지되면서 노트북에서도 같은 화면을 볼 수 있으므로 훨씬 편리합니다. 🙂

💡 접속 시 "사용자 이름"을 모르겠을 때

VNC 접속 화면에서 사용자 이름(사용자명)과 암호를 입력하라고 나올 수 있습니다. 여기서 사용자 이름은 메인 PC(맥)의 로그인 계정 이름입니다.

본인의 사용자 이름을 모르시면, 메인 PC에서 터미널을 열고(또는 SSH로 접속한 상태에서) 아래 명령을 실행하세요:

📋 복사해서 쓰세요
whoami

출력되는 값(예: sungwon, hong 등)이 바로 입력할 사용자 이름입니다.

💡 다음부터 더 빠르게 접속하기 — Finder "서버 목록"에 추가해두세요

매번 ⌘ + K → IP 주소 입력을 반복하면 번거롭습니다. 한 번 접속에 성공한 후, Finder의 서버 목록에 저장해두면 다음부터는 클릭 한 번으로 접속할 수 있습니다.

저장 방법: 1. Finder → ⌘ + K → 주소 입력란에 vnc://본인의-Tailscale-IP 입력 2. 주소 입력란 오른쪽의 + 버튼 클릭 → "즐겨찾는 서버" 목록에 추가됩니다 3. 끝! 🎉

다음 접속 시: 1. Finder → ⌘ + K 2. 아래쪽 "즐겨찾는 서버" 목록에서 저장해둔 주소 클릭 3. "연결" → 바로 접속!

💡 암호도 매번 입력하기 귀찮으시면: 처음 접속할 때 암호 입력 화면에서 "키체인에 이 암호 기억(Remember this password in my keychain)" 체크박스를 켜두세요. 그러면 다음부터는 암호 입력 없이 클릭만으로 바로 접속됩니다.

이렇게 해두면 IP 주소를 외우거나 매번 찾아볼 필요 없이, Finder에서 클릭 두 번이면 메인 PC 화면이 바로 열립니다. 🙂

🔑 맥 화면 공유(VNC) 사용 시 유의사항
  1. VNC 암호를 반드시 기억해두세요 — Step A에서 설정한 암호입니다 (맥 로그인 비밀번호와 동일하게 설정하셨다면 따로 외울 필요 없습니다)
  2. 방화벽 설정 확인 — 시스템 설정 → 네트워크 → 방화벽에서 화면 공유가 차단되어 있지 않은지 확인하세요. 방화벽이 켜져 있다면, "화면 공유"에 대한 수신 연결을 허용해주세요
  3. Step 4(메인 PC 항상 켜짐 설정)는 동일하게 필요 — VNC도 메인 PC가 켜져 있고 깨어 있어야 접속 가능합니다
  4. 크롬 리모트 데스크탑도 함께 설정해두면 더 좋습니다 — VNC가 어떤 이유로 안 될 때를 위한 백업 수단. 둘 다 설정해두시면 어떤 상황에서도 접속이 가능합니다
💡 설정이 어려우시면 클로드 코드 CLI에게 물어보세요
📋 복사해서 쓰세요
내 메인 PC가 맥(Mac)이고 노트북도 맥인데, 맥 화면 공유(VNC)를 설정해서 노트북에서 메인 PC에 원격으로 접속하고 싶어. 메인 PC에서 화면 공유 켜는 방법과, 노트북에서 접속하는 방법을 단계별로 알려줘. Tailscale을 통해 외부에서도 접속할 수 있게 해줘
Step 3-4. ⌨️ 메인 PC와 노트북의 운영체제가 다른 경우 — 키보드 매핑 설정
⭐ "맥북으로 윈도우 메인 PC 조작" 또는 "윈도우 노트북으로 맥 메인 PC 조작"을 하시는 분 필독!

메인 PC와 노트북의 운영체제가 같으면(맥↔맥, 윈도우↔윈도우) 키보드는 거의 그대로 동작하므로 이 단계는 건너뛰셔도 괜찮습니다.

하지만 운영체제가 다른 경우(예: 맥북으로 윈도우 PC 조작), 단축키가 헷갈려서 "왜 복사 붙여넣기가 안 되지?", "이 키는 어디 있지?" 같은 작은 문제가 계속 발생합니다. 이 단계에서 미리 한 번만 키 매핑을 이해하고 설정해두시면 이후 작업이 훨씬 자연스러워집니다. 🙂

🍎 맥북으로 → ⊞ 윈도우 메인 PC를 조작하는 경우

가장 흔한 경우입니다. 맥 키보드의 ⌘·Option 키와 윈도우 키보드의 Ctrl·Alt 키 위치가 다르고 역할도 다르기 때문에 혼란이 생깁니다.

기본 키 대응표 (크롬 리모트 데스크탑이 자동으로 매핑해주는 부분):

맥 키 (내 노트북) 윈도우 키 (메인 PC에서 인식되는 것) 의미
⌘ (Command) Ctrl 복사/붙여넣기 등 단축키의 기본
Option (⌥) Alt 메뉴 활성화·특수문자
Control (⌃) Ctrl (윈도우의 보조 Ctrl처럼 동작) —
delete (백스페이스) Backspace 글자 지우기
fn + delete Delete 앞 글자 지우기
return Enter 줄바꿈

자주 쓰는 단축키 변환 예: - 복사: 맥에서 ⌘ + C 누르면 → 윈도우에서 Ctrl + C로 동작 ✅ - 붙여넣기: ⌘ + V → Ctrl + V ✅ - 전체선택: ⌘ + A → Ctrl + A ✅ - 새로고침: ⌘ + R → Ctrl + R ✅ - 작업 전환: ⌘ + Tab → 메인 PC의 Alt + Tab ✅ (단, 전환 대상이 노트북이 아닌 메인 PC의 앱들)

⊞ 윈도우 노트북으로 → 🍎 맥 메인 PC를 조작하는 경우

윈도우 키 (내 노트북) 맥 키 (메인 PC에서 인식되는 것)
Ctrl ⌘(Command)으로 자동 매핑 — 복사/붙여넣기 등
Alt Option(⌥)으로 자동 매핑
Win 키 (윈도우 로고) Control(⌃)으로 매핑되는 경우가 많음
Backspace delete

자주 쓰는 단축키 변환 예: - 복사/붙여넣기: 윈도우에서 Ctrl + C / Ctrl + V 누르면 → 맥에서 ⌘ + C / ⌘ + V로 자동 인식 ✅ - 전체선택: Ctrl + A → ⌘ + A ✅

🛠️ 잘 안 될 때의 체크포인트

  1. 한/영 전환 키가 다르다 — 맥은 Caps Lock 또는 Control + Space, 윈도우는 오른쪽 Alt(한/영) 또는 Shift + Space. 메인 PC의 한/영 전환 방식대로 누르셔야 합니다 (즉, 메인 PC가 윈도우면 노트북에서도 윈도우 방식으로)
  2. 특수문자가 안 나온다 — 키보드 레이아웃이 메인 PC의 OS를 따르므로, 메인 PC의 특수문자 입력 방식대로 누르세요
  3. 단축키가 노트북 자체에 가로채진다 — 일부 노트북 단축키(예: 맥의 ⌘ + Q, 윈도우의 Win + L)는 노트북 자체에서 먼저 처리되어 메인 PC로 전달되지 않을 수 있습니다. 이럴 땐 크롬 리모트 데스크탑 화면 상단의 "키보드 단축키 보내기" 메뉴(키보드 아이콘)를 이용하시면 됩니다
  4. 함수키(F1~F12)가 안 먹는다 — 맥북의 경우 fn 키와 함께 눌러야 함수키가 동작합니다 (시스템 설정 → 키보드 → "F1, F2 등의 키를 표준 함수 키로 사용" 켜두면 더 편함)
  5. 크롬 리모트 데스크탑 설정에서 키 매핑 변경: 접속 후 화면 우측의 설정(톱니바퀴) 아이콘 → "키보드 단축키" 또는 "입력" 에서 매핑 옵션을 조정할 수 있습니다 (버전에 따라 메뉴 위치가 다를 수 있음)
💡 가장 빠른 해결책 — 클로드 코드 CLI에게 물어보세요

키 매핑 문제는 본인의 정확한 운영체제 조합에 따라 해결책이 달라지므로, 클로드 코드 CLI에게 본인 환경을 알려주고 물어보시는 것이 가장 빠릅니다.

📋 복사해서 쓰세요
나는 ___(예: 맥북 M2)로 ___(예: 윈도우 11 데스크탑)에 크롬 리모트 데스크탑으로 접속해서 작업하려고 해. 키보드가 OS가 다르다 보니 복사·붙여넣기·한영 전환·특수문자 입력 같은 게 헷갈려. 내 환경에서 제일 자연스럽게 작동하도록 키보드 매핑·단축키 설정·한영 전환 방법을 단계별로 알려줘. 내가 자주 쓰는 단축키 변환표도 만들어서 옵시디언에 저장해줘
📌 SSH 접속에는 키보드 매핑 문제가 거의 없습니다

SSH는 "터미널에 텍스트 명령을 보내는 것"이므로, 대부분의 키 입력이 그대로 전달되며 OS 차이로 인한 단축키 문제가 거의 없습니다. 키보드 매핑 문제는 주로 크롬 리모트 데스크탑(GUI 조작)에서만 발생합니다.

🔑 절대 빠뜨리면 안 되는 점
  1. 메인 PC와 노트북이 반드시 같은 구글 계정이어야 합니다. 다른 계정이면 메인 PC가 "원격 컴퓨터 목록"에 나타나지 않습니다.
  2. 메인 PC가 켜져 있어야 원격 접속이 가능합니다. SSH와 마찬가지로 전원·절전 모드 설정(4항 다 참조)을 잘 해두셔야 합니다.
  3. PIN을 잊지 마세요. 매번 접속할 때마다 입력해야 합니다. 옵시디언 기억장치에 저장해두시는 것을 추천드립니다.
  4. Chrome 브라우저가 양쪽에 모두 설치되어 있어야 합니다. (사파리·엣지·파이어폭스 등 다른 브라우저에서는 작동 안 됩니다)
💡 설치·설정이 어려우시면 클로드 코드 CLI에게 물어보세요
📋 복사해서 쓰세요
내 메인 PC가 윈도우(또는 맥)인데, 크롬 리모트 데스크탑(Chrome Remote Desktop)을 설치하고 노트북에서 원격으로 접속할 수 있도록 설정하는 방법을 단계별로 알려줘. 내가 뭘 클릭하고 뭘 입력해야 하는지 초등학생도 이해할 수 있게 쉽게 설명해줘
📌 SSH와 화면 공유 도구(크롬 리모트 데스크탑 / 맥 화면 공유), 언제 어떤 걸 쓰나요?
상황 추천 도구
평소 클로드 코드 CLI 사용·코드 작업·터미널 명령 SSH (속도 빠름, 가벼움)
OAuth 인증 팝업·시스템 알림 처리 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC)
VS Code·옵시디언 화면 직접 보고 조작 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC)
메인 PC가 멈춰서 화면을 봐야 할 때 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC)
빠른 파일 편집·코드 수정·CLI 명령 실행 SSH

💡 맥 ↔ 맥 사용자: 위 표에서 "크롬 리모트 데스크탑" 자리에 맥 화면 공유(VNC)를 사용하시면 됩니다 (설치 불필요, 키보드 완벽 호환, 더 빠름). 설정 방법은 위 Step 3-3a 참조.

즉, 평소에는 SSH가 메인이고, 시각적 작업이 필요할 때만 크롬 리모트 데스크탑(또는 맥 화면 공유)으로 잠깐 전환하는 것이 가장 효율적인 사용 방식입니다. 🙂

Step 4. 메인 PC 항상 켜짐 + 절전 비활성화·잠금 시간 조절 설정 (⭐ 가장 중요!)

⚠️ Step 1·2·3을 다 해놓고 이 단계를 빠뜨리면, 모든 설정이 무용지물이 됩니다

SSH 접속도, 크롬 리모트 데스크탑(또는 맥 화면 공유)도, 텔레그램 봇도 — 메인 PC가 켜져 있고 깨어 있는 동안에만 작동합니다. 메인 PC가 꺼지거나 절전 모드(슬립)에 들어가면 외부에서 노트북으로 접속해도 아무것도 되지 않습니다.

💡 참고: 잠금 화면은 다릅니다 — 잠금 화면이 떠 있는 상태는 컴퓨터가 꺼지거나 잠든 것이 아니라 깨어 있는 상태입니다. 따라서: - SSH·텔레그램 봇: 잠금 화면과 무관하게 정상 작동 (영향 없음) - 크롬 리모트 데스크탑·맥 화면 공유(VNC): 접속은 되지만, 잠금 화면이 그대로 보이므로 비밀번호를 입력해서 잠금을 풀어야 이후 GUI 작업 가능

따라서 Step 1·2·3을 모두 마친 후에는, 메인 PC가 항상 켜진 상태로 유지되도록 설정하는 것이 마지막이자 가장 중요한 단계입니다.

  • 목적: 외부에서 언제든 노트북·휴대폰으로 메인 PC에 접속할 수 있도록, 메인 PC를 24시간 안정적으로 깨어 있는 상태로 유지하기
  • 확인 및 변경해야 할 항목:

📋 진행 단계 (이 순서 그대로)

Step 4-1. 절전 모드(슬립/잠자기) 비활성화
  • 메인 PC의 시스템 설정에서 "일정 시간 후 절전 모드 진입" 옵션을 "사용 안 함(Never)" 으로 변경
  • ⊞ 윈도우: 설정 → 시스템 → 전원 및 절전 → "PC를 절전 모드로 전환" → "안 함"
  • 🍎 맥: 시스템 설정 → 디스플레이(또는 배터리) → "디스플레이가 꺼져 있을 때 자동으로 잠자지 않도록 설정" 활성화
  • 또는 터미널에서 sudo pmset -a sleep 0 (전원 연결 시 절전 비활성화)
Step 4-2. 잠금 화면 설정 (자동 잠금 시간 조절)
  • 잠금 화면이 떠 있어도 원격 접속 자체는 정상적으로 됩니다 — 다만, 도구에 따라 영향이 다릅니다:
  • SSH·텔레그램 봇: 잠금 화면과 전혀 무관 — 잠금이 걸려 있어도 평소와 똑같이 정상 작동합니다 (텍스트 명령이므로 화면 상태를 보지 않음)
  • 크롬 리모트 데스크탑·맥 화면 공유(VNC): 접속은 되지만, 잠금 화면이 그대로 보이므로 원격에서 비밀번호를 입력하여 잠금을 먼저 풀어야 그 다음 작업(인증 팝업 클릭, VS Code 조작 등)을 할 수 있습니다
🔐 개인정보와 보안을 위해 잠금 화면은 활성화 상태를 유지하시는 것을 추천드립니다

잠금 화면을 완전히 꺼두면 편리하긴 하지만, 메인 PC가 24시간 켜져 있는 만큼 가족·동료·방문객 등 다른 사람이 비밀번호 없이 메인 PC를 조작할 수 있는 상태가 됩니다. 개인 파일·계정·메신저 등이 노출될 위험이 있으므로, 잠금 화면은 켜둔 채로 아래와 같이 "즉시" 잠금으로 설정하시는 것을 추천드립니다.

원격 접속 시 잠금 화면이 뜨더라도 비밀번호만 입력하면 바로 풀리므로, 큰 불편 없이 보안을 유지할 수 있습니다. 🙂

  • ⊞ 윈도우: 설정 → 계정 → 로그인 옵션 → "PC가 절전 모드에서 깨어날 때 로그인 필요" → 본인 취향대로 (추천: 유지)
  • 🍎 맥: 시스템 설정 → 잠금 화면 → "디스플레이가 꺼진 후 또는 화면 보호기가 시작된 후 암호 요구" → "즉시" (보안을 위해 디스플레이가 꺼지면 바로 잠금 — 원격 접속 시 비밀번호만 입력하면 되므로 불편하지 않습니다)
Step 4-3. 디스플레이만 꺼지도록 설정 (전기료 절약 + 외부 노출 방지)
  • 컴퓨터 본체는 깨어 있고, 화면(모니터)만 꺼지는 것은 괜찮습니다 — SSH·크롬 리모트 데스크탑(또는 맥 화면 공유)·텔레그램 봇 모두 정상 작동합니다
  • 💡 두 가지 목적: 1. 전기료 절약 — 모니터가 켜져 있는 것보다 꺼져 있는 게 훨씬 적은 전력을 소비합니다 2. 외부 노출 방지 — 가족·동료·방문객 등 다른 사람이 봤을 때 "컴퓨터가 켜져 있는지조차 모르게" 자연스럽게 두기 위함입니다. 화면이 꺼져 있으면 "꺼져 있는 컴퓨터"처럼 보이므로, 24시간 켜두는 것에 대한 시각적 부담이 사라집니다. 🙂
  • ⊞ 윈도우: 설정 → 시스템 → 전원 및 절전 → "화면을 다음 시간 후 끄기" → 본인 취향대로 (예: 10분)
  • 🍎 맥: 시스템 설정 → 디스플레이 → "디스플레이를 끌 때까지의 시간" → 본인 취향대로
Step 4-4. 자동 업데이트 후 재부팅 막기 (윈도우 한정)
  • 윈도우는 기본 설정상 자동 업데이트 후 재부팅으로 메인 PC가 꺼져 있는 경우가 종종 발생합니다
  • 설정 → Windows Update → 고급 옵션 → "활성 시간" 을 본인 사용 시간에 맞게 넓게 설정
  • 또는 "업데이트 후 재시작 알림 표시" 활성화하여 자동 재부팅 방지
Step 4-5. 같은 네트워크에서 1시간 방치 테스트
  • 위 4-1 ~ 4-4 설정을 마친 후, 메인 PC를 1시간 정도 그대로 두고 다른 일을 하다가 노트북에서: 1. SSH 접속이 여전히 잘 되는지 확인 2. 크롬 리모트 데스크탑(또는 맥 화면 공유)이 여전히 잘 연결되는지 확인
  • 둘 다 정상이면 Step 4 완료 ✅
💡 설정이 어려우시면 클로드 코드 CLI에게 물어보세요
📋 복사해서 쓰세요
내 메인 PC가 윈도우(또는 맥)인데, 외부에서 SSH나 크롬 리모트 데스크탑(또는 맥 화면 공유)으로 항상 안정적으로 접속할 수 있도록 절전 모드·자동 잠금·디스플레이만 꺼지기 등 모든 전원 관련 설정을 해줘. 디스플레이만 꺼지고 컴퓨터 본체는 항상 깨어 있는 상태가 되도록 설정해줘.
🚨 이후 절대 지켜야 할 주의사항 (매우 중요!)

Step 4 설정을 마치셨다면, 그 이후로는 아래 사항을 절대 지켜주셔야 외부에서 메인 PC에 접속이 가능합니다:

  1. 메인 PC의 전원을 끄지 마세요 — 외출하실 때도, 잠자리에 드실 때도 켜둔 채로 두세요. (전기료가 부담되시면 4항 다의 맥미니 추천 참조)
  2. 수동으로 절전 모드에 보내지 마세요 — 노트북과 달리 메인 PC는 "덮개를 닫는 것"도 없으니, 건드리지 않으면 됩니다.
  3. 시스템 업데이트로 인한 재부팅이 발생한 경우, 재부팅 후 메인 PC가 다시 정상적으로 깨어 있는지 (잠금 화면이 떠 있어도 OK), SSH·크롬 리모트 데스크탑(또는 맥 화면 공유) 접속이 다시 되는지 한 번씩 확인해주세요.
  4. 모니터·키보드·마우스는 빼두셔도 됩니다. — 어차피 외부에서 노트북으로 접속할 거니까요. 책상 공간을 비워두시고, 필요할 때만 다시 연결해서 쓰시면 됩니다.
⏰ 2차 강의 오시기 전, 이것만은 반드시 다시 한 번 확인해주세요

1차 과제를 완수하신 분들도, 2차 강의 당일 아침에 메인 PC가 정상적으로 켜져 있고 SSH·크롬 리모트 데스크탑(또는 맥 화면 공유) 접속이 잘 되는지 반드시 한 번 더 점검해주세요. 강의 당일 "어, 갑자기 안 되네?" 하는 일을 막기 위함입니다.

출발 전 마지막 체크리스트 (강의장 가시기 전 1시간 이내): - [ ] 메인 PC가 켜져 있는지 확인 (전원 LED, 또는 노트북에서 ping/ssh로 확인) - [ ] 노트북으로 SSH 접속 테스트 (ssh 사용자명@메인PC이름 → claude 실행까지 확인) - [ ] 노트북으로 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC) 접속 테스트 (메인 PC 화면이 잘 뜨는지) - [ ] 휴대폰 텔레그램 봇 응답 테스트 — 4항 다에서 메인 PC의 클로드 코드 CLI에 연결한 텔레그램 봇이 휴대폰에서 정상적으로 응답하는지 반드시 확인 (메인 PC가 켜져 있고 정상 작동 중인지를 가장 빠르게 검증할 수 있는 방법)

위 항목 중 하나라도 안 되면, 출발 전 미리 해결하세요. 도움이 필요하시면 단톡방에 "강의 출발 전인데 ___이 안 됩니다" 라고 올려주시면 됩니다. 🙏

💡 이 마지막 점검이 강의 당일 여러분의 시간과 마음의 여유를 결정합니다. 1차 강의 때처럼 "준비하느라 1~2시간을 또 소진" 하지 않으려면, 이 점검을 꼭 해주세요.

★ 공통 자료실 안내 — 학습 자료 (본 과제 진행 시 꼭 활용해 주세요)

📚 공통 자료실이란?

본 강의를 위해 강사·운영진이 직접 작성·정리한 학습 가이드 모음입니다. 옵시디언 노트(.md) 형식으로 30여 종 이상이 있으며, 구글 드라이브 0. 공통자료실 공유폴더에서 수강생 모두 자유롭게 다운로드·열람하실 수 있습니다. 앞으로도 강사·운영진이 새로운 자료를 꾸준히 추가할 예정이니 정기적으로 들러 확인해 주세요. 🌱

📂 자료 카테고리 (난이도순)

카테고리 예시 자료 (대표)
(0. 준비) 강의 공통 자료 읽는 순서·활용 가이드 / 옵시디언 완전 시작 가이드 / 클로드 코드 CLI 설치 가이드
(1. 기초) Brave Search API 가입·결제 / Claude Code 사용량·한도·토큰 / 상태표시줄 / 클로드 대화 기록 자동 저장
(2. 중급) MCP 완전 가이드 / 옵시디언 MCP 서버 / 채널스 텔레그램 봇 / tmux / 권한 자동 승인 / Claude 디자인 도구 / 맥에서 마크다운 옵시디언처럼 보기
(3. 심화) Claude Code 원격·세션 / 원격 SSH iCloud·Desktop 접근 / 애플 기기 원격 접속 / 옵시디언 + 터미널 세 경로 / 나만의 스킬(Skill Creator) / 멀티 AI 협업 / 플러그인 완전 가이드 / Google design.md / 하네스 엔지니어링
(4-5. 응용) Codex·Gemini로 이미지 자동 생성 / 음성→녹취록 자동화 스킬 / 이미지 자동화 스킬
(6. 응용 심화) Claude Code 환경 정리 / Superpowers 프레임워크 / gstack 프레임워크
(7. 코딩 기초) 바이브코더의 백엔드·DB·웹서버·프론트엔드 4종 뿌리 지식

⭐ 본 1차 과제에 필요한 필수 학습 자료

본 과제 각 항목(3항 환경 구축 ~ 6항 2차 강의 준비)을 수행하실 때 가장 직접적으로 도움이 되는 자료입니다. 각 항목 시작 전에 해당 자료를 한 번 정독하시고, 진행 중에도 막히면 다시 펼쳐 보세요.

과제 항목 권장 학습 자료 (공통 자료실에서)
(공통 시작) (0. 준비) 강의 공통 자료 — 읽는 순서·활용 가이드 ← 가장 먼저 읽으세요
3항. 메인 PC 환경 구축 + SSH 원격 접속 (3. 심화) Claude Code 원격·세션 완전 가이드 + (3. 심화) 원격 SSH Claude Code가 iCloud·Desktop 파일에 접근하게 만들기 + (3. 심화) 애플 기기 원격 접속 환경 구축 가이드 + (2. 중급) tmux 완전 시작 가이드
4항-가. CLI로 다양한 질문/요청 (30회) (0. 준비) 클로드 코드 CLI 설치 가이드 + (1. 기초) Claude Code 사용량·한도·토큰 완전 가이드 + (1. 기초) Claude Code 상태표시줄 완전 가이드
4항-나. 옵시디언 기억장치 (0. 준비) 옵시디언 완전 시작 가이드 + (1. 기초) 클로드 대화 기록 자동 저장 설정 가이드 + (2. 중급) 옵시디언 MCP 서버 설정 + (3. 심화) 옵시디언 + 터미널 세 경로 완전 가이드
4항-다·라·마. 텔레그램 봇 연결·활용 (2. 중급) 채널스 텔레그램 봇 설정 가이드 + (2. 중급) tmux 완전 시작 가이드 (봇 안정 운영 필수) + (2. 중급) Claude Code 권한 자동 승인·Bypass 완전 가이드
4항-바. VS Code + CLI + 깃허브로 랜딩페이지 (7. 코딩 기초) 바이브코더의 프론트엔드 뿌리 지식 + (7. 코딩 기초) 웹서버·배포 뿌리 지식 + (3. 심화) Google이 공개한 design.md (디자인 일관성)
5항. 외부에서 원격으로 재실습 (3. 심화) Claude Code 원격·세션 완전 가이드 + (3. 심화) 원격 SSH iCloud·Desktop 접근 + (3. 심화) 애플 기기 원격 접속 환경 구축 (3항과 동일 자료)
6항-라. Brave 검색 API 발급 (1. 기초) Brave Search API 가입·결제 완전 가이드 (나머지 Google OAuth·Nano Banana·네이버 검색은 본 공지 6항에 직접 안내)
(전체 환경 보강) (2. 중급) MCP 완전 가이드 + (2. 중급) Claude 디자인 도구 3종 + (3. 심화) 나만의 스킬(Skill Creator) / 멀티 AI 협업 / 플러그인 완전 가이드 / 하네스 엔지니어링

💡 권장 활용 순서

  1. 본 과제 시작 전 — (0. 준비) 강의 공통 자료 — 읽는 순서·활용 가이드를 먼저 정독해 전체 구조 파악
  2. 각 과제 항목 진행 직전 — 위 표의 해당 자료를 한 번 정독 (30분~1시간)
  3. 진행 중 막힐 때 — 자료를 다시 펼쳐 검색·발췌하며 활용
  4. 과제 완료 후 — (선택) 응용·심화 자료(4-7. 응용·코딩)를 본인 페이스로 추가 학습
📌 자료실 위치 다시 안내

모든 자료는 구글 드라이브 0. 공통자료실 공유폴더에 옵시디언 노트(.md) 형식으로 올라가 있습니다. 본인 옵시디언 볼트로 내려받아 보시면 백링크·검색까지 그대로 활용하실 수 있습니다. 새 자료가 추가될 수 있으니 정기적으로 확인해 주세요. 🌱

4. 메인 PC에서 1차 강의 내용 체득 과제

💡 왜 메인 PC에서 해야 하나요?

앞으로 실제로 클로드 코드 CLI를 사용할 환경은 메인 PC입니다. 메인 PC에서 직접 과제를 수행해야 이 환경에 익숙해지고, 2차 강의를 원활하게 따라올 수 있습니다.

가. 클로드 코드 CLI로 다양한 질문/요청하기 (총 30회 이상)

  • 목적: 클로드 코드 CLI와 대화하는 방식에 익숙해지기. 질문하는 방법이 다양할수록 클로드 코드 CLI를 더 잘 활용할 수 있습니다.
  • 메인 PC에서 클로드 코드 CLI를 실행하여 진행
  • 글로 질문하기, 그림/사진 붙여넣기 후 질문하기, 파일 첨부하고 질문하기 등 다양한 방법으로 질문하기
  • 실생활 질문, 업무 관련 질문, 궁금한 것 등 무엇이든 좋습니다
  • 30회 이상 시도해볼 것

나. 옵시디언으로 클로드 코드 CLI 기억장치 만들고 활용하기

  • 목적 (핵심): 클로드 코드 CLI가 나를 기억하게 만들기. 옵시디언에 기억장치를 만들어두면, 클로드 코드 CLI가 이전 대화 내용과 나의 정보를 기억하여 더 나에게 맞는 답변을 해줍니다.
  • 메인 PC에서 진행

기본 셋팅

  • 옵시디언 볼트 생성 (맥은 아이클라우드에 생성)
  • 클로드 코드 CLI 기억장치 만들기
  • (부가) PARA 메모법으로 폴더 정리하기 — 옵시디언 노트를 체계적으로 관리하기 위한 정리법

추가 과제 (체득용)

(1) 클로드 코드 CLI와의 대화를 옵시디언에 수동으로 저장해보기 (총 5회 이상)
  • 목적: 중요한 대화를 내가 직접 골라 옵시디언에 남겨두는 방식 체득. 어떤 대화가 기억할 가치가 있는지 판단하는 감각을 기르기 위해
  • 클로드 코드 CLI와 나눈 대화 중에서 기억할 만한 내용을 직접 복사하여 옵시디언 노트에 저장해보기
  • 또는 클로드 코드 CLI에게 "방금 나눈 대화를 옵시디언에 저장해줘"라고 요청하여 저장
  • 5회 이상 시도해볼 것
(2) 자동 저장된 클로드 코드 CLI 대화 세션을 참조하여 다시 요청하기 (총 5회 이상)
  • 목적: 과거 대화 내역을 다시 불러와 이어서 작업하거나 확장하는 방식 체득. "예전에 이거 물어본 적 있는데 다시 활용하고 싶어"라는 상황에서 유용합니다.
  • 옵시디언에 자동 저장된 클로드 코드 CLI 대화 세션 파일을 찾아서, 그 파일을 클로드 코드 CLI에 드래그앤드롭(또는 경로 지정)으로 참조시키고 이어서 작업 요청하기
  • 예시:
  • "(예전 대화 세션 참조) 이 대화 이어서 ○○를 해줘"
  • "(예전 대화 세션 참조) 그때 논의했던 방식대로 이번에는 △△에 적용해줘"
  • "(예전 대화 세션 참조) 이 대화에서 결론만 뽑아서 요약해줘"
  • 5회 이상 시도해볼 것
(3) 자동 저장된 대화를 클로드 코드 CLI가 직접 검색하여 활용하기 (총 5회 이상)
  • 목적: 내가 일일이 찾지 않아도 클로드 코드 CLI가 과거 대화 전체에서 필요한 내용을 스스로 찾아 작업을 이어가는 방식 체득. 가장 강력한 활용법 중 하나입니다.
  • 클로드 코드 CLI에게 "옵시디언에 저장된 과거 대화 중에서 ○○에 관한 내용을 찾아서 그걸 기반으로 △△해줘"라고 요청
  • 예시:
  • "내 옵시디언의 과거 대화 중에서 '○○ 프로젝트' 관련 내용을 찾아서 지금까지의 진행 상황을 정리해줘"
  • "옵시디언에 저장된 대화 중에서 '△△' 관련 결정 사항만 모아서 보여줘"
  • "과거 대화에서 내가 선호한다고 말했던 방식을 찾아서 이번 작업에도 똑같이 적용해줘"
  • 5회 이상 시도해볼 것
(4) 클로드 코드 CLI가 직접 옵시디언에 메모(지식 정리) 작성하기 (총 5회 이상)
  • 목적: 클로드 코드 CLI가 옵시디언의 파일을 직접 생성·수정할 수 있다는 것을 체험하고, 앞으로 중요한 정보를 클로드 코드 CLI에게 맡겨 자동으로 정리·저장하는 방식에 익숙해지기
  • 클로드 코드 CLI에게 중요하고 분량이 많은 내용을 옵시디언에 직접 메모하도록 요청해볼 것
  • 예시:
  • "오늘 내가 배운 ○○에 대해 정리해서 옵시디언에 저장해줘"
  • "내 업무 관련 지식 ○○를 체계적으로 정리해서 옵시디언에 노트로 만들어줘"
  • "방금 나눈 대화 내용을 요약해서 옵시디언에 저장해줘"
  • "○○ 주제에 대해 네가 알고 있는 내용을 전부 옵시디언에 정리해줘"
  • 5회 이상 요청해볼 것
  • 단순한 한두 줄이 아니라 실제로 유용하게 활용할 수 있는 충분한 분량의 내용으로
(5) 옵시디언 메모를 드래그앤드롭으로 클로드 코드 CLI에 참조시키기 (총 5회 이상)
  • 목적: 내가 이미 가진 옵시디언 노트를 클로드 코드 CLI에게 참조시켜 활용하는 방식 체득. 앞으로 문서·자료를 기반으로 클로드 코드 CLI에게 요청할 때 가장 많이 쓰는 방법입니다.
  • 옵시디언의 메모 파일을 클로드 코드 CLI 창에 드래그앤드롭하여 참조시킨 후, 그 내용을 기반으로 요청하기
  • 예시:
  • "(노트 드래그앤드롭 후) 이 내용을 요약해줘"
  • "(노트 드래그앤드롭 후) 이 내용을 바탕으로 ○○를 만들어줘"
  • "(노트 드래그앤드롭 후) 이 내용에서 부족한 부분을 찾아서 보완해줘"
  • "(노트 드래그앤드롭 후) 이 내용을 다른 형식으로 정리해줘"
  • 5회 이상 시도해볼 것

다. 클로드 코드 CLI 채널스로 텔레그램 봇 연결하기 (1회)

  • 목적: 핸드폰에서도 클로드 코드 CLI를 사용할 수 있게 하기. 컴퓨터 앞에 없을 때도 텔레그램으로 클로드 코드 CLI에게 질문하고 답변받을 수 있습니다.
  • 메인 PC에서 채널스로 텔레그램 봇 연결하기
  • 텔레그램 봇 연결은 메인 PC에서 1회만 하면 됩니다
⚠️ 노트북의 텔레그램 봇은 삭제하세요

이제 노트북에 연결한 텔레그램 봇은 삭제하세요. 잘 모르실 경우 클로드 코드 CLI에게 물어봐서 그대로 진행하여 삭제하세요. 혹시 모를 충돌을 막기 위함입니다.

또한, 노트북은 이동·외출 등으로 자주 전원을 끄거나 덮개를 닫게 되므로, 노트북에 텔레그램 봇이 연결되어 있으면 봇이 작동하지 않는 경우가 매우 많습니다. 그래서 24시간 켜둘 수 있는 메인 PC에 연결해두는 것이 안정적입니다.

🔌 메인 PC 전원 관련 주의사항 (매우 중요!)

텔레그램 봇은 메인 PC가 켜져 있고 깨어있는 동안에만 작동합니다. 메인 PC가 꺼지거나 절전 모드에 들어가면, 휴대폰에서 텔레그램으로 질문해도 답변이 오지 않습니다.

따라서 텔레그램 봇을 사용할 예정이라면 아래 사항을 반드시 지켜주세요:

  1. 메인 PC의 전원을 끄지 마세요 — 외출할 때도 켜둔 채로 두세요.
  2. 절전 모드(슬립/잠자기) 설정 주의 — 기본 설정상 일정 시간 지나면 절전 모드로 들어가는 경우가 많습니다. 이 설정을 "사용 안 함" 또는 봇이 계속 작동할 수 있는 상태로 변경해야 합니다.
  3. 디스플레이는 꺼져도 됩니다 — 화면이 꺼지는 것과 컴퓨터가 절전 모드에 들어가는 것은 다릅니다. 화면만 꺼지도록 설정하면 전력도 아끼면서 봇도 계속 작동합니다.
  4. 화면 보호기·잠금 화면 설정도 확인하세요 — 디스플레이가 꺼진 후 자동으로 잠금 화면이 뜨도록 설정되어 있는 경우가 많습니다. 잠금 자체는 SSH·텔레그램 봇 작동에는 영향을 주지 않지만, 크롬 리모트 데스크탑이나 맥 화면 공유(VNC)로 접속했을 때 매번 비밀번호를 입력해야 하는 번거로움이 생깁니다. 단, 개인정보와 보안을 위해 잠금 화면은 활성화 상태를 유지하시는 것을 추천드립니다. 잠금을 완전히 끄기보다는 "즉시" 잠금으로 설정해두세요 (SSH·텔레그램 봇은 잠금과 무관하게 정상 작동하므로 불편함이 없습니다): - ⊞ 윈도우: 설정 → 계정 → 로그인 옵션 → "PC가 절전 모드에서 깨어날 때 로그인 필요" → 본인 취향대로 (추천: 유지) - 🍎 맥: 시스템 설정 → 잠금 화면 → "디스플레이가 꺼진 후 또는 화면 보호기가 시작된 후 암호 요구" → "즉시" (보안을 위해 권장)
  5. 설정 방법이 어려우면 클로드 코드 CLI에게 물어보세요 — "내 메인 PC(윈도우/맥)에서 절전 모드는 끄고 화면만 꺼지도록 설정해줘. 디스플레이 꺼지면 바로 잠금 걸리도록 해줘"라고 요청하면 됩니다.

💡 그래서 전기료가 매우 낮은 맥미니(Mac Mini)를 추천드리는 것입니다. - 맥미니는 아이들 상태에서 전력 소모가 매우 낮아 24시간 켜두어도 전기료 부담이 거의 없습니다 (월 수백 원 ~ 수천 원 수준). - 발열·소음도 적어 책상 위나 한쪽 구석에 두고 24시간 운영하기에 가장 적합합니다. - 일반 데스크탑 PC로도 가능하지만, 전력 소모와 발열·소음이 훨씬 크다는 점을 감안하셔야 합니다.

⚠️ 텔레그램 봇이 갑자기 안 될 때 — "터미널 창을 실수로 닫았다!" 문제 방지하기 (tmux)

채널스 텔레그램 봇은 터미널 창 하나에서 실행 중인 프로그램입니다. 그래서 그 터미널 창을 실수로 닫거나, 터미널 앱을 종료하면 봇도 함께 꺼집니다. 메인 PC 앞에서 다른 작업을 하다가 무심코 터미널 창을 닫아버리면, 외출 중에 텔레그램 봇이 먹통이 되는 일이 자주 생깁니다.

이 문제를 해결하는 도구가 바로 tmux(맥) 또는 VBS 백그라운드 실행(윈도우)입니다.

⭐ ⊞ 윈도우 사용자는 아래 윈도우 전용 안내를 따라 하세요

아래 tmux 설치·실행·자동 실행 안내(Step 1~4)는 맥 사용자 전용입니다. 윈도우 사용자는 아래 tmux 안내는 건너뛰고, 바로 여기로 이동하세요. (이미 WSL을 사용 중인 윈도우 사용자는 WSL 안에서 tmux를 사용하는 방법도 안내되어 있습니다.)

내 PC에 WSL이 있는지 먼저 확인하세요: 1. PowerShell 열기 (시작 메뉴 → "PowerShell" 검색 → 클릭) 2. 아래 명령어 입력 후 Enter:

   wsl --list
  1. 결과에 따라 방법이 달라집니다:
결과 의미 따라할 방법
Ubuntu 등 이름이 나옴 WSL이 이미 설치됨 방법 A: WSL 안에서 tmux (맥과 동일)
인식할 수 없습니다 또는 설치된 배포가 없습니다 WSL이 없음 방법 B: 윈도우 네이티브 (더 간단)

잘 모르시겠으면 방법 B를 선택하세요. 더 간단합니다.

🛡️ tmux란? — 터미널 창을 닫아도 프로그램이 계속 돌아가게 해주는 도구

일상의 비유로 설명하면:

일반 터미널은 "TV를 끄면 드라마도 같이 꺼지는 것"과 같습니다. 터미널 창을 닫으면 그 안에서 돌아가던 프로그램(채널스 봇)도 함께 종료됩니다.

tmux는 "녹화 예약을 걸어두는 것"과 같습니다. TV(터미널 창)를 꺼도, 녹화(채널스 봇)는 뒤에서 계속 돌아갑니다. 나중에 TV를 다시 켜면(터미널을 다시 열면) 녹화 중인 화면을 그대로 다시 볼 수 있습니다.

즉, tmux를 사용하면: - ✅ 터미널 창을 닫아도 채널스 봇이 꺼지지 않고 계속 작동 - ✅ 실수로 터미널을 종료해도 봇이 살아 있음 - ✅ 나중에 다시 접속하면 실행 중인 봇 화면을 그대로 다시 볼 수 있음

📋 tmux 설정 방법 (단계별로 따라 하세요)

Step 1. tmux 설치

메인 PC의 운영체제에 따라 아래 방법 중 본인에 해당하는 것 하나만 따라 하세요.

🍎 메인 PC가 맥(Mac)인 경우

  1. 메인 PC에서 터미널 열기 (⌘ + Space → "터미널" 검색)
  2. 먼저 tmux가 이미 설치되어 있는지 확인:
📋 복사해서 쓰세요
tmux -V
  1. 버전이 표시되면 이미 설치된 것 → Step 2로 바로 진행
  2. command not found가 나오면 설치 필요 → 아래 명령 실행:
📋 복사해서 쓰세요
brew install tmux
  1. 설치 완료 후 tmux -V로 다시 확인 → 버전이 표시되면 성공 ✅
💡 brew: command not found가 나오면?

Homebrew가 설치되어 있지 않은 것입니다. 아래 두 가지 방법 중 하나로 해결하세요:

방법 1. 클로드 코드 CLI에게 한 번에 맡기기 (추천):

📋 복사해서 쓰세요
내 맥에 Homebrew가 없어. Homebrew를 먼저 설치하고, 그다음 tmux도 설치해줘

방법 2. 직접 설치:

📋 복사해서 쓰세요
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 후 터미널을 한 번 껐다 다시 열고, brew install tmux를 실행하세요.

💡 설치가 어렵거나 오류가 나면 — 클로드 코드 CLI에게 맡기세요

위 과정이 복잡하게 느껴지거나 오류가 나면, 클로드 코드 CLI에게 본인 환경을 알려주고 한 번에 맡기시는 것이 가장 빠릅니다:

📋 복사해서 쓰세요
내 맥에 tmux를 설치해줘. 오류가 나면 해결도 같이 해줘

클로드 코드 CLI가 운영체제를 확인하고 설치부터 검증까지 차근차근 도와줍니다. 🙂

Step 2. tmux로 채널스 텔레그램 봇 실행하기

지금까지는 일반 터미널에서 바로 채널스 봇을 실행하셨을 텐데, 이제부터는 tmux 안에서 실행합니다:

1단계. tmux 세션 만들기:

📋 복사해서 쓰세요
tmux new -s channels
  • channels는 세션 이름입니다 (원하는 이름으로 바꿔도 됩니다)
  • 이 명령을 실행하면 화면 맨 아래에 초록색 바가 나타납니다 — 이것이 tmux 안에 들어와 있다는 표시입니다

2단계. tmux 안에서 채널스 봇 실행:

  • tmux 안의 터미널에서 평소와 동일하게 채널스 봇을 실행합니다
  • (실행 방법은 1차 강의 때 배운 것과 똑같습니다)

3단계. tmux에서 빠져나오기 (봇은 계속 돌아감!):

📋 복사해서 쓰세요
Ctrl + B 를 누른 후, D 를 누르기
  • Ctrl + B를 동시에 누른 뒤 손을 떼고, 그다음 D를 누릅니다
  • 화면이 일반 터미널로 돌아오면서 [detached (from session channels)] 메시지가 나타납니다
  • 이 상태에서 터미널 창을 닫아도, 채널스 봇은 뒤에서 계속 돌아갑니다! 🎉
Step 3. 기본 tmux 명령어 (이것만 알면 됩니다)
상황 명령어 설명
돌아가고 있는 봇 화면 다시 보기 tmux attach -t channels tmux 세션에 다시 접속
tmux 안에서 빠져나오기 (봇 유지) Ctrl + B → D 봇은 계속 돌아가면서 터미널만 빠져나옴
봇을 완전히 종료하기 tmux kill-session -t channels 세션과 봇 모두 종료
현재 실행 중인 세션 목록 보기 tmux ls 어떤 세션이 돌아가고 있는지 확인
💡 "어렵게 느껴지시면 클로드 코드 CLI에게 한 번에 설정해달라고 하세요"

위 과정이 복잡하게 느껴지시면, 클로드 코드 CLI에게 이렇게 요청하시면 됩니다:

📋 복사해서 쓰세요
내 맥에 tmux를 설치하고, 채널스 텔레그램 봇을 tmux 세션 안에서 실행해줘. 터미널 창을 닫아도 봇이 꺼지지 않게 하고 싶어. 단계별로 진행해줘

클로드 코드 CLI가 설치부터 실행까지 차근차근 도와줍니다. 🙂

Step 4. 메인 PC 재부팅 시 채널스 봇 자동 실행 설정
💡 왜 이 설정이 필요한가요?

tmux 덕분에 터미널 창을 닫아도 봇이 살아 있지만, 메인 PC가 재부팅되면 tmux 세션 자체가 사라지므로 봇을 수동으로 다시 실행해야 합니다.

재부팅은 자주 있는 일은 아니지만, macOS 자동 업데이트나 정전 등으로 예고 없이 재부팅되는 경우가 있습니다. 이때 외출 중이라면 봇이 꺼진 채로 모르고 지나가게 됩니다.

아래 설정을 해두면, 메인 PC가 재부팅되더라도 자동으로 tmux 세션이 만들어지고 채널스 봇이 실행됩니다. 한 번만 설정해두면 이후로는 신경 쓸 필요가 없습니다. 🙂

이 단계까지 완료해야 어떤 상황에서도 봇이 항상 작동하는 상태가 됩니다. 반드시 설정해주세요.

🍎 메인 PC가 맥(Mac)인 경우 — launchd 사용

맥에서는 launchd라는 macOS 내장 도구로 "컴퓨터가 켜질 때 자동으로 실행할 프로그램"을 등록할 수 있습니다.

방법 1. 클로드 코드 CLI에게 한 번에 맡기기 (추천):

📋 복사해서 쓰세요
내 맥에서 컴퓨터가 재부팅되면 자동으로 tmux 세션을 만들고 그 안에서 채널스 텔레그램 봇이 실행되도록 설정해줘. launchd를 사용해서 로그인 시 자동 실행되게 해줘. 현재 채널스 봇 실행 명령어는 (여기에 본인의 채널스 봇 실행 명령어를 적어주세요) 이야

클로드 코드 CLI가 본인 환경에 맞는 .plist 파일을 만들고 등록까지 해줍니다.

방법 2. 직접 설정하기 (참고용):

  1. 먼저 채널스 봇을 tmux 안에서 자동 실행하는 스크립트를 만듭니다:
📋 복사해서 쓰세요
nano ~/start-channels-bot.sh
  1. 아래 내용을 입력하고 저장합니다 (Ctrl + O → Enter → Ctrl + X):
📋 복사해서 쓰세요
#!/bin/bash
# 기존 channels 세션이 있으면 종료
tmux kill-session -t channels 2>/dev/null
# 새 tmux 세션을 만들고 그 안에서 채널스 봇 실행
tmux new-session -d -s channels '여기에_본인의_채널스_봇_실행_명령어'

⚠️ 여기에_본인의_채널스_봇_실행_명령어 부분을 본인이 평소 채널스 봇을 실행할 때 쓰는 명령어로 바꿔주세요.

  1. 스크립트에 실행 권한 부여:
📋 복사해서 쓰세요
chmod +x ~/start-channels-bot.sh
  1. launchd에 등록 — 로그인 시 자동 실행:
📋 복사해서 쓰세요
nano ~/Library/LaunchAgents/com.channels.bot.plist
  1. 아래 내용을 입력하고 저장합니다:
📋 복사해서 쓰세요
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.channels.bot</string>
    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>start-channels-bot.sh의_전체_경로</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/channels-bot.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/channels-bot-error.log</string>
</dict>
</plist>

⚠️ start-channels-bot.sh의_전체_경로 부분을 실제 경로로 바꿔주세요 (예: /Users/본인이름/start-channels-bot.sh).

  1. 등록:
📋 복사해서 쓰세요
launchctl load ~/Library/LaunchAgents/com.channels.bot.plist
  1. 테스트: 메인 PC를 재부팅한 후, tmux ls를 실행하여 channels 세션이 자동으로 생성되어 있는지 확인 → 확인되면 성공 ✅
💡 자동 실행이 잘 되는지 테스트하는 가장 확실한 방법
  1. 메인 PC를 재부팅
  2. 재부팅 후 터미널을 열고 아래 명령 실행:
📋 복사해서 쓰세요
tmux ls
  1. channels: 1 windows ... 같은 결과가 나오면 자동 실행 성공 ✅
  2. 휴대폰 텔레그램에서 봇에게 메시지를 보내서 응답이 오는지 확인하면 완벽 ✅
📌 요약 (맥 사용자) — tmux 사용 전 vs 사용 후 vs 자동 실행까지 설정 후
tmux 없이 (지금까지) tmux 사용 후 (Step 2) tmux + 자동 실행 (Step 4)
터미널 창을 닫으면? ❌ 봇도 같이 꺼짐 ✅ 봇은 계속 돌아감 ✅ 봇은 계속 돌아감
실수로 터미널 종료하면? ❌ 외출 중 봇 먹통 ✅ 아무 영향 없음 ✅ 아무 영향 없음
봇 상태 다시 확인하려면? ❌ 봇을 처음부터 다시 실행 ✅ tmux attach로 바로 복귀 ✅ tmux attach로 바로 복귀
메인 PC 재부팅 후? ❌ 봇 다시 실행 필요 ❌ 봇 다시 실행 필요 ✅ 자동으로 봇이 다시 시작됨

💡 Step 4까지 설정하시면 메인 PC 전원만 켜져 있으면 어떤 상황에서도 봇이 항상 작동하는 상태가 됩니다. 한 번만 설정해두면 이후로는 봇에 대해 신경 쓸 일이 거의 없어집니다. 🙂

⊞ 윈도우 사용자 — 백그라운드 실행 + 자동 시작 설정 (tmux·WSL 필요 없음)

💡 WSL 확인을 아직 안 하셨다면

위 tmux 안내 직전의 callout에서 wsl --list 명령어로 확인하는 방법을 안내해두었습니다. 또는 클로드 코드 CLI에게 내 PC에 WSL이 설치되어 있는지 확인해줘라고 물어보셔도 됩니다.

📌 윈도우 사용자에게 두 가지 방법이 있습니다
내 상황 추천 방법 이유
WSL(Ubuntu)을 이미 사용 중 방법 A: WSL 안에서 tmux 맥과 동일한 방식, tmux의 편의성 활용 가능
WSL이 없거나, 잘 모르겠다 방법 B: 윈도우 네이티브 WSL 설치 불필요, 더 간단, CLI 하나만 관리

잘 모르시겠으면 방법 B를 선택하세요. 더 간단합니다.

⚠️ 왜 WSL을 새로 설치하는 것은 권장하지 않나요?

WSL을 설치하면 윈도우 네이티브 CLI와 WSL CLI가 완전히 별개의 두 개가 됩니다:

윈도우 네이티브 CLI WSL(Ubuntu) CLI
설치 위치 C:\Users\사용자\.claude\ /home/사용자/.claude/
실행 환경 PowerShell / CMD Ubuntu 터미널
로그인 별도 로그인 필요 별도 로그인 필요
설정(settings.json) 각자 별도 각자 별도

즉, WSL을 새로 설치하면 로그인을 두 번 해야 하고, 설정이 공유되지 않으며, 평소 작업은 네이티브에서 하면서 봇만 WSL에서 실행해야 하는 혼란이 생깁니다. 이미 WSL을 사용 중이신 분은 이미 익숙하시므로 괜찮지만, 처음 설치하시는 분은 불필요한 복잡함이 추가됩니다.

방법 A. WSL이 이미 있는 경우 — tmux 사용

이미 WSL(Ubuntu)을 사용 중이시라면, 맥과 동일하게 tmux를 설치하여 사용할 수 있습니다.

A-1. tmux 설치

WSL(Ubuntu) 터미널을 열고 아래 명령 실행:

📋 복사해서 쓰세요
sudo apt update && sudo apt install -y tmux

설치 확인: tmux -V → 버전이 표시되면 성공 ✅

A-2. tmux로 봇 실행

위 맥 사용자 안내의 Step 2와 Step 3을 동일하게 따라 하시면 됩니다. WSL 터미널 안에서 tmux 명령어가 맥과 똑같이 작동합니다.

⚠️ WSL 사용 시 주의

채널스 봇도 WSL(Ubuntu) 터미널 안에서 실행해야 tmux가 작동합니다. 기존에 PowerShell이나 CMD에서 봇을 실행하셨다면, 이제부터는 Ubuntu 터미널에서 실행하시면 됩니다.

A-3. 재부팅 시 자동 실행 설정

방법 1. 클로드 코드 CLI에게 한 번에 맡기기 (추천):

📋 복사해서 쓰세요
내 윈도우 PC에서 컴퓨터가 재부팅되면 자동으로 WSL의 tmux 세션을 만들고 그 안에서 채널스 텔레그램 봇이 실행되도록 설정해줘. 시작 프로그램에 등록해서 로그인 시 자동 실행되게 해줘. 현재 채널스 봇 실행 명령어는 (여기에 본인의 채널스 봇 실행 명령어를 적어주세요) 이야

방법 2. 직접 설정하기 (참고용):

  1. WSL 안에 자동 실행 스크립트 만들기 — WSL(Ubuntu) 터미널에서:
📋 복사해서 쓰세요
nano ~/start-channels-bot.sh
  1. 아래 내용을 입력하고 저장합니다 (Ctrl + O → Enter → Ctrl + X):
📋 복사해서 쓰세요
#!/bin/bash
tmux kill-session -t channels 2>/dev/null
tmux new-session -d -s channels '여기에_본인의_채널스_봇_실행_명령어'

⚠️ 여기에_본인의_채널스_봇_실행_명령어 부분을 본인 명령어로 바꿔주세요.

  1. 실행 권한 부여:
📋 복사해서 쓰세요
chmod +x ~/start-channels-bot.sh
  1. 윈도우 시작 프로그램에 등록 — Win + R → 아래 입력 → Enter:
📋 복사해서 쓰세요
shell:startup
  1. 열린 폴더에 새 텍스트 파일을 만들고 이름을 channels-bot.vbs로 변경, 아래 내용 입력:
📋 복사해서 쓰세요
Set ws = CreateObject("Wscript.Shell")
ws.Run "wsl bash -c '~/start-channels-bot.sh'", 0
  1. 저장 후 닫기

  2. 테스트: 메인 PC를 재부팅한 후, WSL 터미널에서 tmux ls를 실행하여 channels 세션이 자동으로 생성되어 있는지 확인 → 확인되면 성공 ✅

방법 B. WSL이 없는 경우 — 윈도우 네이티브 백그라운드 실행

WSL 없이, 윈도우에 기본 내장된 VBS 스크립트로 봇을 백그라운드 실행합니다. 별도 설치가 필요 없고, CLI도 하나만 관리하면 됩니다.

📌 VBS(Visual Basic Script)란?

VBS는 윈도우에 처음부터 내장되어 있는 자동화 도구입니다. 별도로 다운로드하거나 설치할 필요가 전혀 없습니다.

쉽게 말하면, 메모장으로 몇 줄만 적어서 .vbs 파일로 저장하면, 그 파일을 더블클릭하는 것만으로 프로그램을 백그라운드에서 실행할 수 있습니다. "터미널 창 없이 봇을 조용히 실행하는 리모컨"을 만드는 것이라고 생각하시면 됩니다.

  • ✅ 설치 불필요 — 모든 윈도우 PC에 기본 탑재
  • ✅ 사용법 간단 — 메모장에 2줄 적고, .vbs로 저장, 더블클릭
  • ✅ 터미널 창이 안 뜸 — 봇이 보이지 않는 곳에서 조용히 실행됨

일상의 비유로 설명하면:

일반 터미널(PowerShell)은 "TV를 끄면 드라마도 같이 꺼지는 것"과 같습니다. 터미널 창을 닫으면 그 안에서 돌아가던 프로그램(채널스 봇)도 함께 종료됩니다.

VBS 백그라운드 실행은 "라디오를 틀어놓고 방을 나가는 것"과 같습니다. 눈에 보이는 창은 없지만, 봇은 뒤에서 조용히 계속 돌아갑니다.

B-1. 봇 백그라운드 실행 스크립트 만들기

방법 1. 클로드 코드 CLI에게 한 번에 맡기기 (추천):

📋 복사해서 쓰세요
내 윈도우 PC에서 채널스 텔레그램 봇을 백그라운드로 실행하는 VBS 스크립트를 만들어줘. 터미널 창을 닫아도 봇이 꺼지지 않게 하고 싶어. 그리고 시작 프로그램에도 등록해서 재부팅해도 자동 실행되게 해줘. 현재 채널스 봇 실행 명령어는 (여기에 본인의 채널스 봇 실행 명령어를 적어주세요) 이야

클로드 코드 CLI가 VBS 파일 생성부터 시작 프로그램 등록까지 한 번에 해줍니다.

방법 2. 직접 만들기 (참고용):

  1. 메모장을 열고 아래 내용 입력:
📋 복사해서 쓰세요
Set ws = CreateObject("Wscript.Shell")
ws.Run "cmd /c 여기에_본인의_채널스_봇_실행_명령어", 0

⚠️ 여기에_본인의_채널스_봇_실행_명령어 부분을 본인이 평소 채널스 봇을 실행할 때 쓰는 명령어로 바꿔주세요.

  1. "다른 이름으로 저장" → 파일명: start-channels-bot.vbs / 파일 형식: "모든 파일" 선택
  2. 저장 위치: 바탕화면 또는 본인이 기억하기 쉬운 곳

B-2. 봇 실행 테스트

  1. 만든 start-channels-bot.vbs 파일을 더블클릭
  2. 터미널 창이 뜨지 않지만, 봇이 백그라운드에서 실행 중
  3. 휴대폰 텔레그램에서 봇에게 메시지를 보내서 응답이 오는지 확인 → 응답이 오면 성공 ✅
💡 봇이 잘 돌아가고 있는지 확인하는 방법

백그라운드 실행이라 터미널 창이 보이지 않으므로, 휴대폰 텔레그램에서 봇에게 아무 메시지나 보내보는 것이 가장 확실한 확인 방법입니다.

B-3. 재부팅 시 자동 실행 설정 (시작 프로그램 등록)

  1. Win + R → 아래 입력 → Enter:
📋 복사해서 쓰세요
shell:startup
  1. 열린 폴더에 아까 만든 start-channels-bot.vbs 파일을 복사해서 붙여넣기
  2. 끝! 이제 PC가 재부팅되고 로그인하면 자동으로 봇이 백그라운드에서 실행됩니다

테스트: 메인 PC를 재부팅한 후, 휴대폰 텔레그램에서 봇에게 메시지를 보내서 응답이 오는지 확인 → 응답이 오면 성공 ✅

📌 요약 — 윈도우 사용자: 방법 A vs 방법 B
방법 A (WSL + tmux) 방법 B (네이티브 VBS)
전제 조건 WSL이 이미 설치되어 있어야 함 없음 (윈도우 기본 기능)
터미널 창을 닫으면? ✅ 봇은 계속 돌아감 ✅ 봇은 계속 돌아감
봇 상태 다시 확인하려면? ✅ tmux attach로 바로 복귀 텔레그램으로 메시지 보내서 확인
메인 PC 재부팅 후? ✅ 자동으로 봇이 다시 시작됨 ✅ 자동으로 봇이 다시 시작됨
CLI 관리 네이티브 + WSL 두 개 네이티브 하나만
추천 대상 WSL을 이미 쓰고 계신 분 그 외 모든 윈도우 사용자

라. 텔레그램 봇으로 휴대폰에서 질문하기 (30회 이상)

  • 목적: 컴퓨터 없이도 휴대폰만으로 클로드 코드 CLI를 활용하는 경험을 해보기. 이동 중, 외출 중에도 클로드 코드 CLI에게 질문하고 답변받을 수 있습니다.
  • 위 다항에서 연결한 텔레그램 봇을 휴대폰에서 사용
  • 실생활 질문, 업무 질문, 궁금한 것 등 30회 이상 질문해볼 것
  • 메인 PC 앞에 있지 않을 때 (이동 중, 외출 중 등) 활용해보기

마. 텔레그램 봇을 동기와 함께 단체톡방에서 사용해보기 (10회 이상)

  • 목적: 클로드 코드 CLI를 여러 명이 함께 사용하는 경험 해보기. 앞으로 업무팀·스터디 그룹 등에서 AI를 공동으로 활용할 때의 감각을 익히기 위함입니다. 또한 다른 동기가 질문하고 답변받는 과정을 옆에서 보는 것만으로도 배울 점이 많습니다.
  • 진행 방식: 1. 3기 동기 중 1명 이상과 텔레그램 단체톡방 만들기 2. 나의 텔레그램 봇을 그 단체톡방에 초대 3. 단체톡방에서 함께 봇에게 질문·요청 해보기
  • 단체톡방에서 봇에게 10회 이상 질문이나 요청해볼 것
  • 동기와 번갈아 질문하거나, 서로의 질문에 이어서 추가 질문하는 방식도 좋습니다
  • 이 과정에서 배운 점이나 재미있었던 경험은 단톡방에 공유해주세요

바. VS Code + 클로드 코드 CLI + 깃허브로 나만의 랜딩페이지 만들고 버전 관리하기

  • 목적: 1차 강의 2부에서 노트북으로 본인의 랜딩페이지를 만들고 깃허브에 올리는 것까지 실제로 해보셨습니다. 이 과제는 그 경험을 메인 PC에서 다시 체득하고, 본인 랜딩페이지를 한 단계 더 발전시키는 것이 목표입니다. 1차 강의에서 배운 VS Code 터미널 → 클로드 코드 CLI → 깃허브의 전체 흐름을 메인 PC 환경에서 다시 한 번 손에 익혀두면, 2차 강의에서 백엔드·데이터베이스를 붙이는 작업이 훨씬 수월해집니다.
  • 메인 PC에서 진행
  • 아래 순서대로 모두 진행하세요:

(1) VS Code 터미널에서 클로드 코드 CLI로 나만의 랜딩페이지 만들기

  • 목적: 메인 PC의 VS Code 터미널 안에서 클로드 코드 CLI를 실행하여 랜딩페이지를 만드는 흐름을 다시 체득. 1차 강의 때 노트북으로 했던 그 흐름을 그대로 메인 PC에서 재현해보는 것입니다.
  • 메인 PC에서 VS Code 실행
  • 프로젝트 폴더 새로 만들기 (예: my-landing-page)
  • VS Code 터미널을 열고, 그 안에서 클로드 코드 CLI 실행
  • 클로드 코드 CLI에게 "내 소개 랜딩페이지를 만들어줘" 라고 요청 (자신의 직업·취미·연락처·SNS 등 본인 정보를 자유롭게 활용)
  • 또는 "내 사업·가게·동호회 소개 랜딩페이지를 만들어줘", "내 포트폴리오 랜딩페이지를 만들어줘" 등 본인이 하고 싶은 주제로 자유롭게
  • 웹 프로그램으로 만들기 (HTML/CSS/JS)
  • 개발서버로 열어서 직접 확인해보기
  • 1차 강의 때 만든 랜딩페이지보다 본인의 색깔이 한 단계 더 들어간 페이지로 만들어보세요 🎨
⭐ 이 랜딩페이지는 "연습용"이 아닙니다 — 진짜 인터넷에 공개될 페이지입니다!

2차 강의에서는 여기서 만든 랜딩페이지를 실제로 인터넷에 배포하여, 본인의 도메인(예: 내이름.com)으로 전 세계 누구나 볼 수 있는 상태로 만듭니다. 즉, 지금 만드시는 이 페이지가 곧 여러분의 진짜 홈페이지가 됩니다.

그러니 "어차피 과제니까 대충 만들자"가 아니라, "내 이름으로 인터넷에 올라갈 페이지"라는 마음으로 가능한 한 예쁘고 좋게 만들어보시길 추천드립니다. 🙂

  • 본인 사진·로고·색상 등 개성을 담아보세요
  • 마음에 안 드는 부분이 있으면 클로드 코드 CLI에게 "이 부분 색상을 바꿔줘", "사진 위치를 옮겨줘", "더 세련되게 만들어줘" 등 계속 수정을 요청하시면 됩니다 — 이 과정 자체가 바이브 코딩 실력을 키우는 최고의 연습입니다
  • 2차 강의에서 배포한 후에도 언제든 수정·업데이트할 수 있으니, 완벽하지 않아도 괜찮습니다 — 일단 마음에 드는 수준까지 만들어보세요 💪

(2) 만든 랜딩페이지를 깃허브에 올리기

  • 목적: 내가 만든 랜딩페이지를 온라인에 저장하고 버전 관리하는 흐름을 메인 PC에서 다시 체득
  • 클로드 코드 CLI에게 "이 랜딩페이지 프로젝트를 깃허브에 새 저장소로 올려줘" 라고 요청
  • 깃허브 사이트(https://github.com) 에서 본인 저장소(repository)에 코드가 올라갔는지 확인
  • 1차 강의 때 만든 랜딩페이지 저장소와 별도의 새 저장소로 올리시면, 둘을 비교해볼 수 있어 더 좋습니다

(3) 올린 랜딩페이지를 다시 다운로드 받기

  • 목적: 깃허브에서 내 코드를 받아오는(clone) 경험을 메인 PC에서 다시 체득
  • 메인 PC의 다른 폴더에 (2)에서 올린 랜딩페이지 저장소를 다시 다운로드(clone) 받기
  • 클로드 코드 CLI에게 "내 깃허브 저장소 ○○○를 이 폴더에 다운로드 받아줘" 라고 요청해도 되고, VS Code의 깃허브 기능이나 GitHub Desktop 앱을 사용해도 됩니다
  • 다운로드 받은 랜딩페이지가 원본과 동일한지 확인

(4) VS Code로 랜딩페이지를 조금 수정한 후 다시 깃허브에 올리기

  • 목적: "수정 → 커밋 → 푸시" 로 이어지는 버전 관리의 기본 흐름을 다시 체득
  • (3)에서 다운로드 받은 랜딩페이지를 VS Code로 열기
  • 랜딩페이지를 조금 수정하기 — 수정은 클로드 코드 CLI에게 요청해도 됩니다
  • 예: 새로운 섹션 추가(예: "내 작품/프로젝트" 영역), 배경색·폰트 변경, 버튼 추가, 연락처 정보 업데이트, 간단한 애니메이션 효과 추가 등
  • 수정한 내용을 깃허브에 다시 올리기 (클로드 코드 CLI에게 "수정한 내용을 깃허브에 올려줘" 라고 요청하거나, VS Code의 깃허브 기능 사용)
  • 깃허브 사이트에서 수정 내용이 반영되었는지 확인

(5) 자신이 직접 일부 파일의 내용을 수동으로 수정해보기 (총 3회 이상)

  • 목적: 클로드 코드 CLI에게 모든 것을 맡기지 않고, VS Code 편집기에서 내가 직접 파일을 열어 손으로 수정해보는 경험. 코드가 어떻게 구성되어 있는지 직접 눈으로 확인하고, 작은 부분이라도 스스로 고쳐보면 코드에 대한 두려움이 크게 줄어듭니다.
  • 진행 방법: 1. VS Code에서 프로젝트의 파일(HTML, CSS, JS 등) 중 하나를 직접 열기 2. 원하는 부분을 직접 타이핑하여 수정하기 (예: 글자 내용 바꾸기, 색상 값 변경, 버튼 텍스트 변경, 숫자 조정 등) 3. 저장(Ctrl+S / Cmd+S)한 후 개발서버에서 변경 사항이 반영되었는지 확인 4. 수정한 내용을 깃허브에 올리기
  • 3회 이상 직접 수정해볼 것
  • 잘 모르는 부분은 먼저 클로드 코드 CLI에게 "이 코드가 무슨 역할을 해?"라고 물어본 후 수정해보면 이해가 빨라집니다
💡 막히는 부분이 있다면

위 과정에서 막히는 부분은 모두 클로드 코드 CLI에게 질문하세요. "깃허브에 올리는 방법 알려줘", "clone이 뭐야", "수정한 파일만 다시 올리고 싶어" 등 자유롭게 물어보시면 됩니다.

5. 외부에서 노트북으로 같은 과제 다시 진행하기 (SSH + 화면 공유 도구 혼합 사용)

💫 왜 같은 과제를 다시 해야 하나요?

4항의 과제를 메인 PC에서 직접 했다면, 이번에는 집/사무실 밖에서 노트북으로 메인 PC에 원격 접속하여 같은 과제를 진행합니다. 이것이 2차 강의부터의 실제 사용 방식입니다. "어디서든 노트북 하나로 메인 PC의 클로드 코드 CLI를 사용할 수 있다"는 것을 직접 체험해보세요.

🔑 이 5항의 핵심 — SSH와 화면 공유 도구를 "혼합 사용" 합니다

5항의 모든 과제는 SSH 단독이 아니라 SSH + 화면 공유 도구(크롬 리모트 데스크탑 또는 맥 화면 공유)를 동시에 또는 번갈아 가며 사용하는 방식으로 진행하시는 것을 권장드립니다. 그래야 실전에서 부딪히는 다양한 상황을 모두 자연스럽게 처리할 수 있게 됩니다.

도구 적합한 작업 특징
🖥️ SSH (노트북 터미널 → 메인 PC 터미널) 클로드 코드 CLI로 텍스트 질문·코드 수정·git 명령 등 빠르고 가벼움. 평소의 메인 통로
⊞ 크롬 리모트 데스크탑 (노트북 Chrome → 메인 PC 화면 그대로) VS Code GUI·옵시디언 GUI·드래그앤드롭·개발서버 미리보기·시스템 알림 처리 등 시각적 작업에 필수. 보조 통로
🍎 맥 화면 공유(VNC) (맥 ↔ 맥 전용, Finder → 서버에 연결) 크롬 리모트 데스크탑과 동일한 역할 맥끼리라면 설치 불필요, 더 빠르고 키보드 완벽 호환

💡 맥 ↔ 맥 사용자: 이하 5항에서 "크롬 리모트 데스크탑"이라고 적힌 부분은 모두 "맥 화면 공유(VNC)"로 대체하여 읽으시면 됩니다. 역할과 사용 방식이 동일합니다.

권장 셋업: 5항을 진행하실 때는 노트북 화면에 두 개의 창을 동시에 띄워두세요. - 🅐 SSH 터미널 창 — 메인 PC의 클로드 코드 CLI 실행 중 - 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유 창 — 메인 PC 화면 그대로 표시

이렇게 두 창을 동시에 두고 "빠른 명령은 SSH로, 시각적 확인·드래그앤드롭은 화면 공유 도구로" 번갈아 쓰시는 것이 2차 강의에서 진짜 활용하실 표준 방식입니다. 🙂

가. 외부에서 메인 PC에 원격 접속하기 (SSH + 크롬 리모트 데스크탑 동시에 열기)

  • 목적: 카페·외출 등 집/사무실이 아닌 다른 장소에서 노트북으로 메인 PC에 두 가지 통로를 모두 열어두고, 이후 5항 나·다·라 과제를 두 통로를 혼합하며 진행하기 위한 사전 셋업
🔑 핵심 개념 — 절대 혼동하지 마세요!

❌ 아닙니다: 노트북의 터미널에서 노트북에 설치된 클로드 코드 CLI를 실행하는 것

✅ 맞습니다: 노트북의 터미널을 SSH 접속 통로로만 사용해서 내 메인 PC에 접속한 후, 그 상태에서 메인 PC의 터미널(= SSH 원격 세션)에서 메인 PC에 설치된 클로드 코드 CLI를 실행하는 것

즉, 실제로 돌아가는 클로드 코드 CLI는 메인 PC의 것이며, 노트북은 단지 그 화면을 보여주는 리모컨 역할만 합니다. 3항 Step 1·2에서 설정한 원격 접속 방식과 같은 원리이며, 다만 이번에는 다른 네트워크(외부)에서 접속한다는 점만 다릅니다.

그리고 5항부터는 SSH뿐 아니라 3항 Step 3에서 설정한 크롬 리모트 데스크탑(또는 맥 화면 공유)도 함께 사용하여, 시각적 작업까지 자연스럽게 처리합니다.

📋 구체적 진행 단계

사전 점검
  1. 외부 장소(카페 등)에서 노트북 켜고 인터넷 연결
  2. 메인 PC는 집/사무실에서 켜져 있는 상태여야 함 (3항 Step 4의 전원·절전·잠금 설정이 적용되어 있어야 함)
  3. 노트북과 메인 PC가 Tailscale로 연결되어 있는지 확인
  4. 노트북에 Chrome 브라우저가 설치되어 있고 메인 PC와 동일한 구글 계정으로 로그인되어 있는지 확인
🅐 통로 1 — SSH 접속 (텍스트 명령용 빠른 통로)
  1. 노트북에서 터미널 열기 (맥: 터미널 앱 / 윈도우: PowerShell 또는 Windows Terminal)
  2. 노트북 터미널에서 SSH 명령어로 메인 PC에 접속 (예: ssh 사용자명@메인PC이름) - 접속 방법이 기억나지 않으면 노트북의 클로드 코드 CLI에게 물어봐도 되지만, 실행할 명령어만 알려달라고 하고 클로드 코드 CLI 자체는 종료한 후 SSH 접속을 실행하세요
  3. SSH 접속이 성공하면, 노트북 터미널 화면 = 메인 PC의 원격 터미널이 됩니다 (프롬프트가 메인 PC의 사용자명으로 바뀜)
  4. 그 상태에서 claude 명령어를 입력하여 메인 PC에 설치된 클로드 코드 CLI를 원격으로 실행
  5. 이제부터 입력하는 모든 질문/요청은 메인 PC에서 처리되며, 옵시디언 기억장치·깃허브·VS Code 설정 등도 모두 메인 PC의 것을 그대로 사용하게 됩니다
🅑 통로 2 — 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC) 접속 (시각적 작업용 보조 통로)

🌐 크롬 리모트 데스크탑을 사용하는 경우 (윈도우 ↔ 맥, 윈도우 ↔ 윈도우 등):

  1. 노트북에서 Chrome 브라우저 새 창 열기
  2. https://remotedesktop.google.com 접속 → 메인 PC와 동일한 구글 계정으로 로그인
  3. "원격 액세스" 메뉴 → 원격 컴퓨터 목록에서 본인의 메인 PC 클릭
  4. 3항 Step 3-1에서 설정한 PIN 입력 → 접속

🍎 맥 화면 공유(VNC)를 사용하는 경우 (맥 ↔ 맥):

  1. 노트북에서 Finder 열기
  2. 상단 메뉴 → 이동 → 서버에 연결... (⌘ + K)
  3. vnc://메인PC의-Tailscale-IP 입력 → "연결" 클릭
  4. 메인 PC의 맥 사용자 이름·비밀번호 입력 → 접속

공통:

  1. 노트북 화면에 메인 PC의 화면이 그대로 나타나면 성공! 🎉
  2. 이제 노트북 화면에는 두 개의 창이 떠 있습니다:
    • 🅐 SSH 터미널 창 — 메인 PC의 클로드 코드 CLI 실행 중 (텍스트 작업)
    • 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유 창 — 메인 PC 화면 그대로 (시각적 작업)
  3. 두 창을 나란히 배치해두면 작업 효율이 두 배로 올라갑니다 (또는 가상 데스크탑 두 개에 각각 띄워두는 것도 좋음)
💡 막히면 이렇게 물어보세요

외출 전, 집에서 먼저 연습 삼아 노트북의 클로드 코드 CLI에게 이렇게 요청해두면 외부에서도 수월합니다:

📋 복사해서 쓰세요
외부에서 노트북으로 내 메인 PC에 두 가지 방식으로 동시에 접속하고 싶어. (1) 노트북 터미널로 SSH 접속하여 메인 PC의 클로드 코드 CLI를 원격으로 실행하는 방법, (2) 노트북 Chrome 브라우저로 크롬 리모트 데스크탑에 접속하여 메인 PC 화면을 그대로 보는 방법, 두 가지를 모두 단계별로 알려줘

나. 원격으로 클로드 코드 CLI에 다양한 질문/요청하기 (추가 30회 이상)

  • 목적: 원격 접속 환경에서도 클로드 코드 CLI를 자연스럽게 쓸 수 있는지 직접 확인. SSH 단독으로 처리되는 작업과, 화면 공유 도구(크롬 리모트 데스크탑 또는 맥 화면 공유)가 함께 필요한 작업의 차이를 손에 익히기.
  • 4항 가에서 했던 것과 동일하게, 이번에는 외부 → 노트북 → 메인 PC 경로로 클로드 코드 CLI에게 질문/요청. 30회 이상 시도하시되, 아래 두 통로를 혼합하여 진행하세요.

🅐 SSH 통로로 진행 (텍스트 위주 질문/요청)

  • 🅐 SSH 터미널 창의 클로드 코드 CLI에서 직접 진행:
  • 글로 된 질문 (예: "내 옵시디언 메모를 검색해서 ○○에 대해 알려줘")
  • 코드 수정 요청 (예: "메인 PC의 ○○ 파일에서 △△ 부분을 고쳐줘")
  • git·파일 시스템 명령
  • 빠르고 가벼우며, 평소 작업의 80% 이상을 차지하게 됩니다

🅑 크롬 리모트 데스크탑 또는 맥 화면 공유 통로로 진행 (시각적·드래그앤드롭 작업)

  • 🅑 크롬 리모트 데스크탑(또는 맥 화면 공유) 창에서 메인 PC 화면을 보면서, 메인 PC의 터미널이나 VS Code 안의 클로드 코드 CLI를 직접 사용:
  • 그림·스크린샷 붙여넣기 후 질문 (메인 PC에서 캡처하거나 노트북 화면을 캡처해 메인 PC 클립보드로 옮긴 후 붙여넣기)
  • 파일을 직접 드래그앤드롭으로 클로드 코드 CLI에 첨부
  • 메인 PC의 옵시디언·VS Code 등 다른 앱과 동시에 클로드 코드 CLI를 띄워놓고 작업
  • SSH로는 어렵거나 번거로운 작업들이 화면 공유 도구에서는 "메인 PC 앞에 앉아 있는 것과 똑같이" 자연스럽게 됩니다

30회의 권장 분배

  • 🅐 SSH로: 약 20회 이상 (텍스트·코드·명령 위주)
  • 🅑 크롬 리모트 데스크탑(또는 맥 화면 공유)으로: 약 10회 이상 (그림 첨부·파일 드래그·시각적 작업 위주)
  • 어느 통로가 어떤 작업에 편한지 직접 손에 익히는 것이 이 과제의 진짜 목적입니다 🙂

다. 원격으로 옵시디언 기억장치 활용하기 (SSH + 크롬 리모트 데스크탑 혼합)

  • 목적: 원격 접속 상태에서도 옵시디언 기억장치가 그대로 작동하는지 확인. 각 작업이 SSH 단독으로 가능한지, 화면 공유 도구(크롬 리모트 데스크탑 또는 맥 화면 공유)가 필요한지 직접 손으로 익히기.
  • 4항 나에서 한 것과 동일하게, 아래 항목 중 최소 2가지 이상 다시 시도하되, 각 작업의 성격에 맞는 통로를 선택해서 진행하세요.

🅐 SSH 통로로 가능한 작업 (텍스트·파일 명령 위주)

항목 SSH로 가능 여부 비고
(1) 대화를 옵시디언에 수동 저장 ✅ 가능 클로드 코드 CLI에게 "방금 대화를 옵시디언 ○○ 노트에 저장해줘"
(2) 자동 저장된 대화 세션 참조하여 요청 ✅ 가능 클로드 코드 CLI에게 파일 경로를 알려주거나 검색 요청
(3) 과거 대화를 클로드 코드 CLI가 직접 검색하여 활용 ✅ 가능 텍스트 기반이라 SSH가 가장 효율적
(4) 클로드 코드 CLI가 직접 옵시디언에 메모 작성 ✅ 가능 메인 PC 파일 시스템에 직접 쓰기

→ 위 (1)~(4)는 SSH 터미널 창의 클로드 코드 CLI로 진행하시는 것이 가장 빠르고 자연스럽습니다.

🅑 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC)가 필요한 작업 (시각적·드래그앤드롭)

항목 왜 화면 공유 도구가 필요한가
(5) 옵시디언 메모를 드래그앤드롭으로 참조시켜 요청 SSH 터미널은 GUI가 아니므로 "메모 파일을 마우스로 끌어서 클로드 창에 넣는" 동작 자체가 불가능. 메인 PC 화면을 그대로 보는 크롬 리모트 데스크탑(또는 맥 화면 공유) 창에서 옵시디언과 클로드 코드 CLI를 동시에 띄워두고 직접 드래그해야 함

→ 항목 (5)는 반드시 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유 창에서 진행하셔야 합니다. 메인 PC 화면을 보면서 옵시디언 메모를 마우스로 끌어 메인 PC의 클로드 코드 CLI 창에 넣으시면 됩니다.

권장 진행 방식

  • (1)~(4) 중 1가지 이상 → 🅐 SSH로 (각 추가 2회 이상)
  • (5) 1가지 → 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유로 (추가 2회 이상)
  • 즉, 두 통로를 모두 한 번씩 경험해보시는 것이 이 과제의 진짜 목적입니다 🙂
💡 두 통로의 차이를 직접 느껴보세요

똑같이 "옵시디언에 저장해줘" 라는 작업이라도, SSH로 텍스트 명령으로 처리할 때와 화면 공유 도구(크롬 리모트 데스크탑 또는 맥 화면 공유)로 메인 PC 화면을 직접 보면서 처리할 때의 속도·편함·시야 차이를 직접 느껴보세요. 어느 작업에는 어느 통로가 더 적합한지 손에 익히는 것이 5항 전체의 핵심입니다.

라. 원격으로 VS Code + 클로드 코드 CLI + 깃허브 작업 다시 해보기 (SSH + 크롬 리모트 데스크탑 혼합 사용)

  • 목적: 원격 환경에서도 개발·버전관리 흐름이 매끄러운지 확인하고, 2차 강의의 실제 사용 방식(SSH와 화면 공유 도구를 상황에 맞게 번갈아 쓰는 방식)에 익숙해지기
  • 대상: 4항 바에서 만든 본인 랜딩페이지를 원격으로 이어서 작업
🔑 왜 SSH만으로는 부족하고, 화면 공유 도구(크롬 리모트 데스크탑 / 맥 화면 공유)가 함께 필요한가요?

SSH는 "메인 PC의 터미널에 명령을 보내는 통로"입니다. 따라서 SSH 접속만으로는: - ✅ 터미널에서 클로드 코드 CLI 실행 → 코드 수정·git push 등 명령 작업: 모두 가능 - ❌ 메인 PC의 VS Code GUI(편집기 화면, 사이드바 파일 트리 등)를 노트북 화면에 띄우는 것: 불가능 - ❌ 메인 PC의 브라우저로 개발서버(localhost:3000 등)를 직접 미리보기: 불가능 - ❌ 메인 PC의 OAuth 인증 팝업·시스템 알림 처리: 불가능

이 "보이는 것"과 관련된 부분을 해결하는 게 바로 크롬 리모트 데스크탑(또는 맥 화면 공유)입니다. 두 도구는 서로 보완 관계이며, 실전에서는 두 가지를 동시에 또는 번갈아가며 사용하는 것이 가장 효율적입니다. 🖥️

📋 권장 작업 흐름 (SSH + 화면 공유 도구 혼합)

Step 1. 두 통로를 동시에 열어두기
  1. 노트북 터미널 창을 하나 열고 → SSH로 메인 PC 접속 (예: ssh 사용자명@메인PC이름) - 접속 후 SSH 세션에서 claude 명령으로 메인 PC의 클로드 코드 CLI 실행
  2. 노트북 Chrome 브라우저를 하나 열고 → https://remotedesktop.google.com 접속 → 메인 PC 선택 → 메인 PC 화면이 노트북에 그대로 표시됨
  3. 이제 노트북 화면에는 두 개의 창이 떠 있습니다: - 🅐 SSH 터미널 창 (메인 PC에서 돌아가는 클로드 코드 CLI) - 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유 창 (메인 PC의 화면 그대로)
Step 2. SSH 창에서 클로드 코드 CLI로 코드 작업
  • SSH 터미널의 클로드 코드 CLI에게 요청:
  • "내 랜딩페이지에 새 섹션을 추가해줘"
  • "버튼 색상을 ○○로 바꿔줘"
  • "이 부분 글자를 △△로 수정해줘" 등
  • 클로드 코드 CLI가 메인 PC의 파일을 직접 수정합니다 (빠르고 가벼움)
Step 3. 화면 공유 도구 창에서 결과를 눈으로 확인
  • 메인 PC 화면에서 VS Code를 직접 열어 클로드가 수정한 코드를 시각적으로 확인
  • 또는 메인 PC의 브라우저로 localhost:○○○○(개발서버) 을 열어 수정된 랜딩페이지를 직접 미리보기
  • "디자인이 잘 적용됐는지, 버튼이 잘 작동하는지" 같은 시각적 검증은 화면 공유 도구가 가장 편합니다
Step 4. 본인이 직접 손으로 수정해보기 (선택)
  • 시각적 확인 후 추가로 손볼 부분이 있으면, 화면 공유 도구 창에서 메인 PC의 VS Code를 직접 클릭·타이핑하여 수정 가능
  • 또는 다시 SSH 창의 클로드 코드 CLI에게 요청해도 됩니다 (둘 중 편한 방식 선택)
Step 5. 깃허브에 올리기 (다시 SSH 창)
  • SSH 터미널의 클로드 코드 CLI에게 "수정한 내용을 깃허브에 올려줘" 라고 요청
  • 또는 화면 공유 도구 창의 VS Code에서 직접 commit·push도 가능
Step 6. 깃허브 사이트에서 수정 내용 반영 확인
  • 노트북의 일반 브라우저(또는 화면 공유 도구의 메인 PC 브라우저)에서 깃허브 저장소를 열어 변경사항이 잘 올라갔는지 확인
💡 SSH vs 화면 공유 도구(크롬 리모트 데스크탑 / 맥 화면 공유) — 작업별 추천 도구
작업 추천 도구 이유
코드 수정 요청 (클로드에게 말하기) SSH 빠르고 가벼움
git push·pull·status 같은 명령 SSH 터미널이 가장 빠름
파일 트리 보기·여러 파일 동시 편집 화면 공유 도구 (VS Code GUI) GUI가 더 편함
개발서버 미리보기 (localhost:○○○○) 화면 공유 도구 SSH로는 브라우저를 못 띄움
OAuth 인증 팝업·시스템 알림 처리 화면 공유 도구 클릭이 필요하므로
메인 PC의 다른 앱(옵시디언 등) 동시 작업 화면 공유 도구 화면이 보여야 함

💡 위 "화면 공유 도구" = 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC) (맥 ↔ 맥 사용자)

결론: "빠른 명령 작업은 SSH, 보이는 작업은 화면 공유 도구". 두 창을 동시에 띄워두고 번갈아가며 쓰시는 것이 2차 강의에서 진짜 활용하실 표준 방식입니다. 🙂

📌 제외 항목 (다시 하지 않아도 되는 과제)
  • 텔레그램 봇 연결: 이미 메인 PC에 1회만 하면 되므로 다시 할 필요 없음
  • 텔레그램 봇으로 휴대폰 질문 / 동기와 단체톡방: 이미 핸드폰으로 하는 과제이므로 외부에서 하는 것과 동일
⭐ 2차 강의부터는 이 방식으로 진행합니다

2차 강의부터는 실제로 노트북으로 자신의 메인 PC에 접속하여 클로드 코드 CLI를 사용하며, MCP, API, 스킬 등을 배우게 됩니다. 반드시 이 과제를 완료해 주세요.

6. 2차 강의 준비사항

⚠️ 준비사항 미완료 시 주의

아래 준비사항을 모두 완료하지 않고 2차 강의에 참석하시면, 1차 강의에서 그랬던 것처럼, 준비하는 과정으로 상당한 시간을 소진하게 되므로, 자신과 다른 수강생분들을 위해서 꼭 미리 준비 부탁드립니다.

가. Google OAuth 클라이언트 ID 발급 (완전 무료)

  • 목적: 2차 강의에서 클로드 코드 CLI가 여러분의 구글 드라이브·구글 문서·캘린더 등 구글 서비스에 직접 접속하여 파일을 생성·수정·관리할 수 있게 연결하기 위해 필요합니다.
  • 사이트: https://console.cloud.google.com/
⚠️ 단순히 "OAuth 클라이언트 ID 하나 만들기"가 아닙니다 (꼼꼼히 읽어주세요)

Google OAuth는 그냥 클라이언트 ID만 발급받는 게 아니라, 구글 쪽에 미리 해두어야 할 사전 작업이 여러 개 있습니다. 이 중 하나라도 빠뜨리면 2차 강의에서 MCP 연결이 "작동을 안 하거나 권한 오류가 나는" 상황이 생깁니다.

어렵진 않습니다. 아래 순서대로 한 번만 차근차근 따라 해주시면 됩니다. 😊

📋 진행 단계 (이 순서 그대로)

Step 1. Google Cloud 프로젝트 생성
  • https://console.cloud.google.com/ 접속, 본인 구글 계정 로그인
  • 상단 좌측의 프로젝트 선택 드롭다운(현재 프로젝트 이름이 표시된 부분) 클릭
  • 팝업 창이 열리면 오른쪽 위의 "새 프로젝트(New Project)" 버튼 클릭
  • 프로젝트 이름은 자유 (예: claude-cli-project)
  • 위치(Location)는 "조직 없음(No organization)" 으로 두어도 괜찮습니다
  • "만들기(Create)" 클릭
  • 생성 후 상단 좌측에서 그 프로젝트가 선택된 상태인지 꼭 확인해주세요
💡 이미 Google Cloud에 다른 프로젝트가 있으신 분은?

걱정하지 마세요. 기존 프로젝트는 그대로 두고, 이번 강의용으로 새 프로젝트를 하나 더 만드시면 됩니다. Google Cloud는 한 계정에 여러 개의 프로젝트를 자유롭게 생성할 수 있습니다 (무료).

새 프로젝트 추가 방법: 1. 상단 좌측의 프로젝트 선택 드롭다운 클릭 (현재 보이는 프로젝트 이름 옆) 2. 팝업 창 오른쪽 위의 "새 프로젝트(New Project)" 버튼 클릭 3. 새 프로젝트 이름 입력 (예: claude-cli-project) 4. "만들기" 클릭 5. 생성된 새 프로젝트를 꼭 선택한 상태로 이후 단계를 진행

⭐ 가장 흔한 실수: 새 프로젝트를 만들어놓고 기존 프로젝트가 선택된 상태에서 API를 활성화하거나 OAuth 설정을 하는 경우입니다. 상단 좌측에 "방금 만든 새 프로젝트 이름"이 보이는지 꼭 확인해 주세요!

💡 왜 기존 프로젝트를 쓰지 않고 새로 만드나요? - 기존 프로젝트와 설정·권한·결제가 섞이지 않도록 분리하기 위함입니다 - 나중에 강의용 설정을 지우거나 관리하기도 훨씬 편합니다 - 기존 프로젝트에 영향을 주지 않아 안전합니다

Step 2. 사용할 구글 서비스 API "활성화" (⭐ 매우 중요!)
  • 좌측 메뉴 → "API 및 서비스" → "라이브러리" 이동
  • 2차 강의에서 쓸 구글 서비스를 모두 검색해서 "사용 설정" 버튼 클릭
  • 최소한 아래 API들은 꼭 활성화해 주세요:
서비스 API 이름 용도
구글 드라이브 Google Drive API 파일 저장·관리
구글 문서 Google Docs API 문서 생성·편집
구글 스프레드시트 Google Sheets API 엑셀 같은 표 데이터
구글 캘린더 Google Calendar API 일정 관리
지메일 Gmail API 이메일 읽기·보내기
💡 "일단 이 5개는 다 켜두세요"

써보고 싶은 서비스가 있으면 미리 켜두시는 게 좋습니다. 나중에 "아, 이것도 켜야 했구나" 하고 다시 찾아가는 것보다 훨씬 편합니다. 켜두어도 비용은 발생하지 않습니다.

Step 3. OAuth 동의 화면 (Consent Screen) 설정
  • 좌측 메뉴 → "API 및 서비스" → "OAuth 동의 화면" 이동
  • User Type: "외부(External)" 선택 → "만들기"
  • 앱 정보 입력:
  • 앱 이름: 자유 (예: 내 Claude CLI 앱)
  • 사용자 지원 이메일: 본인 구글 이메일
  • 개발자 연락처 정보: 본인 구글 이메일
  • 나머지 (로고·도메인 등)는 비워두어도 됩니다
  • 범위(Scopes) 추가: "범위 추가 또는 삭제" 버튼 클릭
  • Step 2에서 활성화한 API들의 범위를 모두 체크하여 추가
  • (예: Drive, Docs, Sheets, Calendar, Gmail 각각의 권한)
  • 잘 모르겠으면 "일단 다 체크" 하셔도 괜찮습니다
Step 4. 테스트 사용자(Test users) 등록 (⭐ 절대 빠뜨리면 안 됩니다!)
  • OAuth 동의 화면 설정 중 "테스트 사용자" 섹션에서 "+ ADD USERS" 클릭
  • 본인 구글 이메일 주소를 추가합니다
  • 이 단계를 빠뜨리면 "앱이 확인되지 않았습니다 / 접근 거부됨" 오류로 MCP 연결이 안 됩니다
🚨 테스트 사용자 등록은 필수 중의 필수!

앱이 "게시(Published)" 상태가 아닌 "테스트(Testing)" 상태로 시작되기 때문에, 등록된 테스트 사용자만 해당 앱을 사용할 수 있습니다. 본인 이메일을 꼭 테스트 사용자로 추가해주세요.

Step 5. OAuth 2.0 클라이언트 ID 생성
  • 좌측 메뉴 → "API 및 서비스" → "사용자 인증 정보" 이동
  • 상단 "+ 사용자 인증 정보 만들기" → "OAuth 클라이언트 ID" 클릭
  • 애플리케이션 유형: "데스크톱 앱(Desktop app)" 선택 (⭐ 이게 중요)
  • 이름은 자유 (예: Claude CLI Desktop)
  • 생성 버튼 클릭
Step 6. 클라이언트 ID / 시크릿 저장 (⭐ 반드시!)
  • 생성된 클라이언트 ID와 클라이언트 시크릿을 복사
  • 반드시 안전한 곳에 따로 저장해 둡니다 (아래 상자 참고)
  • 또는 JSON 파일로 다운로드 가능 — 다운로드해서 옵시디언 기억장치 폴더에 저장
🔐 매우 중요 — 클라이언트 ID / 시크릿 저장은 필수!

발급받은 클라이언트 ID와 클라이언트 시크릿은 반드시 안전한 곳에 따로 저장해 주세요. 저장을 놓치면 2차 강의에서 구글 드라이브 연결을 할 수 없습니다.

저장 추천 장소: - 🥇 옵시디언 기억장치(볼트) 안의 별도 노트 — 1순위 추천. 1차 강의에서 만든 기억장치를 활용하세요. - 비밀번호 관리 앱 (1Password, Bitwarden, Apple 키체인 등) - 메모 앱 중 안전하게 동기화되는 곳 - ❌ 카카오톡 나와의 채팅·공개 메모 등은 피해주세요 (보안상)

💡 저장 방법이 잘 모르시면 클로드 코드 CLI에게 이렇게 물어보세요:

📋 복사해서 쓰세요
방금 발급받은 Google OAuth 클라이언트 ID와 시크릿을 옵시디언 기억장치에 안전하게 저장하고 싶어. 어떻게 해야 할지 알려주고, 네가 직접 저장까지 해줘

⚠️ 2차 강의에서 꼭 필요합니다: 2차 강의 당일, 본인이 발급받은 클라이언트 ID와 시크릿이 어디에 저장되어 있는지 즉시 꺼내 쓸 수 있어야 강의 진행이 가능합니다. 저장 위치를 못 찾으시면 그 부분 실습을 진행하실 수 없어요. 꼭 꼼꼼히 챙겨주세요. 🙏

💰 비용 안내

Google Cloud Console 가입, 프로젝트 생성, API 활성화, OAuth 동의 화면 설정, 클라이언트 ID 발급, 사용 모두 완전 무료입니다. 결제 등록도 필요 없습니다. 안심하고 진행하세요.

💡 위 단계가 복잡해 보이시나요?

어려우시면 노트북 또는 메인 PC의 클로드 코드 CLI에게 이렇게 물어보시면 단계별로 친절하게 안내받을 수 있습니다:

📋 복사해서 쓰세요
Google Cloud Console에서 클로드 코드 CLI용 OAuth 클라이언트 ID를 발급받고 싶어. 프로젝트 생성, API 활성화(Drive·Docs·Sheets·Calendar·Gmail), OAuth 동의 화면 설정, 테스트 사용자 등록, 데스크톱 앱 클라이언트 ID 생성까지 전 과정을 단계별로 알려줘. 내가 뭘 클릭하고 뭘 입력해야 하는지 초등학생도 이해할 수 있게 쉽게 설명해줘

나. Google Nano Banana Pro 이미지 생성 AI API 발급 + 결제 등록

  • 목적: 2차 강의에서 클로드 코드 CLI로 AI 이미지를 생성하는 방법을 배우기 위해, 구글의 이미지 생성 AI API 키가 필요합니다.
  • 2차 강의에서는 Nano Banana Pro를 사용합니다.

Google 이미지 생성 AI 모델 정리 (Google 공식 문서 기준)

별칭 (닉네임) 정식 모델명 모델 ID 공식 설명
Nano Banana Gemini 2.5 Flash Image gemini-2.5-flash-image 속도/효율 최적화, 1024px, 저지연 고볼륨 작업용
Nano Banana 2 Gemini 3.1 Flash Image Preview gemini-3.1-flash-image-preview Pro의 고효율·저비용 대응 모델 (high-volume, lower price-point equivalent). 품질과 성능의 균형, 메인스트림 가격대
Nano Banana Pro ⭐ Gemini 3 Pro Image Preview gemini-3-pro-image-preview Google 공식 문서 원문: "our highest quality image generation model" (최고 품질). 스튜디오급 정밀도, 고해상도 텍스트 렌더링, Google 검색 기반 실제 세계 반영(grounding), Thinking 기능, 최대 4K
📌 공식 문서 원문 인용 (https://ai.google.dev/gemini-api/docs/gemini-3)

"Nano Banana Pro (also known as Gemini 3 Pro Image) is our highest quality image generation model, and Nano Banana 2 (also known as Gemini 3.1 Flash Image) is the high-volume, high-efficiency, lower price-point equivalent."

번역: "Nano Banana Pro(별칭 Gemini 3 Pro Image)는 당사의 최고 품질 이미지 생성 모델이며, Nano Banana 2(별칭 Gemini 3.1 Flash Image)는 고볼륨·고효율의 저비용 대응 모델입니다."

📌 한글(Korean) 지원 — Google 공식 문서 원문 (https://ai.google.dev/gemini-api/docs/image-generation)

"The service works best with the following languages: English, Arabic (Egypt), German (Germany), Spanish (Mexico), French (France), Hindi (India), Indonesian, Italian, Japanese, Korean, Portuguese (Brazil), Russian, Ukrainian, Vietnamese, and Simplified Chinese."

번역: "이 서비스는 다음 언어에서 가장 잘 작동합니다: 영어, 아랍어(이집트), 독일어(독일), 스페인어(멕시코), 프랑스어(프랑스), 힌디어(인도), 인도네시아어, 이탈리아어, 일본어, 한국어, 포르투갈어(브라질), 러시아어, 우크라이나어, 베트남어, 중국어(간체)."

→ Nano Banana 시리즈 전 모델(Pro, 2, 2.5 Flash)이 한국어를 공식 지원합니다. 다만 텍스트 렌더링 품질은 모델마다 차이가 있습니다.

  • Nano Banana Pro: "high-fidelity text rendering"(고정밀 텍스트 렌더링) 명시 — 한글 텍스트가 이미지 안에 들어갈 때 가장 정확
  • Nano Banana 2: 메인스트림 가격대에서 품질·성능 균형

💰 이미지 1장당 실제 가격 (Google 공식 문서 기준)

📌 적용 환율 (2026-04-03 기준)

1 USD = 1,511.07원 (exchangerate-api.com 기준) ※ 원화 금액은 위 환율로 계산한 대략적인 참고치이며, 실제 청구 시점의 환율·Google 청구 방식에 따라 다소 달라질 수 있습니다.

모델 해상도 달러/장 원화/장 (약)
Nano Banana 2 (Gemini 3.1 Flash Image Preview) 0.5K (512px) $0.045 약 68원
Nano Banana 2 1K (1024×1024) — 기본값 $0.067 약 101원
Nano Banana 2 2K (2048×2048) $0.101 약 153원
Nano Banana 2 4K (4096×4096) $0.151 약 228원
Nano Banana Pro ⭐ (Gemini 3 Pro Image Preview) 1K (기본값) $0.134 약 202원
Nano Banana Pro 2K · 4K 1K 대비 상승 (고해상도일수록 증가)
Nano Banana (Gemini 2.5 Flash Image) 1K 고정 (1024px) (Free Tier 제공, Paid 시 별도 요금) —
💡 2차 강의 실습 기준 예상 비용

2차 강의에서는 Nano Banana Pro 1K 기본값으로 실습합니다 (장당 약 202원).

  • 강의 중 10장 생성 시: 약 2,020원
  • 집에서 연습 100장 생성 시: 약 20,200원 (월 2만원 수준)
  • 고해상도(2K·4K)는 더 비쌉니다 — 필요할 때만 사용 권장

개인 학습용으로는 월 몇천 원에서 1~2만원 수준이면 충분히 넉넉하게 쓸 수 있습니다. 🙂

(1) Nano Banana Pro — ⭐ 2차 강의에서 사용할 모델 (발급 단계)

  • 모델 정식 명칭·별칭·특징: 위 "모델 정리 표" 참조
  • API 키 발급 사이트: https://aistudio.google.com
  • 결제 등록 사이트: https://console.cloud.google.com/
⚠️ 단순히 "API 키 하나 발급"이 아닙니다 (꼼꼼히 읽어주세요)

Nano Banana Pro는 "유료 모델(Paid Tier 전용)"입니다. 단순히 API 키만 발급받으면 무료 티어(Free Tier)에 머물러 있기 때문에, 2차 강의에서 클로드 코드 CLI가 이미지 생성을 시도해도 "권한 없음 / 쿼터 초과 / 해당 모델 사용 불가" 오류가 발생합니다.

그래서 아래 단계를 반드시 순서대로 모두 완료하셔야 합니다: 1. API 키 발급 (AI Studio) 2. Google Cloud Console에서 같은 프로젝트에 결제 계정(Billing Account) 연결 3. Paid Tier로 전환되었는지 확인 ⭐ 이 확인이 없으면 실전에서 오류가 납니다

어렵진 않습니다. 아래 순서대로 한 번만 차근차근 따라 해주시면 됩니다. 😊

📋 진행 단계 (이 순서 그대로)

Step 1. Google AI Studio에서 API Key 발급
  • https://aistudio.google.com 접속, 본인 구글 계정 로그인
  • 상단 또는 좌측의 "Get API Key" 버튼 클릭
  • "API 키 만들기(Create API Key)" 클릭
  • 프로젝트 선택 화면이 나옵니다:
  • 🥇 추천: 섹션 6.가에서 만든 OAuth 프로젝트를 그대로 선택 (관리 편리)
  • 또는 새 프로젝트 생성도 가능
  • API Key가 생성되어 화면에 표시됩니다 — 이 화면에서 바로 복사하여 저장해주세요!
  • 💡 키는 한 번 창을 닫으면 다시 전체가 표시되지 않습니다. 잃어버리면 새로 발급받아야 해요.
Step 2. Google Cloud Console에서 결제 계정(Billing Account) 만들기
  • https://console.cloud.google.com/ 접속, 동일한 구글 계정으로 로그인
  • 상단 좌측에서 Step 1에서 선택한 프로젝트가 맞는지 확인
  • 좌측 메뉴 → "결제(Billing)" 이동
  • 결제 계정이 없으면 "결제 계정 만들기(Create Billing Account)" 클릭
  • 안내에 따라 국가·연락처 입력, 그리고 신용/체크카드 정보 입력
  • 결제 계정 이름은 자유 (예: 내 개인 결제 계정)
💰 카드 등록 = 즉시 과금 아닙니다

카드를 등록한다고 바로 돈이 빠져나가지는 않습니다. 사용한 만큼만 월말에 청구됩니다. Nano Banana Pro는 이미지 한 장당 몇백 원 정도라 개인 학습용으로는 큰 부담이 없습니다.

Step 3. 프로젝트에 결제 계정 연결 (Link Billing Account)
  • 좌측 메뉴 → "결제(Billing)" → "내 프로젝트" 또는 "계정 관리"
  • Step 1에서 선택한 프로젝트 옆에 "결제 사용 설정" 또는 "결제 계정 연결" 버튼 클릭
  • Step 2에서 만든 결제 계정을 "연결"
💡 확인 방법

좌측 메뉴 → "결제" 진입 시 "이 프로젝트에 연결된 결제 계정: ○○○" 이 보이면 연결 완료입니다.

Step 4. Generative Language API 활성화
  • 좌측 메뉴 → "API 및 서비스" → "라이브러리" 이동
  • 검색창에 "Generative Language API" 입력
  • 결과 클릭 → "사용 설정(Enable)" 버튼 클릭
  • (이미 활성화되어 있으면 "이미 사용 설정됨"으로 표시됩니다)
📌 이 API가 꼭 필요한 이유

Nano Banana Pro (gemini-3-pro-image-preview)를 포함한 Gemini 모델 API는 Generative Language API를 통해 동작합니다. 이 API가 꺼져 있으면 키가 있어도 이미지 생성 요청이 실패합니다.

Step 5. ⭐ Paid Tier 전환 확인 (이 단계가 제일 중요합니다!)
  • https://aistudio.google.com 으로 돌아가기
  • 좌측 또는 우측 상단의 "Get API Key" 또는 "API Keys" 메뉴로 이동
  • 본인의 API Key 옆에 표시된 "Plan" 또는 "Tier" 확인
  • 처음에는 "Free" 로 표시되지만, Step 2~3을 완료하면 "Paid" 로 자동 전환됩니다
  • 아직 "Free"로 표시된다면:
  • 결제 계정이 제대로 연결되지 않은 상태 → Step 3 다시 확인
  • 또는 몇 분 기다린 후 새로고침 (반영에 시간이 걸릴 수 있음)
  • ✅ "Paid"로 전환되어야만 Nano Banana Pro(gemini-3-pro-image-preview)를 사용할 수 있습니다
🚨 Paid Tier 전환이 안 되어 있으면 2차 강의에서 바로 오류가 납니다

"Free" 상태로 2차 강의에 오시면, 클로드 코드 CLI가 이미지 생성을 시도할 때 "This model requires paid tier" / "권한 없음" / "할당량 초과" 류의 오류가 발생합니다. 반드시 "Paid"로 바뀐 것을 눈으로 확인해 주세요.

Step 6. API Key 저장 (⭐ 반드시!)
  • Step 1에서 복사한 API Key를 안전한 곳에 따로 저장 (아래 상자 참고)
📌 실제 이미지 생성 동작 테스트는 2차 강의에서 진행합니다

Step 1~6까지 완료되었다면 준비는 끝입니다. 실제로 Nano Banana Pro API Key로 이미지가 잘 만들어지는지 테스트해보는 실습은 2차 강의 시간에 함께 진행할 예정이니 여기서는 설정만 완료해 주세요.

🔐 매우 중요 — API Key 저장은 필수!

발급받은 Nano Banana Pro API Key는 반드시 안전한 곳에 따로 저장해 주세요. (나중에 Nano Banana 2도 사용하실 분은 그 API Key도 동일하게 저장) 저장을 놓치면 2차 강의에서 AI 이미지 생성 실습을 진행하실 수 없습니다.

저장 추천 장소: - 🥇 옵시디언 기억장치(볼트) 안의 별도 노트 — 1순위 추천. OAuth 정보와 같은 노트에 모아두시면 관리가 편합니다. - 비밀번호 관리 앱 (1Password, Bitwarden, Apple 키체인 등) - ❌ 카카오톡 나와의 채팅·공개 메모 등은 피해주세요 (API Key는 노출되면 누군가 몰래 써서 요금이 발생할 수 있어요!)

💡 저장 방법이 잘 모르시면 클로드 코드 CLI에게 이렇게 물어보세요:

📋 복사해서 쓰세요
방금 발급받은 Google Nano Banana Pro API Key를 옵시디언 기억장치에 안전하게 저장하고 싶어. 어떻게 해야 할지 알려주고, 네가 직접 저장까지 해줘

⚠️ 2차 강의에서 꼭 필요합니다: 2차 강의 당일, 본인이 발급받은 API Key가 어디에 저장되어 있는지 즉시 꺼내 쓸 수 있어야 강의 진행이 가능합니다. 저장 위치를 못 찾으시면 AI 이미지 생성 실습을 진행하실 수 없어요. 꼭 꼼꼼히 챙겨주세요. 🙏

💰 비용 안내
  • API 키 발급 자체: 무료
  • 무료 사용량(Free Tier): Nano Banana Pro는 Free Tier에서는 사용 불가합니다. 반드시 Paid Tier로 전환되어야만 사용할 수 있습니다.
  • 결제 등록: 결제 수단을 등록하는 것은 필수지만, 등록 = 즉시 과금이 아닙니다. 실제로 여러분이 이미지를 생성한 만큼만 월말에 청구됩니다.
  • 실제 비용 감각: 개인 학습·시범 용도로는 월 몇천 원 수준이면 충분한 경우가 대부분입니다. (이미지 한 장당 대략 몇백 원)
💡 위 단계가 복잡해 보이시나요?

어려우시면 노트북 또는 메인 PC의 클로드 코드 CLI에게 이렇게 물어보시면 단계별로 친절하게 안내받을 수 있습니다:

📋 복사해서 쓰세요
Google Nano Banana Pro(gemini-3-pro-image-preview) API를 클로드 코드 CLI에서 사용하고 싶어. AI Studio에서 API Key 발급, Google Cloud Console에서 결제 계정 만들고 프로젝트에 연결, Generative Language API 활성화, Paid Tier 전환 확인까지 전 과정을 단계별로 알려줘. 내가 뭘 클릭하고 뭘 입력해야 하는지 초등학생도 이해할 수 있게 쉽게 설명해줘. 그리고 마지막에는 실제로 이미지 한 장 생성되는지 테스트까지 해줘

(2) Nano Banana 2 — 선택사항 (참고)

  • 모델 정식 명칭·특징: 위 "모델 정리 표" 참조 (Pro의 고효율·저비용 대응 모델)
  • 같은 https://aistudio.google.com 에서 API 키 하나로 두 모델 모두 사용 가능 (별도 발급 불필요)
  • 더 저렴한 가격으로 많은 이미지를 생성하고 싶은 분에게 적합
💡 선택사항입니다

2차 강의는 Nano Banana Pro로 진행됩니다. Nano Banana 2는 선택적으로 사용하시면 됩니다. 더 저렴한 가격·빠른 속도로 이미지 생성을 원하시는 분만 추가로 사용해보세요. (한글 텍스트 렌더링 품질은 공식 문서상 Nano Banana Pro가 더 높습니다.)

다. 네이버 검색 API 발급 (완전 무료)

  • 목적: 2차 강의에서 클로드 코드 CLI가 한국어 웹·뉴스·블로그·카페·책·영화·쇼핑 등 네이버 검색 결과를 직접 가져와서 답변에 활용할 수 있도록 연결하기 위해 필요합니다. (한국어·한국 콘텐츠 검색에 가장 강력)
  • 사이트: https://developers.naver.com/
⚠️ 단순히 "API 하나 발급"이 아닙니다 (꼼꼼히 읽어주세요)

네이버 검색 API는 네이버 개발자 센터에서 "애플리케이션 등록"이라는 절차를 거쳐 Client ID와 Client Secret을 발급받는 방식입니다. 단순히 "API 키 하나 받는 것"이 아니라, 앱을 등록하고 사용할 API를 선택하고 환경(사용 영역)을 설정해야 합니다.

어렵진 않습니다. 아래 순서대로 한 번만 차근차근 따라 해주시면 됩니다. 😊

📋 진행 단계 (이 순서 그대로)

Step 1. 네이버 개발자 센터 접속 및 로그인
  • https://developers.naver.com/ 접속
  • 상단 우측 "로그인" 클릭 → 본인의 네이버 계정으로 로그인
  • 네이버 계정이 없으시면 먼저 https://www.naver.com 에서 무료 회원가입
Step 2. 애플리케이션 등록
  • 상단 메뉴 → "Application" → "애플리케이션 등록" 클릭
  • 또는 직접 이동: https://developers.naver.com/apps/#/register
  • 애플리케이션 이름 입력 (자유, 예: 내 Claude CLI 검색)
Step 3. 사용 API 선택 — "검색" 체크
  • 아래로 내려가면 "사용 API" 항목이 있습니다
  • "검색" 을 찾아서 체크
  • (필요하시면 "지도", "파파고 번역" 등 다른 API도 같이 체크 가능 — 모두 무료)
  • 이 단계가 빠지면 발급받은 키로 검색이 작동하지 않습니다
Step 4. 환경 설정 (사용 영역)
  • "비로그인 오픈 API 서비스 환경" 추가
  • "WEB 설정" 선택
  • 웹 서비스 URL: http://localhost 입력 (CLI 사용이라 실제 웹사이트 없어도 OK)
  • "등록하기" 클릭
Step 5. Client ID / Client Secret 확인 및 복사
  • 등록이 완료되면 "내 애플리케이션" 목록으로 이동됩니다
  • 방금 등록한 앱을 클릭하면 "Client ID"와 "Client Secret"이 표시됩니다
  • Client Secret은 기본적으로 가려져 있으니 "보기" 버튼 클릭하여 확인
  • 두 값을 모두 복사하여 안전한 곳에 저장해 주세요
🔐 매우 중요 — Client ID / Client Secret 저장은 필수!

발급받은 네이버 Client ID와 Client Secret은 반드시 안전한 곳에 따로 저장해 주세요. 저장을 놓치면 2차 강의에서 네이버 검색 연결 실습을 진행하실 수 없습니다.

저장 추천 장소: - 🥇 옵시디언 기억장치(볼트) 안의 별도 노트 — 1순위 추천. OAuth·Nano Banana Pro 정보와 같은 노트에 모아두시면 관리가 훨씬 편합니다. - 비밀번호 관리 앱 (1Password, Bitwarden, Apple 키체인 등) - ❌ 카카오톡 나와의 채팅·공개 메모 등은 피해주세요 (보안상)

💡 저장 방법이 잘 모르시면 클로드 코드 CLI에게 이렇게 물어보세요:

📋 복사해서 쓰세요
방금 발급받은 네이버 검색 API의 Client ID와 Client Secret을 옵시디언 기억장치에 안전하게 저장하고 싶어. 어떻게 해야 할지 알려주고, 네가 직접 저장까지 해줘

⚠️ 2차 강의에서 꼭 필요합니다: 2차 강의 당일, 본인이 발급받은 Client ID와 Secret이 어디에 저장되어 있는지 즉시 꺼내 쓸 수 있어야 강의 진행이 가능합니다. 저장 위치를 못 찾으시면 네이버 검색 실습을 진행하실 수 없어요. 꼭 꼼꼼히 챙겨주세요. 🙏

💰 비용 안내
  • 발급: 완전 무료
  • 사용량: 네이버 검색 API는 일일 25,000건 무료 제공 (개인 학습·업무용으로는 충분히 넉넉합니다)
  • 초과 시: 유료 전환이 아닌 그날의 호출이 제한되는 방식 (다음 날 0시에 자동 초기화)
  • 즉, 결제 수단 등록 불필요 — 말 그대로 완전 무료로 쓸 수 있습니다
💡 위 단계가 복잡해 보이시나요?

어려우시면 노트북 또는 메인 PC의 클로드 코드 CLI에게 이렇게 물어보시면 단계별로 친절하게 안내받을 수 있습니다:

📋 복사해서 쓰세요
네이버 개발자 센터(https://developers.naver.com)에서 클로드 코드 CLI용 검색 API를 발급받고 싶어. 애플리케이션 등록, 사용 API 선택(검색), 환경 설정(비로그인 오픈 API, 웹 서비스 URL), Client ID/Secret 확인까지 전 과정을 단계별로 알려줘. 내가 뭘 클릭하고 뭘 입력해야 하는지 초등학생도 이해할 수 있게 쉽게 설명해줘

라. Brave 검색 API 발급 ⚠️ (2026년 2월 요금 체계 변경 — 꼭 읽어주세요)

  • 목적: 2차 강의에서 클로드 코드 CLI가 영문·글로벌 웹 검색 결과를 직접 가져와 답변에 활용할 수 있도록 연결하기 위해 필요합니다. (Google 검색의 대안이며, 프라이버시 중심 검색 엔진입니다)
  • 사이트: https://brave.com/search/api/
  • 참고 가이드(동기 최** 작성): (1. 기초) Brave Search API 가입·결제 완전 가이드 (최**) ← 본 항목은 위 가이드를 요약·통합한 것이며, 결제가 막히시면 반드시 원문을 참조해주세요.
⚠️ 2026년 2월부터 요금 체계가 완전히 바뀌었습니다

예전 자료에 있던 "월 2,000회 완전 무료" 는 더 이상 해당되지 않습니다. Brave가 기존 무료 플랜을 폐지하고 크레딧 기반 과금 시스템으로 전환했기 때문입니다.

  • 신용카드 등록 필수 — 악성 사용자 방지(본인 확인) 목적
  • 완전 무료 플랜 폐지, 크레딧 기반 과금으로 전환
  • 매달 $5 무료 크레딧 자동 지급(약 1,000회 쿼리 분량)
  • 무료 크레딧 $5를 초과하면 등록한 카드에서 실제 결제
  • 무료 크레딧 유지 조건: 프로젝트 공개 배포 시 "Brave Search API 사용" 표시(attribution)

👉 개인 실습·강의 과제 수준에서는 월 1,000회를 넘길 일이 거의 없으므로 사실상 무료로 쓰실 수 있습니다. 다만 카드는 "실제 결제 수단"이므로 아래 Step 5의 Usage Limit 설정을 반드시 해주세요.

⭐ 결제는 "노트북"이 아니라 "폰"에서 하세요 (가장 중요!)

한국 카드사 보안프로그램(IPinside LWS) 때문에 맥·윈도우 노트북 브라우저에서는 결제가 구조적으로 막히거나 함정이 많습니다. 아이폰 사파리 또는 안드로이드 크롬으로 진행하시면 대부분 10분 안에 끝납니다.

플랫폼 상황 권장
🍎 맥 (특히 Apple Silicon) IPinside가 Intel x86 전용 → Rosetta 2 필요 + 인증서 누락으로 구조적 실패 곧바로 폰으로 우회
⊞ 윈도우 10/11 IPinside 네이티브 지원이지만 크롬 142+ 호환·이전 Agent 잔여물 등 함정 3~4개 10~15분 시도 후 안 되면 폰으로
📱 아이폰 사파리 / 안드로이드 크롬 보안프로그램 개입 없음 가장 확실한 방법

📋 진행 단계 (폰 기준, 10분 컷)

Step 0. 카드 해외 결제 활성화 (1분, ⭐ 중요!)
  • 하나카드 앱: 카드 관리 → 이용 설정 → 해외 온라인 결제 → 사용
  • 다른 카드(신한·KB·삼성·롯데 등): 해당 카드사 앱에서 "해외결제" 또는 "온라인결제" 설정 찾아서 ON
  • 이 설정을 안 하면 이후 Step 4에서 "결제 방식을 인증할 수 없습니다" 에러가 계속 뜹니다.
Step 1. Brave Search API 사이트 접속 (폰 브라우저)
  • URL: https://brave.com/search/api/
  • "Get started free" 또는 "Sign in" 클릭
Step 2. 계정 로그인
  • GitHub 계정으로 간편 로그인 추천 (1차 강의에서 만든 그 계정)
  • 이메일 인증이 필요하면 받은 편지함 확인 후 인증 링크 클릭
Step 3. 플랜 선택 — "Data for Search"
  • 좌측 햄버거 메뉴(☰) → Available plans
  • "Data for Search" 플랜 선택 ($5 / 1,000 requests)
  • Get started 클릭
💡 유료 플랜을 고르는 게 맞습니다 — 이상하지 않습니다

2026년 2월부터 "완전 무료 플랜"은 존재하지 않습니다. 유료 플랜을 선택해도 매달 자동 지급되는 $5 무료 크레딧 덕분에 월 1,000회까지는 청구 $0으로 쓸 수 있습니다. 즉, "유료 플랜에 가입하지만 실제로는 무료"인 구조입니다.

Step 4. 결제 정보 입력
  • 카드 번호 / 유효기간 / CVC 직접 입력
  • ⚠️ 애플페이 팝업이 뜨면 취소하고, 페이지 아래쪽의 카드 직접 입력 칸을 찾아 입력
  • Subscribe 클릭 → 성공!
📌 지금 청구되는 건가요?

아니요. 구독은 유료 플랜 자격 취득 + 무료 크레딧 $5 지급만 일어나고, 실제 사용량이 $5를 넘기 전에는 카드에서 돈이 빠져나가지 않습니다. 다만 "카드는 실제 결제 수단"이므로 반드시 다음 Step 5의 Usage Limit을 걸어두세요.

Step 5. 사용량 한도 설정 (과금 방지, ⭐ 필수!)
⚠️ 이 단계를 건너뛰면 실수 과금 위험!

무료 크레딧 $5를 초과하는 순간부터 등록 카드에서 실제로 결제가 일어납니다. 실습 중 무한 루프나 잘못 짠 스크립트가 API를 계속 호출하면 수십 달러가 청구될 수 있습니다. 아래 설정으로 원천 차단하세요.

  • 사이드바(☰) → Subscriptions → Usage limits
  • + Add Usage Limit 클릭
  • Plan: Search 선택
  • Monthly Spend Limit: 5 (USD)
  • Enabled 체크
  • Create Usage Limit 클릭
  • ✅ 이제 무료 한도 $5를 넘으면 자동 차단되어 실수 과금 걱정 없음
Step 6. API Key 발급 및 복사
  • 사이드바(☰) → Dashboard → API keys
  • + Add API Key 클릭
  • 이름: My Claude CLI (또는 자유)
  • Add 클릭
⭐ 발급 직후 단 한 번만 키 전체가 보입니다 — 즉시 복사!

눈 아이콘(👁)으로 나중에 다시 볼 수 있긴 하지만, 처음 떴을 때 바로 복사해두시는 것이 가장 안전합니다. 못 찾으시면 해당 키를 Remove 후 재발급하시면 됩니다.

Step 7. (선택) Attribution 표시 — 무료 크레딧 유지 조건
📌 개인 실습 단계에서는 당장 안 해도 됩니다. 나중에 포트폴리오·서비스 공개 배포 시에만 필요.

Brave 정책상 매달 $5 무료 크레딧을 계속 받으려면, 해당 API를 사용하는 프로젝트 웹사이트 · README · 소개 페이지 등 공개된 곳에 "Powered by Brave Search API" 같은 표시를 해야 합니다. 개인 실습용 스크립트에서는 신경 쓰지 않으셔도 됩니다.

🧯 자주 막히는 지점 Top 5

# 증상 원인 해결
1 "결제 방식을 인증할 수 없습니다" 카드 해외 결제 차단 Step 0 다시 확인 — 카드 앱에서 해외 온라인 결제 ON
2 애플페이 팝업이 계속 뜸 자동 연결 시도 취소하고 페이지 내려서 카드 직접 입력 칸 찾기
3 노트북에서 "확인" 버튼이 무반응 맥: Apple Silicon + IPinside 비호환 / 윈도우: 이전 Agent 잔여물 맥은 바로 폰으로. 윈도우는 제어판에서 IPinside Non-p Agent 삭제 후 재설치 → 안 되면 폰
4 API Key 잃어버림 창 닫은 후 다시 전체가 안 보임 눈(👁) 아이콘으로 다시 보거나 Remove 후 재발급
5 "현대카드 없음" 팝업 특정 결제 수단만 받음 괜찮습니다. 하나·신한·KB 등 해외결제만 되면 모두 OK
🔐 매우 중요 — API Key 저장은 필수!

발급받은 Brave Search API Key는 반드시 안전한 곳에 따로 저장해 주세요. 저장을 놓치면 2차 강의에서 Brave 검색 연결 실습을 진행하실 수 없습니다.

저장 추천 장소: - 🥇 옵시디언 기억장치(볼트) 안의 별도 노트 — 1순위 추천. OAuth·Nano Banana Pro·네이버 검색 정보와 같은 노트에 모아두시면 관리가 훨씬 편합니다. - 비밀번호 관리 앱 (1Password, Bitwarden, Apple 키체인 등) - ❌ 카카오톡 나와의 채팅·공개 메모 등은 피해주세요 (API Key는 노출되면 누군가 몰래 써서 요금이 발생할 수 있습니다!)

💡 저장 방법을 잘 모르시면 클로드 코드 CLI에게 이렇게 물어보세요:

📋 복사해서 쓰세요
방금 발급받은 Brave Search API Key를 옵시디언 기억장치에 안전하게 저장하고 싶어. 어떻게 해야 할지 알려주고, 네가 직접 저장까지 해줘

⚠️ 2차 강의에서 꼭 필요합니다: 2차 강의 당일, 본인이 발급받은 API Key가 어디에 저장되어 있는지 즉시 꺼내 쓸 수 있어야 강의 진행이 가능합니다. 저장 위치를 못 찾으시면 Brave 검색 실습을 진행하실 수 없습니다. 꼭 꼼꼼히 챙겨주세요. 🙏

💰 비용 안내 (2026년 기준 재정리)
  • API Key 발급 자체: 무료
  • 매달 자동 지급 무료 크레딧: $5 (약 1,000회 쿼리)
  • 카드 등록: 필수 (본인 확인 + 초과 사용 시 결제 수단)
  • Usage Limit을 $5로 설정해두면: 초과 사용 자체가 차단 → 실수 과금 원천 봉쇄
  • 실제 비용 감각: 개인 학습·강의 과제 수준에서는 청구 $0 (사실상 무료)
💡 위 단계가 복잡해 보이시나요?

어려우시면 노트북 또는 메인 PC의 클로드 코드 CLI에게 이렇게 물어보시면 단계별로 친절하게 안내받을 수 있습니다:

📋 복사해서 쓰세요
Brave Search API(https://brave.com/search/api)를 클로드 코드 CLI에서 사용하려고 해. 2026년 신 요금 체계 기준으로 폰 브라우저에서 카드 해외결제 설정 → Data for Search 플랜 선택 → 결제 → Usage Limit $5 설정 → API Key 발급까지 전 과정을 단계별로, 내가 뭘 클릭하고 뭘 입력해야 하는지 초등학생도 이해할 수 있게 쉽게 안내해줘

마. 서비스 가입 (모두 무료)

💡 왜 이 서비스들에 가입해야 하나요?

2차 강의에서 클로드 코드 CLI를 사용하여 홈페이지를 만들고, 인터넷에 공개(배포)하고, 데이터베이스를 연결하는 실습을 합니다. 아래 서비스들은 이 과정에서 사용됩니다. 모두 가입만 해두시면 됩니다.

❓ "나는 개발 안 할 건데, 일상·업무에만 쓸 건데, 이런 것까지 가입해야 해요?"

이런 의문이 드실 수 있습니다. 결론부터 말씀드리면 네, 필요합니다. 그리고 어렵지 않습니다.

이유 — "자동화·시스템화 = 데이터베이스가 필수"

여러분이 앞으로 AI를 사용해 하고 싶은 대부분의 일은 사실상 "자동화"와 "시스템화"입니다. - "매일 아침 일정을 자동으로 정리받고 싶다" - "받은 이메일을 자동으로 분류하고 싶다" - "고객·거래처 정보를 체계적으로 관리하고 싶다" - "업무 기록을 쌓아두고 나중에 검색해서 쓰고 싶다" - "반복되는 업무를 AI가 대신 해주게 하고 싶다"

이런 일을 "말만 하면 자동으로 돌아가게" 만들려면, 정보를 저장하고 불러올 수 있는 저장소(데이터베이스)가 반드시 있어야 합니다. 데이터베이스 없이 자동화하려고 하면, 매번 같은 정보를 다시 입력해야 하고 기록이 쌓이지 않아 실질적인 자동화가 불가능합니다.

즉, 여러분이 "개발자처럼 프로그램을 만드는 것"이 목적이 아니더라도, "AI를 제대로 써먹기 위한 기반"으로서 데이터베이스와 배포 환경이 반드시 필요합니다. 2차 강의에서 만드는 홈페이지·데이터베이스 실습은 "개발 연습"이 아니라 "여러분의 자동화 시스템을 올릴 토대"를 준비하는 과정입니다.

걱정하지 마세요 — 가입 자체는 매우 쉽습니다

위 서비스들의 가입 절차는 우리가 평소에 하는 구글 계정 가입, 유튜브 가입, 카카오톡 가입과 동일한 수준입니다. 이메일과 비밀번호만 입력하면 끝나고, 대부분 GitHub 계정 하나로 여러 서비스에 한 번에 로그인할 수 있어서 더 간단합니다.

실제 설정과 연결 작업은 모두 2차 강의에서 클로드 코드 CLI의 도움을 받으며 진행하므로, 지금은 "계정만 만들어두는 것"이 전부입니다. 어렵게 생각하지 마시고 편하게 가입만 해두세요.

💡 아래 (1)~(3) 서비스는 모두 GitHub 계정으로 가입하세요

Cloudflare, Vercel, Supabase는 모두 "GitHub으로 로그인" 버튼을 제공합니다. 1차 강의에서 이미 만들어 둔 GitHub 계정을 그대로 사용하시는 것이 가장 간편하며, 이유는 두 가지입니다.

  1. 가입 절차가 거의 없습니다 — 이메일 인증, 비밀번호 생성 등의 과정 없이 "GitHub으로 로그인" 한 번만 누르면 바로 계정이 만들어집니다.
  2. 이후 연동이 훨씬 쉽습니다 — 2차 강의에서 여러분이 만든 코드(GitHub 저장소)를 Cloudflare·Vercel에 배포하거나, Supabase에 연결할 때 자동으로 연동됩니다. 별도의 권한 설정 없이 "내 GitHub 저장소 중 이것"을 선택하기만 하면 됩니다. 다른 계정으로 가입하면 매번 권한을 따로 연결해줘야 해서 번거롭습니다.

즉, "지금 편하고, 나중에도 편한" 방법이므로 꼭 GitHub 계정으로 가입해주세요.

(1) Cloudflare 가입 (무료)

  • 목적: 만든 홈페이지를 인터넷에 안전하고 빠르게 공개(배포)하기 위한 서비스
  • 사이트: https://www.cloudflare.com/ko-kr/
  • 가입 방법: 사이트 접속 → "Sign up" → "Continue with GitHub" 선택 → 1차 강의에서 만든 GitHub 계정으로 로그인

(2) Vercel 가입 (무료)

  • 목적: 만든 홈페이지를 클릭 한 번으로 인터넷에 배포할 수 있게 해주는 서비스
  • 사이트: https://vercel.com
  • 가입 방법: 사이트 접속 → "Sign Up" → "Continue with GitHub" 선택 → 1차 강의에서 만든 GitHub 계정으로 로그인

(3) Supabase 가입 (무료)

  • 목적: 홈페이지에 회원가입, 데이터 저장 등 백엔드(서버) 기능을 쉽게 붙이기 위한 서비스
  • 사이트: https://supabase.com
  • 가입 방법: 사이트 접속 → "Start your project" → "Continue with GitHub" 선택 → 1차 강의에서 만든 GitHub 계정으로 로그인

(4) Gabia 가입 (무료)

  • 목적: 나만의 도메인 주소(예: myname.com)를 구입하기 위한 서비스. 가입은 무료이고, 도메인 구입은 선택사항입니다.
  • 사이트: https://www.gabia.com
  • (선택) 자신만의 홈페이지를 이후에도 유지하고 싶은 분은, Gabia에서 도메인 구입 (호스팅 구입 불필요, 도메인만 구입, 유료)

바. 각자의 다과

  • 개인당 5,000원 상당 이하
  • 준비하실 분들은 미리 상의하여 품목이 겹치지 않게 부탁드립니다

7. 기타 안내

가. 과제 수행 중 막히는 부분이 있을 때

💡 문제 해결 순서
  1. 먼저 클로드 코드 CLI에게 질문하세요. 대부분의 문제는 클로드 코드 CLI가 해결해줍니다.
  2. 그래도 해결이 안 되면, 단톡방에 질문을 올려주세요. 다른 수강생 또는 강사가 도와드립니다.
  3. 해결 후에는 8항 보고서의 "경험 공유" 섹션에 문제와 해결 방법을 기록해주세요. 같은 어려움을 겪는 다른 수강생분들에게 큰 도움이 됩니다.

나. 원격 접속 사용 중 문제가 생기는 것은 "당연한 일"입니다

⭐ 꼭 알아두세요 — 이것이 실력이 늘어나는 과정입니다

노트북으로 원격 접속하여 메인 PC의 클로드 코드 CLI를 사용하다 보면 아래와 같은 문제가 반드시 발생합니다.

  • 노트북에서 찍은 스크린샷이 메인 PC의 클로드 코드 CLI에 잘 붙여넣어지지 않음
  • 노트북에 있는 파일을 첨부하려고 해도 경로가 맞지 않음
  • 노트북 클립보드와 메인 PC 클립보드가 분리되어 복사·붙여넣기가 안 됨
  • 입력한 한글이 깨지거나, 그림이 제대로 전달되지 않음
  • 기타 다양한 자잘한 오류들

이는 잘못된 것이 아니라, 원격 접속의 특성상 자연스럽게 발생하는 문제입니다. 당황하지 마세요.

그리고 이런 문제를 하나씩 해결해 나가는 것이 곧 실력 향상입니다. 어렵지 않습니다. 아래의 방법만 지키시면 누구나 해결할 수 있습니다.

🛠️ 문제 해결을 위한 표준 사용법 (매우 중요!)

💡 플랜 모드 → 실행 모드, 이 순서를 지키세요

1단계. 플랜 모드(Plan Mode)에서 상황 설명 - 클로드 코드 CLI를 플랜 모드로 전환 (shift + tab) - 현재 어떤 문제가 발생했는지 구체적으로 설명:

📋 복사해서 쓰세요
지금 나는 노트북에서 SSH로 메인 PC에 접속해서 클로드 코드 CLI를 사용하고 있어. 노트북에서 스크린샷을 찍어서 붙여넣으려고 하는데 잘 안 돼. 이 상황을 해결할 계획을 세워줘.

2단계. 계획 이해하기 — 모르는 부분은 반복해서 물어보기 - 클로드 코드 CLI가 세운 계획 중 이해되지 않는 부분이 있으면 그대로 두지 마세요 - 바로 다시 물어보세요:

📋 복사해서 쓰세요
계획 중에서 "○○○" 이 부분이 무슨 뜻인지 초등학생도 이해할 수 있게 쉽게 설명해줘
  • 이해될 때까지 반복하여 질문하세요. 몇 번을 물어봐도 괜찮습니다. 클로드 코드 CLI는 지치지 않습니다.
  • 완전히 이해가 된 후에 다음 단계로 넘어가세요.

3단계. 실행 모드(Execute Mode)에서 계획 실행 - 계획이 마음에 들고 이해가 되었으면, 실행 모드로 전환 후 이렇게 말하세요:

📋 복사해서 쓰세요
위 계획을 실행해줘

4단계. 결과 확인 - 실행이 끝나면 실제로 잘 작동하는지 직접 테스트해보세요 - 잘 작동하면 → 완료! 🎉 - 잘 작동하지 않으면 → 다시 1단계로 돌아가 "이런 문제가 남아있어"라고 상황을 설명하고 반복

이 4단계를 지키기만 하면 대부분의 문제는 해결됩니다. 이것이 앞으로 여러분이 클로드 코드 CLI를 사용하는 표준 방식이라고 생각하시면 됩니다.

다. SSH 원격 접속 설정이 끝내 어려우신 분께 — 메인 PC 직접 지참 옵션 안내

💡 "정말 SSH가 너무 어려워요 — 그냥 메인 PC를 강의장에 직접 가져가도 될까요?" — 네, 됩니다!

1차 과제의 실제 목표는 "외부 컴퓨터에서 SSH로 메인 컴퓨터에 접속하여 어디서든 내 환경을 쓰는 것"입니다. 그리고 위 3항·5항을 통해 그 목표를 달성하시는 것이 가장 좋습니다.

하지만 사람마다 수준과 환경이 다릅니다. 정말로 SSH·Tailscale·크롬 리모트 데스크탑(또는 맥 화면 공유) 설정이 어떻게 해도 안 되시는 분들은, 본인의 메인 PC와 모니터·키보드·마우스를 모두 강의장에 직접 가져오셔서 2차 강의를 들으셔도 전혀 괜찮습니다. 🙂

이런 분께 추천드립니다: - SSH 접속이 도저히 안정적으로 되지 않는 분 - 메인 PC가 데스크탑이라 물리적으로 직접 가져오는 게 더 편하신 분 - "이왕이면 내 환경 그대로 직접 만져가며 듣고 싶다" 는 분

다만, 이렇게 메인 PC를 직접 가져오실 경우에는 아래 두 가지를 꼭 챙겨주세요:

  1. 무선 인터넷 연결 수단 — 강의장에는 유선 랜선을 연결할 수 없으므로, 본인 PC가 와이파이로 인터넷에 접속할 수 있어야 합니다. 데스크탑에 무선 랜카드(USB 동글 등)가 없으면 미리 준비해 오세요. 📶
  2. 멀티탭 — 본인 PC + 모니터까지 전원을 모두 끌어와야 하므로, 충분한 콘센트 수가 있는 멀티탭을 꼭 챙겨주세요. 🔌

⚠️ 참고로 알아두실 점: 이렇게 메인 PC를 직접 가져오시는 경우, 2차 강의의 핵심 중 하나인 "SSH 접속" 부분을 직접 배우지 못하게 됩니다. 그러면 강의 후에도 "외부에서 노트북·다른 컴퓨터로 내 메인 PC의 클로드 코드 CLI를 사용하는 것"은 불가능해집니다. 즉, AI를 항상 내 메인 컴퓨터 앞에서만 쓰게 되는 제약이 생깁니다. 이 점을 감안하시고 본인에게 맞는 선택을 해주세요.

🙏 절대 불편해하지 마세요. 사람마다 환경과 필요가 다릅니다. 본인의 니즈와 환경에 가장 잘 맞는 방식으로 강의를 들으시는 것이 가장 좋습니다. 다만, 가능하시면 끝까지 SSH 설정에 도전해보시길 진심으로 권해드립니다. 한 번 익혀두시면 평생 어디서든 자기 환경 그대로를 쓸 수 있게 되니까요. 💪

라. 응원의 한마디

문제가 생기는 것을 두려워하지 마세요. 문제가 생기고, 그것을 해결해 나가는 과정 자체가 실력입니다.

모든 분들이 과제를 완료하고 2차 강의에서 함께할 수 있기를 진심으로 기원합니다. 어려운 부분이 있더라도 포기하지 마시고, 한 걸음씩 천천히 따라와 주세요. 🙌

8. 과제 및 준비사항 최종 보고 / 공유 (한 번에 모아서 보고)

⏰ 보고 기한

2026. 7. 3. (금) 24:00까지, 아래 과제 수행 보고서(.md 파일) 하나만 단톡방에 올려 주세요. 체크리스트와 함께 "과제 수행 중 문제·해결방법·힘들었던 점·좋았던 점" 등도 같은 파일 안에 모두 기재할 수 있도록 만들었습니다.

📋 보고 방법 안내 — 아주 간단합니다!

💡 보고 방법 (반드시 이렇게 해주세요)

Step 1. 아래 "📄 복사용 보고서 템플릿" 박스 안의 내용을 전체 복사 (코드 블록 우측 상단 복사 버튼 사용)

Step 2. 옵시디언 또는 VS Code에서 새 파일을 만들고, 파일명을 다음과 같이 저장:

📋 복사해서 쓰세요
1차 과제 보고 (3기, 홍길동).md
  • "홍길동" 부분은 본인 이름으로 바꿔주세요
  • 파일 확장자는 반드시 .md 여야 합니다

Step 3. 복사한 내용을 그 파일에 붙여넣기

Step 4. 완료한 항목 앞의 [ ]를 [x]로 바꿔주세요 (또는 옵시디언에서 체크박스 클릭)

Step 5. 아래 "자유 기재란" (문제·해결방법·힘들었던 점·좋았던 점 등)을 직접 작성 - 길게 쓰지 않아도 됩니다. 한두 줄이라도 좋으니 솔직하게 적어주세요 - 다른 수강생들과 강사에게 매우 큰 도움이 됩니다 - 글 쓰기가 번거로우시면 클로드 코드 CLI에게 "내가 과제 하면서 ○○ 문제가 있었고 △△로 해결했어. 이걸 과제 보고서 '문제 및 해결방법' 항목에 어울리게 정리해줘"라고 요청하셔도 됩니다

Step 6. 저장한 .md 파일을 그대로 단톡방에 업로드하여 제출 (텍스트로 따로 올릴 필요 없음 — 파일 하나로 끝!)

💡 어렵게 느껴지시면 클로드 코드 CLI에게 "이 템플릿으로 '1차 과제 보고 (3기, 내이름).md' 파일을 만들어줘"라고 요청하셔도 됩니다.

🖥️ 컴퓨터가 한 대뿐인 분의 보고 방법 (3항 상단 안내와 동일)

컴퓨터를 한 대만 쓰시는 분은 3항 상단 안내에서 설명드린 대로 3항·5항을 건너뛰셔도 됩니다. 보고서에서도 3항·5항 체크리스트는 각 항목 맨 위의 "해당 없음(컴퓨터 1대)" 한 줄만 체크하고 나머지는 비워두시면 됩니다. 4항(체득 과제)과 6항(준비사항)은 그대로 진행하여 보고해 주세요. 🙂

📄 복사용 보고서 템플릿 (아래 전체를 복사하여 .md 파일로 만들어 제출)

📋 복사해서 쓰세요
# 1차 과제 보고 (3기, 홍길동)

보고일: 2026. 7. __.
이름: 홍길동
소속 조: __조

---

## 가. 과제 수행 보고 (3항 ~ 5항)

### 3항. 메인 PC 환경 구축 + SSH 원격 접속

(🖥️ 컴퓨터가 한 대뿐인 분 → 3항 전체가 "해당 없음"입니다. 바로 아래 한 줄만 체크하고 나머지는 비워두세요)
- [ ] 해당 없음 — 컴퓨터를 1대만 사용(그 한 대가 곧 메인 PC)하여 원격 접속 설정 불필요

- [ ] Step 1. Tailscale 설치 + 같은 네트워크에서 SSH 접속 성공
- [ ] Step 2. 노트북의 클로드 코드 CLI로 메인 PC 전체 셋팅 완료
- [ ] Step 3. 화면 공유 도구 설치 + 노트북에서 메인 PC 화면 접속 성공
  - 아래 중 본인 환경에 맞는 것을 선택:
  - [ ] 🌐 (윈도우가 포함된 환경) 크롬 리모트 데스크탑 설치 + 접속 성공
  - [ ] 🍎 (맥 ↔ 맥) 맥 화면 공유(VNC) 설정 + 접속 성공
  - [ ] 같은 네트워크에서 접속 확인
  - [ ] 외부 네트워크(카페·핫스팟 등)에서도 접속 확인
  - [ ] (메인 PC와 노트북의 OS가 다른 경우) 키보드 매핑 이해 + 자주 쓰는 단축키 작동 확인 (복사·붙여넣기·한영 전환 등)
- [ ] Step 4. 메인 PC 항상 켜짐 + 절전 비활성화·잠금 시간 조절 설정 완료
  - [ ] 절전 모드(슬립) 비활성화
  - [ ] 잠금 화면 "즉시" 잠금 설정 (보안을 위해 잠금 활성화 유지 추천)
  - [ ] 디스플레이만 꺼지도록 설정 (본체는 깨어 있음)
  - [ ] (윈도우) 자동 업데이트 후 재부팅 방지 설정
  - [ ] 1시간 방치 후 SSH·크롬 리모트 데스크탑(또는 맥 화면 공유) 재접속 테스트 성공
- [ ] 2차 강의 출발 전 최종 점검 (강의장 가시기 1시간 이내)
  - [ ] 메인 PC가 켜져 있는지 확인
  - [ ] 노트북으로 SSH 접속 → `claude` 실행 정상 확인
  - [ ] 노트북으로 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC) 접속 정상 확인
  - [ ] 휴대폰 텔레그램 봇(메인 PC의 클로드 코드 CLI에 연결된 봇) 응답 정상 확인

### 4항. 메인 PC에서 체득 과제

- [ ] 가. 클로드 코드 CLI로 다양한 질문/요청 (30회 이상)
- [ ] 나. 옵시디언으로 클로드 코드 CLI 기억장치 만들고 활용
  - [ ] (1) 대화를 옵시디언에 수동 저장 (5회 이상)
  - [ ] (2) 자동 저장된 대화 세션 참조하여 요청 (5회 이상)
  - [ ] (3) 자동 저장된 대화를 클로드 코드 CLI가 검색하여 활용 (5회 이상)
  - [ ] (4) 클로드 코드 CLI가 직접 옵시디언에 메모 작성 (5회 이상)
  - [ ] (5) 옵시디언 메모 드래그앤드롭으로 참조 (5회 이상)
- [ ] 다. 클로드 코드 CLI 채널스로 텔레그램 봇 연결 (1회) + 노트북 봇 삭제
  - [ ] 터미널 닫아도 봇이 꺼지지 않도록 설정 완료 (맥: tmux / 윈도우: tmux 또는 VBS 백그라운드)
  - [ ] 메인 PC 재부팅 시 채널스 봇 자동 실행 설정 완료 (맥: launchd / 윈도우: 시작 프로그램)
- [ ] 라. 텔레그램 봇으로 휴대폰에서 질문 (30회 이상)
- [ ] 마. 텔레그램 봇을 동기와 함께 단체톡방에서 사용 (10회 이상)
- [ ] 바. VS Code + 클로드 코드 CLI + 깃허브로 나만의 랜딩페이지 만들고 버전 관리
  - [ ] (1) VS Code 터미널에서 클로드 코드 CLI로 나만의 랜딩페이지 만들기
  - [ ] (2) 만든 랜딩페이지를 깃허브에 올리기
  - [ ] (3) 올린 랜딩페이지를 다시 다운로드 받기
  - [ ] (4) VS Code로 랜딩페이지를 수정한 후 다시 깃허브에 올리기
  - [ ] (5) 자신이 직접 일부 파일을 수동으로 수정 (3회 이상)

### 5항. 외부에서 노트북으로 같은 과제 다시 진행 (SSH + 화면 공유 도구 혼합)

(🖥️ 컴퓨터가 한 대뿐인 분 → 5항 전체가 "해당 없음"입니다. 바로 아래 한 줄만 체크하고 나머지는 비워두세요)
- [ ] 해당 없음 — 컴퓨터를 1대만 사용하여 외부 원격 재실습 미해당

- [ ] 가. 외부에서 메인 PC에 두 통로 동시 접속 성공
  - [ ] 🅐 SSH 통로: 노트북 터미널 → SSH → 메인 PC 터미널 → `claude` 실행
  - [ ] 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC) 통로: 노트북 → 메인 PC 화면 표시
- [ ] 나. 원격으로 클로드 코드 CLI에 질문/요청 (추가 30회 이상, 두 통로 혼합)
  - [ ] 🅐 SSH로 약 20회 이상 (텍스트·코드·명령 위주)
  - [ ] 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC)로 약 10회 이상 (그림 첨부·드래그앤드롭·시각적 작업 위주)
- [ ] 다. 원격으로 옵시디언 기억장치 활용 (최소 2가지 각 추가 2회 이상, 두 통로 혼합)
  - [ ] 🅐 SSH로 (1)~(4) 중 1가지 이상
  - [ ] 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC)로 (5) 옵시디언 메모 드래그앤드롭
- [ ] 라. 원격으로 VS Code + 클로드 코드 CLI + 깃허브 작업 다시 해보기 (SSH + 화면 공유 도구 혼합)
  - [ ] 🅐 SSH 터미널 창에서 클로드 코드 CLI로 코드 수정·git push
  - [ ] 🅑 크롬 리모트 데스크탑 또는 맥 화면 공유(VNC) 창에서 VS Code GUI·개발서버 미리보기로 시각적 확인

---

## 나. 2차 강의 준비사항 완료 여부 (6항)

- [ ] 가. Google OAuth 클라이언트 ID 발급 완료 (Client ID/Secret 저장)
- [ ] 나. Google Nano Banana Pro API 키 발급 + 결제 등록 + Paid Tier 전환 확인 (API Key 저장)
- [ ] 다. 네이버 검색 API 발급 완료 (Client ID/Secret 저장)
- [ ] 라. Brave 검색 API 발급 완료 (API Key 저장)
- [ ] 마-(1). Cloudflare 가입 (GitHub 계정)
- [ ] 마-(2). Vercel 가입 (GitHub 계정)
- [ ] 마-(3). Supabase 가입 (GitHub 계정)
- [ ] 마-(4). Gabia 가입
- [ ] 바. 각자의 다과 준비 (준비하실 분)

---

## 다. 컴퓨터 기본 활용 능력 점검 (강의장에서 필요)

- [ ] 운영체제(윈도우 또는 맥) 기본 이해 완료
- [ ] 시스템 기본 메뉴 사용 가능
- [ ] 시스템 기본 실행 창(윈도우: Win/Win+S / 맥: ⌘+Space) 사용 가능
- [ ] 복사·붙여넣기 단축키 완벽 활용 가능 (Ctrl/⌘ + C/V/X/A/Z 등)
- [ ] 여러 프로그램 창 배열·이동·전환 능력 (Alt+Tab / ⌘+Tab / 화면 분할 등)

---

## 라. 2차 강의 당일 지참 방식 선택 + 준비물

> 본인이 어떤 방식으로 2차 강의를 들으실지 먼저 선택해주세요:
> - [ ] 🅐 노트북으로 SSH·크롬 리모트 데스크탑(또는 맥 화면 공유) 원격 접속 (기본·권장 방식 — 1차 과제 3항·5항을 완료하신 분)
> - [ ] 🅑 메인 PC를 직접 강의장에 지참 (SSH 설정이 어려운 분의 대안 — 7항 다 참조)

### 🅐 노트북 원격 접속 방식 (기본)

- [ ] 노트북 준비 완료 (윈도우 / 맥: ______)
- [ ] 멀티탭 또는 리드선 준비 완료
- [ ] 마우스 준비 (선택): ( 예 / 아니오 )
- [ ] 외부 모니터 지참 (선택, 권장): ( 예 / 아니오 )
- [ ] 클로드(Claude) 유료 구독 로그인 상태 확인
- [ ] 메인 컴퓨터에도 클로드 코드 CLI 설치 완료
- [ ] 각종 계정 로그인 상태 점검 완료 (구글, 깃허브, 텔레그램, 카톡, VS Code, 옵시디언 등)

### 🅑 메인 PC 직접 지참 방식 (위 🅑 선택하신 분만 작성)

- [ ] 메인 PC 본체
- [ ] 모니터
- [ ] 키보드 + 마우스
- [ ] 모든 연결 케이블 (전원선·HDMI/DP·USB 등)
- [ ] 무선 인터넷 연결 수단 (와이파이 가능 / 데스크탑이면 무선 랜카드·USB 동글)
- [ ] 충분한 콘센트 수의 멀티탭
- [ ] (권장) 노트북도 함께 지참 — 강의 자료·메모용
- [ ] 클로드(Claude) 유료 구독 로그인 + 클로드 코드 CLI 설치 확인
- [ ] 각종 계정 로그인 상태 점검 (구글, 깃허브, 텔레그램, 카톡, VS Code, 옵시디언 등)
- [ ] ⚠️ SSH 부분을 직접 못 배우게 됨을 인지하고 선택함 (7항 다 콜아웃 참조)

---

## 마. 과제 수행 중 경험 공유 (자유 기재란)

> 목적: 같은 문제를 겪는 다른 수강생분들에게 도움이 되고, 강사가 2차 강의 준비 시 참고하여 더 나은 강의를 준비할 수 있습니다. 한두 줄이라도 좋으니 솔직하게 적어주세요.

### 1) 막히는 부분 및 오류

(예: "SSH 접속 시 연결이 자꾸 끊어졌습니다.")

-

### 2) 해결 방법

(예: "Tailscale을 재설치하고 방화벽 예외를 추가하니 해결됐습니다.")

-

### 3) 원격 접속 관련 문제와 해결 경험

(예: "외부에서 접속 시 메인 PC가 절전모드에 들어가 있어 연결이 안 됐고, 절전모드를 끄고 해결했습니다.")
(🖥️ 컴퓨터가 한 대뿐인 분은 SSH·화면 공유 원격 접속은 하지 않으므로 그 부분은 "해당 없음"입니다. 다만 **휴대폰에서 텔레그램 봇에 접속하는 부분은 누구나 동일**하므로, 봇 사용 중 겪은 문제·해결 경험이 있으면 적어주세요)

-

### 4) 과제 수행 중 유용하게 활용한 프롬프트 또는 팁

(예: "'이 코드가 무슨 역할을 해?'라고 먼저 물어본 후 수정하니 이해가 훨씬 빨랐습니다.")

-

### 5) 힘들었던 점

(예: "깃허브 개념이 처음엔 정말 낯설었습니다.")

-

### 6) 좋았던 점 · 배운 점 · 재미있었던 경험

(예: "노트북으로 카페에서 집 메인 PC에 접속해서 작업해보니 정말 신기했습니다.")

-

### 7) 기타 전달 사항 · 한 줄 소감 (선택)

-
✍️ 자유 기재란 작성 팁
  • 모든 항목을 다 채울 필요는 없습니다. 해당하는 항목만 작성하시면 됩니다.
  • 글 쓰기가 번거로우시면 클로드 코드 CLI에게 "내가 과제 하면서 겪은 일을 말할 테니, 위 보고서의 자유 기재란 항목에 맞춰 정리해줘"라고 요청하셔도 됩니다.
  • 솔직한 경험이 강사와 다른 수강생들에게 가장 큰 도움이 됩니다. 형식에 얽매이지 말고 편하게 써주세요.

평안한 날 보내세요.