🎙️ 시리로 Claude 음성 비서 만들기

아이폰 단축어 앱과 Claude API를 연동해서 "헤이 시리" 한 마디로 Claude와 음성 대화하는 방법을 정리했습니다.

---

📋 준비물

• iPhone (iOS 16 이상)
• Claude 앱 설치
• Anthropic API 키 (console.anthropic.com 에서 발급)
• API 크레딧 (최소 $5 충전 권장)

---

🔑 1단계 — API 키 발급

1. console.anthropic.com 접속
2. 구글 계정으로 회원가입 또는 로그인
3. 좌측 메뉴 API Keys 클릭
4. Create Key 버튼으로 새 키 생성
5. 생성된 키 복사해서 안전한 곳에 저장 (다시 볼 수 없음)
6. Plans & Billing에서 크레딧 충전 (최소 $5)

⚠️ API 키는 절대 외부에 공유하지 마세요. 채팅창에 붙여넣지 마세요.

---

⚙️ 2단계 — 단축어 앱 설정

새 단축어 만들기

1. 단축어 앱 열기
2. 우상단 + 버튼으로 새 단축어 생성

액션 1 — 텍스트 받아쓰기

• 동작 검색에서 "텍스트 받아쓰기" 추가
• 언어: 한국어(대한민국)
• 듣기 중단: 정지 후

액션 2 — URL 콘텐츠 가져오기

• 동작 검색에서 "URL 콘텐츠 가져오기" 추가
• URL: https://api.anthropic.com/v1/messages
• 메소드: POST

헤더 3개 추가:

키 값

x-api-key	발급받은 API 키
anthropic-version	2023-06-01
content-type	application/json

본문 요청 — JSON 필드 추가:

키 값 타입

model	claude-sonnet-4-5-20250929	텍스트
max_tokens	1024	숫자
system	당신은 음성 비서입니다. 짧고 자연스럽게 한국어 구어체로 대답하세요. 마크다운 기호나 특수문자 없이 말하듯이 답변하세요.	텍스트
messages	배열 → 딕셔너리 → role: user / content: 받아쓰기한 텍스트	배열

⚠️ max_tokens는 반드시 숫자 타입으로 설정해야 합니다. 텍스트로 입력하면 오류 발생.

액션 3 — 딕셔너리 값 가져오기 (2번 중첩)

• 첫 번째: URL 콘텐츠에서 content 키 가져오기
• 두 번째: 위 결과에서 text 키 가져오기

액션 4 — 텍스트 말하기

• 앞 단계 결과(사전 값)를 말하기로 연결

---

🍎 3단계 — 더 간단한 방법 (Claude 앱 공식 연동)

iPhone에 Claude 앱이 설치되어 있다면 훨씬 간단하게 설정 가능합니다.

1. 단축어 앱에서 + 버튼으로 새 단축어 생성
2. 동작 검색에서 "Claude" 검색
3. "음성 대화 시작" 선택
4. 단축어 이름 저장 (예: AI 또는 어시스턴트)

이렇게 하면 "헤이 시리, AI" 한 마디로 Claude와 바로 음성 대화가 시작됩니다.

---

🛠️ 트러블슈팅

오류 메시지 원인 해결 방법

credit balance is too low	크레딧 부족	console.anthropic.com에서 충전
max_tokens: Input should be a valid integer	숫자 타입 오류	max_tokens를 숫자 타입으로 변경
model: not found	모델명 오류	claude-sonnet-4-5-20250929 정확히 입력
듣기만 하고 응답 없음	변수 연결 오류	messages의 content에 받아쓰기한 텍스트 변수 연결 확인

---

✅ 완성 후 사용법

• "헤이 시리, [단축어 이름] 실행해줘" → 음성 질문 → Claude 답변
• 홈 화면에 아이콘 추가해서 탭으로도 실행 가능
• 설정 → 손쉬운 사용 → 뒤로 탭에 연결하면 폰 뒷면 두드려서 실행 가능

---

작성일: 2026년 5월 | 참고: Anthropic API Docs

 

단축어 링크 필요하신분 참고하세요~! ---- ios에서만 작동됩니다.

https://www.icloud.com/shortcuts/57345763121c46659afcea4cdd43cf46