클로드 코드 Agent Reach는 한 번에 다 깔지 않는다, 점검부터 지우기까지 6단계

클로드 코드에 Agent Reach를 깔 때는 한 문장으로 전부 맡기지 말고, 점검만 받기 → 미리보기 → 필요한 채널만 깔기 → 부계정 확인 순서로 나눠서 승인하는 게 안전합니다.

유튜브 자막이나 깃허브를 클로드 코드에 붙이고 싶은데 명령창 설치가 처음이라 막히는 분이라면 이 순서가 맞습니다. 본 계정밖에 없는데 레딧이나 X를 읽히려는 분이라면 여기서 닫으셔도 돼요. 이유는 4단계에 적어 뒀습니다.

시작 전에	이렇게 준비
준비물	명령을 실행할 수 있는 AI(클로드 코드나 커서), 파이썬 3.10 이상
걸리는 시간	AI에게 한 문장씩 여섯 번 붙여 넣는 분량. 3단계 전까지는 Agent Reach 본체 말고 깔리는 것이 없음
드는 돈	내 컴퓨터에 깔면 0원. 서버에 둘 때만 우회 접속 비용이 한 달 1달러쯤(공식 설명서 기준)
계정	레딧·X·샤오훙수를 열 생각이면 전용 부계정
기준 시점	2026년 10월 6일 현재, 버전 1.5.0

공식 저장소 첫 화면의 표입니다. 둘째 열(装好即用, 깔면 바로 됨)이 줄표인 줄은 여섯 개예요. 그중 검색은 자동으로 연결되고, 나머지 다섯 줄(레딧·페이스북·인스타그램·샤오훙수·팟캐스트)은 설정 없이는 안 열립니다.

이 도구가 내 컴퓨터에서 하는 일

Agent Reach는 직접 긁어 오는 프로그램이 아니에요. 이미 공개된 무료 도구들을 대신 설치하고 상태를 점검해 주는 설치 도우미입니다.

• 유튜브 자막은 자막 다운로드 프로그램(yt-dlp)이 받아요
• 웹 글은 웹 페이지를 글로 바꿔 주는 서비스(Jina Reader)를 거쳐 와요
• 깃허브는 깃허브에서 내놓은 명령창 도구로 열어요
• 레딧·X는 내 로그인 상태를 빌려야 열려요

그래서 설치 순서를 나누는 게 의미가 있습니다. 어느 도구까지 깔지, 어느 계정을 넘길지를 단계마다 내가 정할 수 있거든요.

1단계: Agent Reach만 깔고 점검만 받는다

클로드 코드를 열고 아래 문장을 그대로 붙여 넣습니다. 설치 설명서를 읽히되, Agent Reach 본체만 깔고 점검 단계에서 멈추라는 지시예요.

Agent Reach 설치 설명서(https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md)를 읽고, Agent Reach 프로그램만 설치한 다음 옵션 없이 점검만 실행해 줘. 시스템 도구나 채널은 아직 깔지 마.

AI가 실행하는 점검 명령은 아래 줄입니다. 옵션이 없으면 다른 도구는 하나도 깔지 않고, 빠진 것만 목록으로 보여 주고 멈춰요.

agent-reach install --env=auto

채널마다 무엇이 없는지 나오고 거기서 끝나면 정상입니다. 저는 이 단계를 건너뛰지 않는 쪽을 권해요. 빠진 목록을 봐야 3단계에서 고를 게 생기니까요.

표 첫 줄(默认安全检查, 기본 안전 점검)이 지금 한 단계예요. 마지막 줄(仅预览, 미리보기만)이 다음 단계입니다.

2단계: 미리보기 옵션으로 할 일부터 본다

같은 명령에 미리보기 옵션을 붙이면, 실제로 바꾸지 않고 무엇을 할지만 보여 줍니다.

agent-reach install --env=auto --dry-run

클로드 코드에는 "미리보기 옵션을 붙여 다시 실행하고, 무엇을 설치할지 목록만 보여 줘"라고 시키면 돼요. 첫 줄에 아무것도 바꾸지 않았다는 안내가 찍혀야 정상입니다.

이 목록에서 볼 건 하나예요. 내 컴퓨터 전체에 깔리는 도구가 무엇인지입니다.

3단계: 기본 채널부터 승인하고, 로그인 채널은 골라 붙인다

목록이 괜찮으면 그때 실제 설치를 승인합니다.

agent-reach install --env=auto --system

웹 글·유튜브·깃허브·새 글 알림·검색처럼 설정 없이 되는 채널과, AI용 사용법 문서를 실제로 까는 명령이에요. 이 단계부터 컴퓨터 전체에서 쓰는 도구가 깔립니다.

레딧이나 X처럼 로그인이 필요한 곳은 쉼표로 골라서 붙여요.

agent-reach install --env=auto --system --channels=twitter,reddit

제가 고른다면 처음엔 채널 옵션 없이 기본만 깔겠어요. 필요해지는 채널이 생길 때 하나씩 붙여도 늦지 않습니다.

설치가 끝나면 점검 명령으로 상태를 봅니다.

agent-reach doctor

채널마다 되는지, 안 되면 고치는 법이 무엇인지 보여 주는 명령이에요. 다만 여기서 "된다"가 떠도 실제로는 연결이 안 됐다는 신고 두 건이 아직 열려 있어요. 유튜브 영상 주소 하나를 주고 자막이 실제로 나오는지 한 번 시켜 보는 게 진짜 확인이에요.

4단계: 쿠키가 필요한 곳은 부계정인지 확인한다

경고 상자 내용은 이렇습니다. 쿠키로 로그인하는 플랫폼은 프로그램 호출이 감지돼 계정이 정지될 위험이 있으니, 메인 계정은 쓰지 말고 이 용도 전용의 작은 계정을 꼭 쓰라는 거예요.

쿠키는 로그인 상태가 담긴 작은 파일이라, 넘기는 순간 그 계정 전체를 맡기는 셈입니다. 그래서 확인 순서를 이렇게 잡아요.

• 연결할 계정이 본 계정이 아닌지 먼저 본다
• X는 쿠키 내보내기 확장 프로그램(Cookie-Editor)으로 사람이 직접 내보낸 값만 넣는다
• 쿠키 가져오기는 설치와 별개 명령이다. 브라우저와 플랫폼을 사람이 지정해야만 읽는다

넘긴 쿠키는 내 PC 안 설정 파일 한 곳에 들어가고, 내 사용자 계정만 열 수 있게 잠깁니다. 이건 "어디에 저장되나"를 막아 주는 장치예요. 플랫폼이 비정상 호출로 보고 막는 건 이걸로 못 막습니다.

실제 신고가 두 건 있어요. X 부계정으로 검색을 한 번 시켰다가 정지 통보를 받은 경우(그때 점검 명령은 통과), 샤오훙수를 이틀에 열다섯 번도 안 물어보고 경고를 받은 경우입니다. 본 계정 하나뿐이라면 이 단계에서 멈추세요.

5단계: 같은 이름 프로그램은 받지 않는다

파이썬 프로그램 저장소(PyPI)에 같은 이름으로 올라간 0.1.0은 다른 개발자가 8월 2일에 올린 프로그램이에요. 공식 설명서는 이 패키지가 자기 것이 아니라고 적어 뒀습니다. 그런데 저장소 안 다른 안내 문서는 바로 이 명령을 알려 줘요.

pip install agent-reach

이 줄은 쓰지 않습니다. 설치는 1단계처럼 설치 설명서를 거쳐서만 합니다. 클로드 코드가 이 명령을 제안하면 멈추라고 한 줄 덧붙여 두세요.

6단계: 지울 때도 미리보기부터

agent-reach uninstall --dry-run
agent-reach uninstall

첫 줄은 무엇이 지워질지만 보여 주고, 둘째 줄이 실제로 지웁니다. 저장해 둔 로그인 정보(토큰·쿠키), 사용법 설명서 네 곳, 도구 연결 설정까지 같이 지워져요.

윈도우는 하나 더 확인합니다. 파일 확장자 문제로 검색·샤오훙수 연결 설정이 지워지지 않고 남는다는 신고가 열려 있어요. 지운 뒤 Agent Reach가 만든 연결 항목이 남았는지 직접 보세요.

막혔을 때 증상별로 찾기

증상	원인	해결	확인한 숫자
레딧 주소를 줬더니 로그인하라는 안내만 와요	레딧이 5월 말 로그인 없는 창구를 닫음	브라우저 로그인 연결이나 부계정 쿠키	웹 글 읽기로 부르면 403 차단
점검에선 된다는데 실제로는 안 열려요	점검이 도구 준비 상태만 봄	실제 주소 하나로 직접 시켜 보기	같은 증상 신고 2건, 고치자는 제안 미반영
유튜브 자막이 로봇 확인 화면에 막혀요	유튜브가 자동 요청을 막는 경우	알려진 우회법이 브라우저 쿠키 전달이라 계정 위험이 따라옴	15개 채널 점검 신고 중 자막 경로 실패 1건
네이버 블로그 본문이 비어서 와요	PC 글 주소로는 본문이 안 읽힘	주소 맨 앞에 m과 점을 붙여 모바일 주소로	빈 본문 → 약 800자(블로그 1곳)
웹 글을 연달아 읽다 막혀요	키 없는 웹 글 읽기 한도	변환 서비스 무료 키 받기	1분에 20번 → 500번
윈도우에서 파이썬 명령이 스토어를 열어요	파이썬 실행 명령이 마이크로소프트 스토어로 연결됨	윈도우용 실행 명령이나 실제 파이썬 경로 쓰기(설치 설명서 안내)	윈도우 테스트 추가일 8월 6일

첫 줄 증상의 실제 화면입니다. 레딧 게시판 주소를 웹 글 읽기 서비스로 부르면 본문 대신 "로그인하거나 개발자 토큰을 쓰라"는 차단 안내가 돌아와요. 설치를 마쳐도 웹 글 채널로는 레딧이 안 읽힌다는 뜻입니다.

원래 도구를 직접 쓰는 것과 무엇이 다를까?

같은 유튜브 영상으로 비교하면 자막 받기 도구를 직접 쓰든 Agent Reach로 부르든 결과는 같습니다. 부르는 명령이 같거든요. 반면 Agent Reach를 깔면 설치·점검·사용법 등록을 대신 받고, 레딧·X로 가는 로그인 연결 길이 하나 생겨요.

자막과 웹 글 두 가지만 쓸 생각이면 원래 도구로 충분합니다. 세 곳 이상을 한 번에 붙이고 싶을 때 이 도구를 꺼내세요.

깔아도 안 되는 것

• 국내 포털(네이버·카카오·다음)용 채널이 없어요. 틱톡은 목록에 아예 없습니다
• 가져온 글에 숨어 있는 명령을 AI가 무시하도록 하는 지침은, 확인한 설명서에는 없어요
• 웹 글은 전부 변환 서비스의 서버를 지나요. 그쪽 공개 페이지에 데이터 보관 기간이 적혀 있지 않습니다
• 설치든 업데이트든 버전이 고정되지 않아요. 같은 문장이 날짜에 따라 다른 코드를 깝니다
• 코드가 마지막으로 바뀐 날은 9월 15일이고, 이후 바깥 수정 제안은 반영되지 않았어요

회사 주소를 읽혀야 하거나 같은 버전을 그대로 재현해야 하는 일이라면 여기서 멈추는 게 맞습니다.

점검 목록

• [ ] 1단계: 옵션 없이 점검만 받고 빠진 목록을 봤다
• [ ] 2단계: 미리보기로 컴퓨터 전체에 깔릴 도구를 확인했다
• [ ] 3단계: 기본 채널만 먼저 승인했다
• [ ] 3단계: 유튜브 영상 하나로 자막이 실제로 나오는지 시켜 봤다
• [ ] 4단계: 쿠키를 넘기는 계정이 부계정이다
• [ ] 5단계: 같은 이름 패키지 설치 명령을 쓰지 않았다
• [ ] 6단계: 지운 뒤 남은 연결 항목을 확인했다(윈도우)

체크가 다 되면 설치는 끝났습니다. 레딧이 정말 필요한지는 그다음에 따로 정하세요.

1단계 점검에서 빠졌다고 나온 채널이 몇 개였는지 댓글로 남겨 주세요. 위 여섯 단계를 한 장에 담은 클로드 코드용 지시문은 오픈톡 '방구석모각코'의 공지 링크(https://open.kakao.com/o/picxsxwi)에서 받을 수 있고, 단계별 화면은 9분짜리 해설 영상에 있어요.