AI코딩 완전정복 › 클로드·GPT 완전정복 100단계 › 제5편 · 자동화와 조직 확산 › 제9부 › 75단계
이 쪽을 PDF로 보기
제9부 · 알아서 돌아가게 만들기

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

Zapier·Make·n8n에서 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단계로 돌아가 확인합니다.

ChatGPT·Codex에서는 OpenAI도 ChatGPT 구독과 API를 따로 관리합니다. 키는 개발자 대시보드의 API Keys 화면(platform.openai.com/api-keys)에서 새 비밀 키로 만들고, 만든 즉시 안전한 곳에 보관한 뒤 환경변수 OPENAI_API_KEY에 넣습니다. 부르는 방법은 Responses API이며, SDK(pip install openai 또는 npm install openai)에서 client.responses.create(...)에 모델 이름과 input을 넘기면 답이 output_text로 돌아옵니다. 외부 자동화 도구에서 OpenAI 단계를 넣을 때도 이 키를 씁니다. 대시보드의 메뉴 이름과 한도 설정 위치는 이 책에서 확인하지 못했으니 화면에서 확인합니다. 키를 다루는 원칙은 위와 같습니다. 흐름마다 따로 만들고, 어디에도 적어 두지 않습니다.

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

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

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

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

앱에서 쓰는 지시 흐름 속 지시
모를 때 "모르면 물어봐 줘" "판단할 수 없으면 '확인필요'로 적는다"
출력 모양 대략 정해도 사람이 알아서 읽습니다 항목 이름과 순서를 못 박고 "다른 말은 붙이지 않는다"
길이 대화하며 조절 한 문장, 다섯 줄 이내처럼 정합니다
확신 대화 중에 드러납니다 "확신: 높음·낮음" 항목을 따로 둡니다

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

Codex에서는 개발팀이라면 Zapier 같은 도구 대신 codex exec로 흐름 속 한 단계를 만들 수 있습니다. 대화 없이 한 번 실행하고 끝나며, 최종 답만 표준 출력으로 내보내므로 다음 단계가 받아 쓰기 좋습니다(-o로 파일에 저장, --output-schema로 출력 모양 고정). 기본값은 읽기 전용 샌드박스라서, 파일을 고치게 하려면 --sandbox workspace-write를 따로 붙여야 합니다. 저장소에 PR이 올라올 때처럼 CI에서 돌리려면 GitHub Action openai/codex-action@v1에 openai-api-key와 prompt를 넣고, 결과는 final-message 출력으로 받습니다. 인증에는 API 키를 권장하는데, 저장소 코드를 실행하는 잡 전체에 OPENAI_API_KEY를 환경변수로 걸어 두지 말라는 공식 경고가 있으니 그 실행에만 넘깁니다. API 키로 쓰면 API 요금으로 청구되고 Codex cloud 같은 클라우드 기능은 쓸 수 없습니다.

현장 장면

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

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

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

따라 하기

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

복사해 쓰는 프롬프트

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

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

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

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

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

막히면 이렇게

증상 원인 처방
시트의 한 칸에 문장이 통째로 들어갑니다 출력 모양을 정하지 않았습니다 항목 이름과 순서를 못 박고 "다른 말은 붙이지 않는다"를 넣습니다
키를 만들었는데 호출이 실패합니다 결제 수단이 없거나 크레딧이 바닥났거나 한도에 걸렸습니다 콘솔의 결제·한도·사용량 화면을 차례로 확인합니다
만든 키를 다시 보려는데 보이지 않습니다 키 전체 값은 만들 때 한 번만 보여 줍니다 그 키는 폐기하고 새로 만들어 바로 연결 설정에 넣습니다
Claude 단계가 인증 오류로 멈춥니다 API 키가 잘못 들어갔거나 바뀌었습니다 콘솔에서 키가 살아 있는지 보고, 필요하면 새 키를 만들어 다시 넣습니다
엉뚱한 입력에도 억지로 분류가 붙습니다 모를 때 낼 값을 정하지 않았습니다 "판단할 수 없으면 확인필요"와 "확신" 항목을 둡니다
누가 만든 흐름인지, 키가 어디 쓰이는지 모릅니다 공용 키 하나를 여러 흐름이 나눠 씁니다 흐름마다 키를 따로 만들고 흐름 이름을 키 이름에 붙입니다

실습 파일

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

스스로 점검

  • ☐ API 키가 문서·채팅방·흐름 설명 어디에도 적혀 있지 않습니까?
  • ☐ 지시문에 "모를 때 무엇을 출력하는가"가 들어 있습니까?
  • ☐ 빈 입력과 엉뚱한 입력으로도 시험했습니까?
점검 해설 보기
  1. 키가 콘솔에서 복사한 즉시 외부 도구의 연결 설정에만 들어가 있고, 메모장·메일·메신저·공유 문서·흐름 설명 어디에도 남아 있지 않으면 통과입니다. 어딘가에 적어 둔 적이 있다면 「API 키 발급받기」 7번대로 그 키를 폐기하고 새로 만들어 넣습니다.
  2. 지시문에 "입력이 비어 있거나 판단할 수 없으면 분류를 '확인필요'로 적는다"처럼 모를 때 낼 값이 정해져 있으면 통과입니다. "모르면 물어봐 줘"가 남아 있다면 「흐름 속 지시문은 다르게 쓴다」의 표를 다시 보고, 되물을 수 없는 흐름에 맞게 고칩니다.
  3. 테스트 데이터 다섯 건 이상에 빈 입력과 엉뚱한 입력이 한 건씩 섞여 있고, 모든 출력이 정한 세 줄 모양 그대로이며 엉뚱한 입력은 "확인필요"로 나왔으면 통과입니다. 모양이 흔들리면 「따라 하기」 5번대로 출력 형식을 더 좁히거나 예시 출력을 하나 보여 줍니다.

기억할 것

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

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

v2026.09.27.7 · 2026년 9월 27일 기준 · CEO비즈니스스쿨 김문수 교수 · 기능과 화면은 자주 바뀝니다. 책과 화면이 다르면 부록의 공식 문서가 기준입니다.