75단계외부 자동화 도구에 Claude 연결하기

걸리는 시간 · 읽기 약 10분 · 따라 하기 약 60분 · 난이도 ★★★ 심화 · 화면 확인 2026.09.27

이 단계를 마치면

• 외부 자동화 도구의 흐름 안에 Claude를 한 단계로 넣을 수 있다.
• Claude Console에서 API 키를 발급받고 사용 한도를 걸어 둘 수 있다.
• API 키를 안전하게 다룰 수 있다.
• 사람이 중간에 읽지 않는 흐름에 맞게, 되묻지 않고 출력 형식이 정해진 지시문을 쓸 수 있다.

고객이 웹사이트 문의 폼을 제출하면 누군가 그 내용을 읽고 분류해 시트에 옮겨 적는다. 그 '누군가'를 Claude로 바꿀 수 있을까? Claude 앱 안의 예약만으로는 닿지 않는 일이다. 새 메일이 오면, 폼이 제출되면, 시트에 행이 추가되면 시작하는 흐름에는 다른 도구가 필요하다. 이런 사건을 받아 여러 서비스를 이어 주는 도구가 Zapier, Make, n8n이다. 모두 "무엇이 일어나면 무엇을 한다"를 블록처럼 이어 붙이는 방식이고, 그 블록 가운데 하나로 Claude를 넣을 수 있다.

앱 대신 API로 부른다

외부 도구에서 Claude를 부를 때는 채팅 앱 대신 Claude API를 쓴다. 화면 밖에서 Claude에게 글을 보내고 답을 받는 통로다. 그래서 Anthropic 콘솔에서 API 키를 만들어 외부 도구에 넣는 과정이 필요하다.

API 키는 비밀번호와 같다. 키를 가진 사람은 누구든 내 계정으로 Claude를 부를 수 있고, 그 사용료는 내 계정에 청구된다. 문서나 채팅방에 붙여 넣지 말고, 흐름 설명 문서에도 적지 않는다. 퇴사했거나 다른 팀으로 옮긴 사람이 알던 키는 바꾼다. 자동화마다 키를 따로 두면 어느 흐름이 얼마를 썼는지 나눠 보기 쉽고, 문제가 생긴 흐름의 키만 끊을 수 있다. API 사용료는 앱 구독과 따로 청구될 수 있으니, 계산하는 법은 79단계에서 함께 본다. API는 96단계에서 더 자세히 다룬다.

API 키 발급받기

API 키는 Claude 앱 계정과 따로 관리된다. 개발자용 관리 화면인 Claude Console에서 만든다. 앱 구독이 있어도 API 사용료는 이곳에서 따로 결제하고 따로 청구된다. 처음 한 번은 순서대로 따라 해 보자. 메뉴 이름과 위치는 업데이트에 따라 조금씩 바뀌니, 화면이 책과 다르면 비슷한 이름의 메뉴를 찾거나 공식 도움말을 확인한다.

1. 콘솔에 가입하고 로그인한다. 브라우저에서 console.anthropic.com에 들어간다. 다른 주소로 넘어가더라도 그대로 따라가면 된다. 회사 업무로 쓸 것이라면 개인 메일보다 회사 메일로 가입한다. 퇴사나 인사이동 때 계정을 넘기기 쉽다.
2. 조직 정보와 결제 수단을 등록한다. API는 쓴 만큼 비용이 나간다. 결제 화면에서 카드를 등록하고, 안내에 따라 크레딧을 충전하거나 결제 방식을 정한다. 결제가 등록되지 않은 계정의 키는 만들어도 호출이 실패할 수 있다.
3. 사용 한도부터 정한다. 키를 만들기 전에 한도 설정 화면에서 월 사용 한도를 낮게 잡아 둔다. 처음에는 예상 사용량보다 조금 넉넉한 정도면 충분하다. 흐름이 잘못 돌아 같은 요청을 끝없이 보내도 한도에서 멈춘다.
4. 키를 만든다. 설정의 API 키 메뉴에서 새 키를 만든다. 이름은 쓰임새가 드러나게 짓는다. "마케팅-문의분류-zapier"처럼 팀, 흐름, 도구를 넣으면 나중에 어느 키가 어디 쓰이는지 한눈에 보인다. 회사 계정이라 워크스페이스를 고르는 단계가 있다면 이 흐름이 속한 팀의 워크스페이스를 고른다.
5. 키를 한 번만 복사해 바로 넣는다. 키는 sk-ant-로 시작하는 긴 문자열이다. 이 전체 값은 만든 직후 한 번만 보여 준다. 창을 닫으면 다시 볼 수 없으니, 복사한 즉시 외부 도구의 연결 설정에 붙여 넣는다. 메모장, 메일, 메신저, 공유 문서를 거치지 않는다. 회사에 비밀번호 관리 도구가 있으면 거기에 보관한다.
6. 연결을 시험한다. 외부 도구의 연결 시험 기능으로 확인하거나, 짧은 문장 하나를 보내는 흐름을 돌려 답이 오는지 본다. 답이 오면 콘솔의 사용량 화면에 기록이 한 건 늘었는지도 확인한다.
7. 키 목록을 관리한다. 쓰지 않게 된 키, 주인이 떠난 키, 어딘가에 노출된 키는 바로 폐기하고 새로 만든다. 폐기한 키를 쓰던 흐름은 새 키로 바꿀 때까지 멈춘다. 그러니 흐름 이름과 키 이름을 맞춰 두어야 무엇을 바꿀지 금방 찾는다.

개발팀이나 Claude Code로 키가 살아 있는지 직접 확인하고 싶다면 터미널에서 아래 명령을 쓸 수 있다. 키를 명령에 직접 적지 않고 환경변수에 넣어 두는 방식이다. 모델 이름은 공식 문서의 모델 목록에서 지금 쓸 수 있는 이름으로 바꾼다.

export ANTHROPIC_API_KEY="여기에 키를 붙여 넣는다"
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 100,
       "messages": [{"role": "user", "content": "연결 시험입니다. 한 문장으로 답해 주세요."}]}'

답으로 Claude의 문장이 담긴 결과가 돌아오면 키가 제대로 작동하는 것이다. 인증 오류가 나오면 키를 잘못 붙여 넣었거나 이미 폐기된 키다. 결제나 한도와 관련된 오류가 나오면 2단계와 3단계로 돌아가 확인한다.

세 도구 가운데 무엇을 고를까

어느 도구를 쓸지는 회사 사정이 정한다. 이미 쓰는 도구가 있으면 그것을 쓴다. 새로 배우는 데 드는 품이 가장 크기 때문이다. 사내 서버에 직접 설치해 데이터를 밖으로 덜 내보내고 싶은 회사는 n8n을 검토하기도 한다. 어느 도구든 Claude 단계를 넣는 메뉴 이름과 설정 항목은 업데이트에 따라 바뀐다. 각 도구의 도움말에서 Claude나 Anthropic을 찾아 최신 방법을 따른다. 도입하기 전에는 회사 데이터가 그 도구를 거쳐도 되는지 IT 담당에게 먼저 묻는다.

흐름 속 지시문은 다르게 쓴다

Claude 단계에 들어가는 지시문도 앱에서 쓰던 프롬프트와 뼈대는 같다. 다만 두 가지가 다르다. 첫째, 중간에 사람에게 되물을 수 없다. "모르면 물어봐 줘" 대신 "모르면 이것을 출력하라"를 넣는다. 둘째, 출력을 읽는 쪽이 다음 단계다. 다음 단계는 "분류:" 뒤의 글자를 시트의 분류 열에 넣는 식으로 기계적으로 읽는다. 앞에 인사말 한 문장만 붙어도 값이 엉뚱한 곳에 들어간다. 그래서 출력 형식을 딱 정해 둔다.

"확신" 항목은 나중에 요긴하게 쓰인다. 확신이 낮은 건만 사람이 보면 되기 때문이다. 덕분에 77단계의 승인 단계에서 모든 건을 일일이 볼 필요가 없어진다.

현장 장면

마케팅팀 한 매니저는 웹사이트 문의 폼을 Zapier에 연결했다. 폼이 제출되면 문의 내용을 Claude 단계로 넘기고, 돌아온 분류와 요약을 시트에 한 행으로 적는 흐름이다. 여기서 Claude는 여러 단계 가운데 하나일 뿐이고, 나머지는 외부 도구가 맡는다.

처음 넣은 지시는 이랬다. "이 문의를 제품 문의·제휴 제안·채용·기타로 분류하고 한 줄로 요약해." 시험 삼아 폼을 세 번 제출했다. 첫 건의 출력은 "이 문의는 제품 문의로 보입니다. 요약하면, 고객이 대량 구매 조건을 묻고 있습니다."였다. 공손하고 친절한 답이었지만, 시트의 분류 칸에는 이 문장이 통째로 들어갔다. 둘째 건은 "분류: 제휴 제안"으로 제대로 시작했다. 셋째 건은 "분류: 채용"처럼 꾸밈 기호가 붙어 나왔다. 세 번 모두 모양이 달랐으니, 다음 단계가 제대로 나눠 읽을 리 없었다.

사람에게는 친절한 답이 기계에게는 골칫거리였다. 매니저는 지시를 아래 프롬프트처럼 바꿨다. "너는 자동화 흐름의 한 단계다"라는 문장으로 처지를 알려 주고, 출력 형식을 세 줄로 못 박고, 다른 말을 붙이지 말라고 했다. 빈 폼이 들어올 때를 대비해 "확인필요"라는 값도 정했다. 테스트 데이터 열 건을 넣어 보니 출력 모양이 모두 같았고, 스팸처럼 보이는 한 건은 "확인필요"로 나왔다. 그 한 건만 사람이 따로 보면 된다.

따라 하기

1. 회사에서 쓰는 외부 자동화 도구가 있는지 IT 담당에게 확인한다. 없으면 셋 중 하나에 연습용 계정을 연다. 요금 조건은 각 도구의 안내에서 확인한다. 성공 기준: 쓸 도구와 계정이 정해졌고, 회사 데이터를 태워도 되는지 답을 받았다.
2. 위의 "API 키 발급받기" 순서대로 Claude Console에서 결제와 월 사용 한도를 정하고, 이 흐름 전용 API 키를 만들어 외부 도구의 Claude 연결 설정에 넣는다. 성공 기준: 연결 시험이 통과했고, 콘솔 사용량 화면에 시험 호출이 기록되었으며, 키를 다른 곳에 적어 두지 않았다.
3. 트리거 하나(시트에 새 행 등)와 Claude 단계 하나만 있는 흐름을 만든다. 처음에는 단계를 늘리지 않는다. 성공 기준: 흐름이 두 단계로만 되어 있다.
4. 아래 프롬프트를 Claude 단계에 넣고 테스트 데이터를 다섯 건 이상 넣는다. 빈 입력과 엉뚱한 입력도 한 건씩 섞는다. 성공 기준: 모든 출력이 정한 세 줄 모양 그대로이고, 엉뚱한 입력은 "확인필요"로 나왔다.
5. 출력이 흔들리면 지시문의 출력 형식 부분을 더 좁힌다. 예시 출력을 하나 보여 주는 것도 방법이다. 성공 기준: 같은 테스트를 다시 돌렸을 때 모양이 흔들리지 않는다.

복사해 쓰는 프롬프트

너는 자동화 흐름의 한 단계다. 사람이 중간에 읽지 않고, 네 출력을 다음 단계가 그대로 받아 쓴다.

입력: [앞 단계에서 넘어오는 내용]

할 일: [분류·요약·추출 중 무엇을 하는지]
분류 기준: [범주 목록과 각 범주의 뜻 한 줄씩]

출력 형식: 아래 모양 그대로, 다른 말이나 꾸밈 기호는 붙이지 않는다.
분류: [범주 중 하나]
요약: [한 문장]
확신: 높음 또는 낮음

입력이 비어 있거나 판단할 수 없으면 분류를 "확인필요"로 적는다.

막히면 이렇게

실습 파일

공개 저장소에 올려 둔 가공 자료와 양식이다. 회사 자료 대신 먼저 이것으로 해 본다.

• 샘플 자료 고객문의_샘플.csv · 여러 채널로 들어온 고객 문의 40건
• 샘플 자료 민원_샘플.csv · 가람시에 들어온 민원 20건

스스로 점검

• ☐ API 키가 문서·채팅방·흐름 설명 어디에도 적혀 있지 않은가.
• ☐ 지시문에 "모를 때 무엇을 출력하는가"가 들어 있는가.
• ☐ 빈 입력과 엉뚱한 입력으로도 시험했는가.

기억할 것

• 외부 도구 속 Claude는 되물을 수 없다. 모를 때 무엇을 낼지와 출력 모양을 못 박는다.
• API 키는 비밀번호다. 흐름마다 따로 두고, 사람이 바뀌면 바꾼다.

더 알아보기 · Claude Console · Zapier의 Claude 연동 · n8n 문서