n8n의 Claude. 연결된 종이 워크플로 노드가 짧게 이어지며, 트리거 카드에서 코드 블록을 거쳐 완성된 문서로 연결됩니다.

Claude를 n8n에 연결하기

n8n의 Anthropic 노드에는 Base URL 필드가 있으며, 이 필드만 설정하면 Claude 호출을 AI Prime Tech를 통해 라우팅할 수 있습니다. 이후 Claude를 AI Agent 및 LLM Chain 노드에 연결하면 자동화에서 Claude의 추론을 활용하면서 하나의 게이트웨이로 결제를 통합할 수 있습니다.

Anthropic 인증 정보 만들기

n8n에서 Anthropic 인증 정보를 만드세요. API Key 필드의 값은 x-api-key 헤더로 전송되며, Base URL 필드는 게이트웨이를 가리킵니다. AI Agent 또는 Basic LLM Chain에 연결된 Anthropic Chat Model 노드에 이 인증 정보를 연결하세요.

Base URL에는 호스트 루트만 입력하세요. n8n이 채팅에는 /v1/messages를, 인증 정보 테스트에는 /v1/models를 추가합니다. /v1을 직접 추가하면 /v1/v1처럼 중복된 경로가 생성됩니다.

'/v1/models' 인증 정보 함정

'n8n Claude API 키가 작동하지 않는다'는 보고에서 가장 흔한 원인은 잘못된 키가 아닙니다. 인증 정보를 저장할 때 n8n은 anthropic-version 헤더와 함께 GET {BaseURL}/v1/models를 호출하여 테스트합니다. /v1/models를 구현하지 않은 게이트웨이는 채팅이 작동하더라도 이 테스트에 실패합니다.

AI Prime Tech는 /v1/models를 구현하므로 인증 정보가 문제없이 저장됩니다. 이를 지원하지 않는 게이트웨이를 앞단에 배치하더라도 인증 정보가 저장되고 나면 채팅 노드는 정상적으로 작동합니다. 실패하는 것은 테스트뿐입니다.

인증 헤더 불일치

n8n의 Anthropic 노드는 Authorization: Bearer가 아니라 x-api-key로 인증합니다. Bearer를 기대하는 게이트웨이는 401을 반환하므로 키가 잘못된 것처럼 보입니다. 필요한 경우 인증 정보의 사용자 지정 헤더 추가 토글을 사용하여 Bearer를 보내세요.

Base URL 끝의 슬래시도 확인하세요. 불필요한 슬래시가 있으면 //v1/messages 경로 오류가 발생합니다.

자동화에 게이트웨이가 유용한 이유

n8n 워크플로는 일정, 웹훅, 트리거에 따라 사람의 개입 없이 상시 실행됩니다. 매시간 실행되는 요약 작업이나 티켓별 분류 작업 하나만으로도 Claude 호출이 꾸준히 쌓이며, 사용량을 지켜보는 사람은 없습니다.

이를 AI Prime Tech를 통해 라우팅하면 잔액과 로그를 한곳에서 관리할 수 있고, 모든 노드의 인증 정보를 다시 설정하지 않아도 워크플로별로 모델을 전환할 수 있습니다.

# n8n -> Credentials -> Anthropic
# API Key:  <your gateway key>
# Base URL: https://aiprimetech.io        (host root, NO /v1)
# Attach to: Anthropic Chat Model -> AI Agent node
# If gateway needs Bearer: 'Add Custom Header'
#   Authorization: Bearer <key>

자주 묻는 질문

Claude를 n8n에 어떻게 연결하나요?

Anthropic 인증 정보를 만들고, Base URL을 게이트웨이 호스트 루트(/v1 제외)로 설정한 다음, 키를 붙여 넣고 Anthropic Chat Model 노드에 연결하세요.

n8n에서 Claude 키가 작동하지 않는다고 하는 이유는 무엇인가요?

인증 정보 테스트가 /v1/models를 호출하기 때문입니다. 해당 엔드포인트가 없는 게이트웨이는 채팅이 작동하더라도 테스트에 실패합니다. AI Prime Tech는 이 엔드포인트를 구현하므로 인증 정보가 저장됩니다.

Bearer와 x-api-key 중 무엇을 사용하나요?

n8n의 Anthropic 노드는 x-api-key를 전송합니다. 게이트웨이에 Bearer가 필요하면 사용자 지정 헤더 추가를 사용하세요.

Base URL에 /v1을 포함해야 하나요?

아니요. 호스트 루트만 사용하세요. n8n이 경로를 직접 추가합니다.

몇 분 만에 Claude 사용 시작하기

API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.

API 키 발급받기

AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.