“이 링크 보고 정리해 줘.”
그런데 답이 엉뚱합니다.
설명을 못 하는 문제가 아니라,
설명할 재료가 아직 도착하지 않은 것일 수 있어요.
요리사에게 메뉴만 알려주고 재료를 주지 않으면 요리가 시작되지 않죠. 클로드도 비슷해요. 먼저 외부 자료를 읽는 도구가 준비돼 있어야 합니다.
Agent Reach는 자료를 읽는 여러 도구를 준비하고 연결 상태를 확인하는 도우미예요. 실제 수집은 각 도구가 맡습니다. 설치만으로 모든 사이트가 열리거나 게시까지 자동화되는 것은 아닙니다.
준비된 PC 기준 15~25분을 목표로 잡아보세요. 처음 설치하거나 사이트가 응답하지 않으면 더 걸립니다. 이는 실습 계획 시간입니다.
지금 어디서 시작하나요?
클로드 코드에서 폴더를 선택하거나, 터미널에서 그 폴더로 이동한 뒤 claude를 입력해 시작합니다. 아래 1단계부터 따라가세요.
우선 클로드 코드를 준비해요.
이 안내는 컴퓨터에서 명령을 실행할 수 있는 Claude Code 기준입니다. 일반 웹 채팅창에 설치 문장을 넣는 것만으로 내 PC에 설치되지는 않아요.
Claude Code를 사용할 수 있는 계정이 필요해요. 구독 또는 Console/API 사용 비용은 별도이며, 무료 웹 계정만으로는 이 실습을 진행할 수 없습니다. 공식 설치·계정 안내
시작 메뉴에서 PowerShell을 검색해 여세요. 아래는 Anthropic 공식 설치 명령입니다. 설치 내용을 확인한 뒤 실행하세요.
irm https://claude.ai/install.ps1 | iex
Spotlight(⌘+Space)에서 터미널을 검색해 여세요. 아래는 Anthropic 공식 설치 명령입니다.
curl -fsSL https://claude.ai/install.sh | bash
설치 후 창을 새로 열고 claude --version을 입력해 버전을 확인하세요. 연습용 빈 폴더에서 claude를 실행하고 로그인하면 준비가 끝나요. 아래 긴 문장은 이제 클로드 코드의 대화 입력창에 넣습니다.
설치 전에, 내 컴퓨터부터 확인해요.
한꺼번에 다 깔지 말고 필요한 것부터 찾습니다. 아래 문장을 복사해 클로드 코드에 붙여 넣어 주세요.
내 컴퓨터에서 Agent Reach를 사용할 준비가 됐는지 확인해 줘. 운영체제, Python, 패키지 설치 도구, 명령 실행 가능 여부를 확인하고, 없는 것만 알려줘. 아직 설치하거나 설정을 바꾸지 마. 나는 유튜브 공개 영상의 자막 하나를 요약 노트로 만드는 게 목표야.
운영체제와 Python 등 준비 상태가 정리되고, 없는 도구가 무엇인지 알게 되면 됩니다. “설치됨”이라는 답만 보지 말고 실제 확인 결과를 요청하세요.
Agent Reach를 준비하고 연결을 점검해요.
공식 설치 안내를 클로드에게 전달합니다. 필요한 항목의 설명을 읽고 진행 범위를 확인하세요. 시스템 변경이나 추가 계정 연결을 묻는다면, 이번에는 유튜브 자막 실습에 필요한 범위부터 선택합니다.
공식 안내를 읽고 Agent Reach 설치를 도와줘. https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md 먼저 필요한 설치 항목과 저장 위치를 쉬운 말로 설명해 줘. 내가 확인한 범위만 설치하고, 최초 점검은 agent-reach install --env=auto 로 해 줘. --system 실행, 추가 플랫폼 연결, 로그인 정보 사용은 먼저 필요한 이유를 알려줘. 기존 프로젝트 파일은 바꾸지 마.
agent-reach install --env=auto는 현재 공식 안내상 점검 중심의 기본 모드예요. 이것만 실행했다고 필요한 모든 도구가 설치된 것은 아닙니다. 누락 항목을 확인하고 필요한 설치를 마친 뒤 다음 문장을 쓰세요.agent-reach doctor를 실행해 줘. 결과에서 YouTube와 GitHub 상태만 먼저 설명해 줘. 정상 / 추가 설정 / 사용할 수 없음으로 구분하고, 다음 행동 하나를 알려줘. 실제 자료 조회를 하지 않았다면 조회 성공이라고 말하지 마.
첫 자료 조회로 넘어가요.
필요한 항목 하나만 보완해요.
오류 문장을 확인해요.
이 색상 구분은 결과를 이해하기 위한 도식입니다. 실제 doctor 출력 문구와 모양은 버전마다 다를 수 있어요. 점검 통과와 실제 사이트 조회 성공은 따로 확인합니다.
짧은 공개 영상 하나로 시작하세요.
내가 내용을 알고 있는 짧은 영상이 좋아요. YouTube에서 영상을 열어 공유 → 링크 복사를 누르고, 아래 [여기에 내 영상 URL]을 바꿔 주세요. 자막이 있는 영상을 고르면 첫 실습이 수월합니다.
아래 공개 유튜브 영상의 자막을 실제로 가져와 줘. 영상 주소: [여기에 내 영상 URL] 한국어 원문 자막을 우선하고, 번역 자막이면 알려줘. 원본 링크, 영상 제목, 사용한 자막 언어, 핵심 5줄, 내가 할 일 3개를 정리해 줘. 영상에 없는 내용은 만들지 마. 자막을 못 가져오면 멈추고 이유와 대안 하나를 알려줘. 화면 장면을 분석했다고 말하지 마.
이런 구성이 나오면 확인하기 쉬워요
형식 예시 · 실제 영상 수집 결과가 아닙니다.
- 출처: 내가 넣은 영상 링크
- 자막: 원문 언어 / 번역 여부
- 핵심: 영상에서 확인한 사실 5개
- 할 일: 오늘 실행할 행동 3개
- 미확인: 자막으로 알 수 없는 내용
이 단계는 자막을 읽는 실습이에요. 화면에만 나온 버튼이나 표는 놓칠 수 있습니다. 장면까지 분석해야 하는 작업은 기존 영상 보기 가이드를 따로 참고하세요.
검수하고, 내 폴더에 남겨요.
요약이 그럴듯한지보다 원문과 맞는지를 먼저 봅니다. 숫자·도구 이름·조건 한두 개를 원본과 직접 대조해 주세요.
방금 요약을 원문 자막과 비교해 줘. 숫자·이름·조건이 원문과 같은지 확인하고, 근거 없는 문장은 빼 줘. 원문에 없는 네 의견은 별도 칸으로 나눠줘. 확인하지 못한 것은 확인 못 했다고 적어줘.
방금 확인한 자료로 notes/first-research.md를 만들어 줘. 원본 URL / 확인 날짜 / 자막 언어 / 핵심 5줄 / 실행할 일 3개 / 확인 못 한 내용을 구분해 줘. 파일이 이미 있으면 덮어쓰기 전에 알려줘. 저장한 경로를 마지막에 보여줘.
notes/first-research.md 파일을 열었을 때 출처·핵심·할 일이 보이면 첫 실습이 끝난 거예요. .md는 메모장이나 코드 편집기로 열 수 있는 글 파일입니다.첫 성공 다음엔, 이것만 바꿔보세요.
한 번에 모두 실행할 필요 없어요. 지금 필요한 문장을 하나 골라 쓰세요.
공개 GitHub 자료도 읽고 싶어요
이 공개 GitHub 저장소의 README를 읽고 초보자에게 설명해 줘: [저장소 URL] 무엇을 하는 도구인지 / 설치 조건 / 가장 쉬운 사용 예 / 라이선스 / 모르는 점을 정리해 줘. 코드를 설치하거나 실행하지 말고 공식 링크를 붙여줘.
요약으로 쇼츠 대본을 만들고 싶어요
검수한 요약 노트를 바탕으로 40초 분량의 한국어 쇼츠 대본 초안을 만들어 줘. 문제 제기 → 해결 원리 → 한 가지 실천 순서로 써 줘. 원문에 없는 성과·가격·지원 기능은 넣지 마. 마지막은 “댓글에 자료라고 남겨주세요.”로 해 줘. 게시하지 말고 초안만 보여줘.
오류를 어떻게 질문할지 모르겠어요
아래 오류를 초보자 기준으로 설명해 줘. 내 운영체제: [Windows 또는 macOS] 실행한 명령: [명령] 오류 문장: [비밀정보를 지운 오류] 원인 후보를 좁히고, 설정 변경 없이 확인할 수 있는 것부터 한 번에 하나씩 제안해 줘. 토큰·쿠키·키를 채팅에 붙여 넣으라고 하지 마.
인스타그램·X까지 넓히고 싶어요
다음에는 [Instagram 또는 X]의 공개 자료를 확인하고 싶어. Agent Reach 공식 문서 기준으로 필요한 도구, 로그인 여부, 접근 가능한 범위, 비용 가능성을 먼저 정리해 줘. 아직 설치하거나 계정을 연결하지 마. 로그인 정보는 공개 채팅이나 문서에 남기지 않는 방법으로 안내해 줘.
멈춘 화면에서 다시 출발하기
오류가 나면 다시 설치부터 하지 마세요. 보이는 증상으로 원인을 좁히면 빨라요.
agent-reach를 찾을 수 없대요.
Python을 실행했는데 Microsoft Store가 열려요.
doctor는 정상인데 자막은 안 가져와져요.
한국어 영상인데 영어 요약이 나와요.
설치 허용이나 로그인 정보를 요청해요.
자료를 가져왔는데 내용이 너무 얕아요.
전부 연결하기보다,
필요한 하나를 더하세요.
| 자료 | 시작 방법 | 기억할 점 |
|---|---|---|
| YouTube | 첫 실습으로 추천 | 자막 유무·접근 상태 확인 |
| 공개 GitHub | 공개 문서 읽기부터 | 쓰기 작업은 별도 권한 필요 |
| 데스크톱·OpenCLI 추가 설정 | 사용자 브라우저 로그인 상태 필요 | |
| X / Twitter | 추가 인증 설정 | 인증정보 취급과 계정 제한 확인 |
| 네이버 | 이 안내의 실습 대상 아님 | 공식 지원 목록에서 확인하지 못함 |
썸네일의 플랫폼 로고가 모두 기본 연결을 뜻하지는 않아요. 이 표는 2026.09.12 공식 문서를 기준으로 정리했습니다.
“도구가 무료”와 “전체 비용 0원”은 달라요.
Agent Reach는 오픈소스 도구입니다. 사용 중인 AI 구독·API, 서버, 선택한 외부 서비스의 비용은 따로 확인하세요. 첫 실습은 짧은 영상 하나로 하고, 이미 가져온 자막을 재사용하면 반복 수집을 줄일 수 있어요.
이제 “자료 하나”가
“내가 쓸 결과”가 됐어요.
오늘 모든 자동화를 끝낼 필요는 없어요. 가져오기 → 원문 확인 → 저장하기. 이 세 가지를 한 번 해내면 다음 영상에서도 같은 순서로 이어갈 수 있습니다.
마지막으로 세 가지만 확인해요
- 내가 넣은 원본 링크가 기록돼 있나요?
- 핵심 5줄이 원문과 맞나요?
- 저장한 파일을 직접 열어봤나요?
인쇄창에서 ‘PDF로 저장’을 선택할 수 있습니다. 다운로드 자료는 로그인 없이 이용할 수 있어요.
막힌 지점이 있다면, 트렌드코어 오픈채팅 →질문에는 운영체제·단계 번호·비밀정보를 지운 오류 문장만 함께 적어 주세요.
공식 자료와 확인 범위
2026년 9월 12일 공식 문서를 확인해 구성한 가이드입니다. 이 글을 위해 새 PC에 Agent Reach를 설치하거나 실제 유튜브 자막 수집을 실행한 것은 아닙니다. 본문 결과 카드는 형식 예시이며, 환경·버전에 따라 화면과 결과가 달라질 수 있어요.
