클로드 루틴 설정 방법, 초록 표시만으로는 카톡이 갔는지 모른다

이번에 버스 도착 편을 준비하면서, 6월에 만든 아침 브리핑 루틴의 실행 기록을 다시 열어 봤습니다. 6월 12일 실행은 목록에 '완료됨'으로 떠 있던 건이에요.

기록 맨 아래엔 카카오맵 경로 조회가 결과를 돌려주지 않아 지하철 소요 시간을 '일반적 지식 기준으로 추산했다'는 문장이 거기 있었어요. 목록엔 완료, 카톡엔 추산한 30~35분. 같은 실행에서 나온 두 결과였어요.

결론부터 적겠습니다. 클로드 루틴의 초록 표시는 작업이 성공했다는 증거가 아니고, 이번 버스 브리핑의 설정은 거의 전부 그 빈틈을 막으려고 들어간 겁니다. 루틴으로 외부 창구를 부르는 자동화를 만들어 봤는데 결과를 믿어도 되는지 헷갈리는 분께, 설정마다 무엇을 막는지 풀어 드리려고 해요.

이 글은 클릭 순서를 다루지 않습니다. 어떤 메뉴를 누르는지가 아니라, 왜 그 값을 고르는지만 다룹니다.

초록 표시가 보증하는 것

클로드 코드 루틴 공식 문서는 초록 표시의 뜻을 한 문장으로 못 박아 두었습니다. 세션이 인프라 오류 없이 열리고 닫혔다는 뜻이고, 지침에 적은 일이 성공했다는 뜻은 아니라고요.

같은 문단이 실패가 드러나는 곳도 알려 줍니다. 막힌 네트워크 요청, 빠진 커넥터 도구, 작업 단계의 실패는 상태 표시가 아니라 실행 기록 안에서만 보인다고 해요. 6월 루틴의 추산은 이 셋 중 마지막에 해당합니다.

그러니 성공 판정은 실행 목록이 아니라 실행 기록을 열어서 내려야 합니다.

도착 시간과 경로를 다른 창구에서 받기

버스 브리핑에 키가 두 개 필요한 건 제가 고른 구조가 아닙니다. 데이터가 원래 두 곳에 나뉘어 있어요.

카카오맵 대중교통 경로 창구는 걸리는 시간(초), 환승 횟수, 거리, 요금, 구간 목록을 돌려줍니다. 응답 항목 어디에도 '몇 분 뒤 도착'은 없어요. 1편 브리핑이 버스 도착 대신 예상 소요 시간 한 줄만 받았던 것도 이 때문입니다.

도착 예정은 공공데이터포털의 버스 창구가 갖고 있습니다. 서울 정류소 창구는 정류장 번호 하나로 노선마다 첫째·둘째 버스 도착 메시지를 한꺼번에 주고, 경기 창구는 두 대의 예측 시간에 남은 좌석 수까지 얹어 줘요. 카톡에 "3분 뒤, 다음 9분"처럼 두 대가 찍히는 건 이 응답 모양을 그대로 옮긴 결과입니다.

한 창구로 둘 다 받을 방법은 없으니, 키를 줄이려 애쓰기보다 각 창구에 맞는 키를 받는 쪽이 빠릅니다.

키보다 나가는 주소를 먼저 열기

키를 다 받아도 루틴은 창구에 닿지 못할 수 있습니다. 새 루틴이 쓰는 기본 환경의 네트워크 값이 '신뢰됨'이기 때문이에요. 자주 쓰는 개발용 주소만 열어 둔 목록이라, 공공데이터포털 쪽 주소와 카카오 주소는 빠져 있습니다.

목록에 없는 주소로 나가면 요청은 403으로 거절됩니다. 그리고 이 거절도 초록 표시 뒤에 숨어요. 앞 문단에서 본 '막힌 네트워크 요청'이 정확히 이 경우입니다.

그래서 환경을 하나 더 두고, 그 환경만 '사용자 지정' 네트워크로 바꿔 주소 세 줄을 열었습니다. 기본 환경 대신 새 환경을 만든 건, 열어 둔 주소가 이 루틴 바깥으로 번지지 않게 하려는 거예요. 6월 루틴은 카카오 도구 모음 커넥터를 거친 다른 길이었지만, 실패가 초록 뒤에 숨은 모양은 같았습니다.

키를 두 곳에 나눠 넣기

카카오 키와 공공데이터 키는 같은 편집 창의 다른 곳에 들어갑니다. 키가 요청에 실리는 방식이 달라서예요.

비교	공공데이터포털 인증키	카카오 개발자 키(머리말에 실림)
요청 속 위치	주소 맨 뒤 키 항목	인증 표시 + 카카오 접두사
넣는 메뉴	환경 변수	API 자격 증명
클로드에게 값이 보이나	보임	보이지 않음
저장한 다음	고쳐서 다시 저장	볼 수도 고칠 수도 없음

API 자격 증명은 세션이 키를 보지 않고도 창구를 부르게 해 주는 장치입니다. 공식 문서는 확인 방법도 적어 두었어요. 세션에서 창구를 불러 보면 키가 들어간 것처럼 답이 오는데, 키는 세션의 환경 변수에도 파일에도 나타나지 않는다고요.

머리말에 키를 싣는 카카오는 이 장치에 그대로 맞습니다. 공공데이터 키처럼 주소 끝에 붙는 키를 위한 방식도 자격 증명 목록에 있긴 해요. 하지만 그 방식이 키 항목 이름을 어떻게 받는지, 주소에 어떻게 붙이는지는 문서에 없습니다.

저는 동작이 문서로 확인되지 않은 쪽 대신 환경 변수를 골랐어요. 대가는 분명합니다. 환경 변수는 클로드가 읽을 수 있고, 화면에도 이 환경을 쓰는 모든 사람에게 보인다고 적혀 있어요. 내가 만든 환경은 내 계정 전용이라 혼자 쓰는 환경에서만 이 선택이 성립합니다.

이 판단은 틀릴 수 있습니다. 주소 끝에 붙는 키도 자격 증명으로 숨길 수 있다는 게 확인되면, 공공데이터 키도 그쪽으로 옮기는 게 맞아요.

좌표를 적어 두지 않고 매일 다시 찾기

경로 창구는 출발지와 도착지를 주소가 아니라 좌표로 받습니다. 집과 회사 좌표를 한 번 찾아 루틴 문장에 적어 두고 싶어지는 지점이에요.

카카오 운영진은 2026년 9월 1일 개발자 게시판에서 로컬 창구 결과를 저장해 쓰는 건 허용하지 않고 실시간 호출로만 쓸 수 있다고 답했습니다. 그래서 루틴 문장엔 주소만 적고, 루틴이 매일 같은 키로 주소를 좌표로 바꾼 뒤 경로를 부르게 했어요.

비용은 하루 2건이 늘어나는 게 전부입니다. 주소 검색 무료 몫이 하루 100,000건이라 0.002%예요.

날씨를 기상청 창구 대신 검색으로 받기

공공데이터포털엔 기상청 단기예보 창구가 있습니다. 그런데 이 창구는 위도·경도가 아니라 기상청이 전국을 5km 네모로 나눈 격자 번호를 받아요. 위경도를 격자 번호로 바꾸는 공식 기능은 기상청 API허브에 따로 가입하고 키를 하나 더 받아야 씁니다.

신선도도 이득이 없습니다. 단기예보 발표는 하루 여덟 번, 3시간 간격이에요. 7시 57분에 부르면 받을 수 있는 가장 새 발표가 새벽 5시 것입니다.

가입 하나와 키 하나를 더 들여도 더 새 값이 오지 않으니, 날씨는 1편처럼 클로드가 검색해 오게 뒀습니다.

종목 시세도 같은 이유로 검색에 맡기기

금융위원회 주식시세 창구는 데이터 목록에 '실시간'이라고 적혀 있습니다. 본문은 다르게 말해요. 갱신은 기준일 다음 영업일 오후 1시 이후라고요.

그대로 계산하면 화요일 7시 57분 브리핑이 받을 수 있는 가장 최근 값은 금요일 종가입니다. 월요일 아침이면 목요일 종가고요. 키를 하나 더 받아도 더 새 값이 오지 않는다는 점에서 날씨와 같은 결론이에요.

200자가 줄 수를 정한다

카톡을 보내는 나와의 채팅방 도구의 입력 설명엔 최대 200자라고 적혀 있습니다. 9월 30일에 제가 받은 브리핑은 175자였어요.

버스 세 노선을 두 대씩, 경로 한 줄, 날씨 한 줄, 종목 두 줄을 넣으니 25자가 남았습니다. "472번 3분 뒤, 다음 11분" 같은 버스 줄 하나가 20자 남짓이라 한 통에 이런 줄이 열 개 남짓 들어가요.

구글 캘린더 일정이나 퇴근 경로를 붙이고 싶다면 무언가를 빼야 합니다. 줄을 더하는 설계가 아니라 바꾸는 설계라고 보는 게 정확해요.

커넥터를 하나만 남기기

새 루틴 화면을 처음 열었을 때, 연결해 둔 커넥터 일곱 개가 전부 기본으로 들어 있었습니다. 같은 화면 아래엔 쓰기 작업을 포함해 이 커넥터들을 실행 중에 묻지 않고 쓸 수 있다는 경고가 붙어 있었고요.

버스 브리핑이 쓰는 건 카톡 보내는 커넥터(PlayMCP) 하나뿐입니다. 나머지는 지워 두는 게 실수로 다른 곳에 무언가를 쓰는 일을 막는 가장 싼 방법이에요.

하지만 초록은 여전히 아무것도 증명하지 않는다

여기까지 설정해도 실행 목록의 표시는 똑같은 초록입니다. 그래서 확인은 세 군데에서 따로 했어요.

먼저 실행 기록의 값입니다. 버스 도착 분, 경로 분, 날씨가 숫자로 찍혔는지 봐요. 두 번째는 카톡 도구 호출 줄이에요. 값이 다 있어도 이 줄이 없으면 카톡은 안 갑니다. 세 번째는 403이나 막힘 표시가 없는지입니다.

자격 증명은 루틴과 따로 확인했습니다. 그 환경으로 새 작업을 띄워 카카오 주소 검색을 시켜 보면 키가 붙었는지 바로 드러나요. 목록 항목에 '보내지 않음'이 붙어 있으면 아래 설명이 원인과 해법을 알려 줍니다.

이번 루틴은 지금 실행으로 두 번 돌렸고, 두 번 모두 실행 기록까지 열어 확인한 뒤 카톡이 온 걸 봤습니다. 6월 루틴과 달라진 건 표시가 아니라 확인하는 습관이었어요.

0원은 창구 요금에 대한 말이다

아침 한 번에 부르는 횟수를 하루 무료 몫으로 나누면 이렇게 나옵니다.

창구	하루 사용 비율
공공데이터 버스 도착	1 ÷ 1,000 = 0.1%
주소 → 좌표	2 ÷ 100,000 = 0.002%
대중교통 경로	1 ÷ 1,000 = 0.1%

창구 요금은 0원이 맞습니다. 다만 루틴은 대화형 세션과 같은 방식으로 클로드 구독 사용량을 씁니다. 예약 실행은 계정당 한 시간에 100번이라는 한도도 따로 있어요. 루틴 기능 자체가 아직 미리보기라, 10월 1일에 문서를 다시 열어 맞춘 이 숫자들도 바뀔 수 있습니다.

다섯 줄로 접으면

• 6월의 추산값은 → 성공을 실행 기록에서 확인하는 습관이 됐고
• 키 두 개는 → 데이터가 나뉜 곳마다 키를 받는 원칙이 됐고
• 403 거절은 → 나가는 주소를 키보다 먼저 여는 순서가 됐고
• 환경 변수의 노출은 → 개인 환경에서만 쓰는 조건이 됐고
• 저장 금지 답변은 → 매일 다시 찾는 설계가 됐습니다

1. 상태 표시가 아니라 실행 기록으로 확인한다.
2. 데이터가 있는 창구마다 키를 따로 받는다.
3. 키보다 나가는 주소를 먼저 연다.
4. 클로드가 봐도 되는 값과 안 되는 값을 나눠 넣는다.
5. 매일 부를 수 있는 값은 저장하지 않는다.

제 6월 12일 기록의 30~35분처럼, 초록 뒤에 추산값이 숨어 있을 수 있습니다. 지금 쓰는 루틴이 있다면 실행 기록을 마지막으로 연 게 언제인지 떠올려 보세요. 오늘 하나만 열어 숫자가 어디서 왔는지 확인해 보시길 권합니다.

설정 화면을 하나씩 짚는 과정은 유튜브에 올린 설정 과정에 담았습니다. 루틴 문장과 허용 주소 목록을 대화로 뽑아 주는 무료 스킬은 오픈톡 '방구석모각코' 방에서 나눠 드려요. 압축을 풀 비밀번호는 영상 4:03 장면에서 알려 드립니다.