AI가 나한테 전화하게 만드는 법 (클로드 코드 + Bland)

어떻게 돌아가요?

전화를 거는 건 클로드 코드가 아니라 Bland라는 AI 전화 서비스예요. 클로드 코드는 Bland한테 "전화 걸어 줘"라고 부탁하는 역할이에요.

1. 클로드 코드가 일을 하다가 물어볼 게 생겨요
2. 클로드 코드가 Bland에 요청을 보내요: 누구한테(내 번호), 무슨 말을(질문)
3. Bland의 AI 목소리가 내 폰으로 전화를 걸어 질문해요
4. 내가 말로 답해요
5. 통화가 끝나면 Bland에 **통화 기록(글로 받아쓴 대화)**과 요약이 남아요
6. 클로드 코드가 그 기록을 읽고 내 답대로 이어서 작업해요

API가 뭐예요? 프로그램끼리 말을 주고받는 창구예요. 사람이 웹사이트에서 버튼을 누르는 대신, 프로그램이 정해진 형식으로 요청을 보내는 거예요.

1단계: Bland 가입하고 API 키 받기

1. app.bland.ai에서 가입해요
2. 대시보드에서 API 키를 찾아 복사해 둬요

Start 요금제는 카드 없이 가입되고, 가입하면 무료 크레딧 2와 수신용 번호(월 $15 상당)를 줘요.

사진: Bland 공식 가격표. Start는 분당 $0.14, 플랫폼 이용료 $0, 카드 없이 시작

API 키가 뭐예요? 내 Bland 계정을 쓸 수 있는 비밀번호 같은 거예요. 이 키만 있으면 누구든 내 돈으로 전화를 걸 수 있어요. 남한테 보여 주거나, 화면 녹화·캡처에 나오게 하면 안 돼요.

2단계: 한국 번호로 걸려면 $5 충전

Bland 공식 문서에 이렇게 나와요. 국제 전화는 결제를 한 번 해야 걸 수 있어요. 대시보드의 Billing에서 $5 이상 크레딧을 사거나, 자동 충전을 켜면 돼요.

사진: Bland 공식 문서의 국제 전화 조건 (형광펜 부분)

• Bland는 미국 회사라서 한국 휴대폰은 국제 전화예요. 무료 크레딧만으로는 한국 번호에 못 걸어요.
• 'Agent Phone Plan' 번호는 잔액과 상관없이 미국·캐나다로만 걸려요. 한국으로 걸 때는 이 번호를 쓰지 마세요.

3단계: 키를 '환경변수'에 넣기

키를 클로드 코드 대화창에 그대로 붙여넣으면 대화 기록에 남아요. 그래서 컴퓨터의 '환경변수'라는 곳에 넣어 두고, 클로드 코드한테는 이름만 알려 줘요.

환경변수가 뭐예요? 컴퓨터가 기억하는 '이름표 붙은 메모'예요. BLAND_API_KEY라는 이름표에 키를 적어 두면, 프로그램은 이름표만 보고 키를 꺼내 써요.

윈도우 (PowerShell에 한 줄, 따옴표 안에 내 키):

setx BLAND_API_KEY "여기에_내_키"

입력한 뒤 터미널과 클로드 코드를 껐다 켜야 적용돼요.

맥 (터미널에 한 줄):

echo 'export BLAND_API_KEY="여기에_내_키"' >> ~/.zshrc

그다음 터미널을 새로 열면 돼요.

잘 들어갔는지 확인 (키 전체가 화면에 나오지 않게 앞 4글자만):

환경변수 BLAND_API_KEY가 설정돼 있는지 확인해 줘. 키 값은 화면에 보여 주지 말고, 있는지 없는지와 앞 4글자만 알려 줘.

4단계: 클로드 코드에 붙여넣는 문장

영상에서 말한 시키는 말 한 줄이에요. [번호]만 내 번호로 바꾸세요.

나한테 전화할 수 있게 설정하자. 내 번호는 [번호], Bland 키는 환경변수 BLAND_API_KEY에 있어. 먼저 나한테 테스트 전화하고, 그다음 '전화해'라고 하면 전화하는 스킬을 만들어.

한국어로 통화하고, 통화 내용까지 받아 오게 하려면 이 자세한 버전을 쓰세요.

Bland API(https://docs.bland.ai)로 나한테 전화를 거는 기능을 만들자.

- 내 번호: [+8210XXXXXXXX] (국제 형식, 010의 맨 앞 0을 빼고 +82를 붙인 것)
- 키: 환경변수 BLAND_API_KEY. 키 값은 코드나 화면, 파일에 절대 적지 마.
- 통화는 한국어로 (language: "ko"), 한 통화는 최대 3분 (max_duration: 3).
- 전화 내용(task)에는 "너는 클로드 코드의 비서야. 지금 작업 중에 생긴 질문을 짧게 묻고, 사용자의 답을 끝까지 들은 다음 고맙다고 하고 끊어."라는 역할과 이번 질문을 넣어.
- 전화를 건 뒤에는 call_id로 통화 상태를 확인하고, 통화가 끝나면 받아쓴 대화(concatenated_transcript)와 요약(summary)을 가져와서 나한테 보여 줘.

먼저 "테스트 전화예요. 잘 들리면 '잘 들려'라고 말해 주세요."라는 질문으로 테스트 전화를 한 번 걸어 줘. 결과를 확인한 다음, 앞으로 내가 '전화해'라고 하면 이 기능을 쓰는 스킬을 만들어 줘.

010-1234-5678이라면 국제 형식은 +821012345678이에요. 맨 앞 0을 빼고 +82를 붙여요.

5단계: 테스트 전화 확인하기

테스트 전화가 오면 이것만 확인하세요.

• 전화가 실제로 왔나요? (안 오면 아래 '안 될 때' 참고)
• AI 목소리가 한국어로 자연스럽게 말하나요?
• 내가 한 대답이 통화 기록에 제대로 받아써졌나요?
• 통화가 끝나고 클로드 코드가 그 기록을 가져왔나요?

사진: Bland 공식 문서. 통화 하나의 정보·기록·받아쓴 대화를 가져오는 기능

한국어 통화 품질은 쓰는 목소리와 상황에 따라 달라요. 처음엔 짧은 질문으로 시험하고, 어색하면 "더 천천히, 짧은 문장으로 말해"를 task에 더해 보세요.

6단계: '전화해' 스킬 쓰기

테스트가 끝나면 클로드 코드가 스킬을 만들어 둬요. 이제 일을 시킬 때 이렇게 말하면 돼요.

이 사이트 첫 화면 만들어 줘. 색이나 문구처럼 내가 정해야 하는 게 생기면 혼자 정하지 말고 나한테 전화해서 물어봐. 통화에서 내가 답한 대로 이어서 만들어.

지금 하는 작업 끝나면 나한테 전화해서 뭘 했는지 30초 안으로 알려 줘.

스킬이 뭐예요? 클로드 코드한테 특기 하나를 가르쳐 두는 파일이에요(SKILL.md가 든 폴더). 한 번 만들어 두면 '전화해'라는 말만으로 꺼내 써요.

스킬이 제대로 만들어졌는지 확인:

방금 만든 전화 스킬이 어디에 저장됐는지, 어떤 말을 하면 쓰이는지, 키를 어디서 읽는지 알려 줘. 키 값은 보여 주지 마.

요금 정리

• 혼자 쓰는 용도면 Start로 충분해요.
• 한 번 통화를 1~2분으로 짧게 하면 부담이 적어요. 그래서 위 문장에 '최대 3분'을 넣었어요.
• 한국 번호로 걸려면 위에서 말한 $5 충전이 먼저예요.

꼭 지킬 것

• 키는 환경변수에만. 대화창, 코드 파일, 깃허브, 캡처 어디에도 키를 적지 마세요. 혹시 노출됐다면 Bland 대시보드에서 키를 새로 만들고 예전 키는 지우세요.
• 내 번호로만 쓰세요. AI가 다른 사람한테 전화를 걸게 하려면 그 사람의 동의가 필요하고, 나라마다 자동 전화 규칙이 있어요.
• 통화 시간 상한을 꼭 넣으세요 (max_duration). 대화가 꼬여서 길어지는 걸 막아 줘요.
• 녹음까지 남기고 싶으면 record: true를 넣으면 돼요. 통화가 끝나면 녹음 파일 주소가 같이 와요.
• 전화를 못 받으면 음성사서함으로 가요. 기본값은 그냥 끊기예요.

안 될 때

막히면 에러를 그대로 붙여넣고 이렇게 말하세요.

Bland 전화 기능에서 아래 에러가 났어. Bland 공식 문서(https://docs.bland.ai)를 확인해서 원인을 찾고 고쳐 줘. 키 값은 화면에 보여 주지 마.

[에러 붙여넣기]

용어 정리

꼭 기억할 것

전화는 물어봐야 할 때만 오게 하는 게 핵심이에요. 사소한 것까지 전화하게 하면 비용도 늘고 귀찮아져요. "색·문구·결제처럼 내가 정해야 하는 것만 전화해"라고 기준을 같이 주세요.

출처

• Bland 가격 페이지, 전화 걸기, 통화 정보 가져오기 (2026-10-25 확인)
• anthropics/skills (클로드 코드 스킬)