--- title: RunAPI를 통해 WorkBuddy에서 Claude 사용하기 — MCP 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 Anthropic Claude를 공식 가격 대비 50% 할인으로 호출하세요. Opus 4.8, Sonnet 4.6, Haiku 4.5 — 키 하나, MCP 설정 하나. url: https://runapi.ai/ko/workbuddy-claude.md canonical: https://runapi.ai/ko/workbuddy-claude locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-claude zh-CN: https://runapi.ai/zh-CN/workbuddy-claude es: https://runapi.ai/es/workbuddy-claude ja: https://runapi.ai/ja/workbuddy-claude de: https://runapi.ai/de/workbuddy-claude fr: https://runapi.ai/fr/workbuddy-claude pt-BR: https://runapi.ai/pt-BR/workbuddy-claude ko: https://runapi.ai/ko/workbuddy-claude it: https://runapi.ai/it/workbuddy-claude nl: https://runapi.ai/nl/workbuddy-claude pl: https://runapi.ai/pl/workbuddy-claude tr: https://runapi.ai/tr/workbuddy-claude zh-TW: https://runapi.ai/zh-TW/workbuddy-claude zh-HK: https://runapi.ai/zh-HK/workbuddy-claude ar: https://runapi.ai/ar/workbuddy-claude x-default: https://runapi.ai/workbuddy-claude model: claude --- > HTML version: https://runapi.ai/ko/workbuddy-claude > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Claude를 사용하세요. Anthropic Claude는 최대 성능을 위한 Opus 4.8(200K 컨텍스트, 확장 사고), 균형 잡힌 성능의 Sonnet 4.6, 빠른 처리를 위한 Haiku 4.5를 제공합니다. WorkBuddy는 MCP를 기본 지원합니다 — RunAPI를 MCP 서버로 한 번 등록하면 모든 Claude 변형이 워크벤치 내 호출 가능한 도구가 되며, Anthropic 공식 요금의 50%로 토큰당 청구됩니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) RunAPI 키 하나 · MCP 원클릭 연결 · 50% 할인 토큰 기반 청구 ### 프롬프트 ```text Use the runapi MCP server to send a chat request to Claude. Requirements: - Call the RunAPI chat tool exposed by the runapi MCP server - Set model to "claude-opus-4.8" - Ask: "Explain the difference between a mutex and a semaphore in three sentences." - Set max_tokens to 1024 - Show me the assistant reply and the token usage counts ``` ### MCP 설정 ```bash { "mcpServers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 응답 ```json { "model": "claude-opus-4.8", "content": "A mutex is a locking mechanism that allows only one thread to access a resource at a time...", "finish_reason": "stop", "usage": { "prompt_tokens": 24, "completion_tokens": 87, "total_tokens": 111 } } ``` ## WorkBuddy에서 Claude를 3단계로 사용하기 1. **RunAPI MCP 서버 등록** - WorkBuddy를 실행하는 환경에 RUNAPI_API_KEY를 설정한 후, streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키는 runapi라는 MCP 서버를 추가하세요. 다른 모델에 RunAPI가 이미 연결되어 있다면 동일한 서버가 Claude도 지원하므로 추가 설치가 필요 없습니다. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **워크벤치 에이전트에 프롬프트 입력** - WorkBuddy에 자연어 요청을 입력하고 모델명을 명시하세요. WorkBuddy가 runapi MCP 서버에서 RunAPI chat 도구를 선택하고, model claude-opus-4.8, 메시지, max_tokens를 채워 호출합니다 — curl이나 SDK 코드가 필요 없습니다. `Ask claude-opus-4.8 via the runapi MCP server: ...` 3. **도구 결과 확인하기** - MCP 도구는 어시스턴트 메시지를 동기적으로 반환하므로 작업 폴링이 필요 없습니다. WorkBuddy가 응답을 인라인으로 렌더링하며, 결과에는 각 요청의 비용을 확인할 수 있도록 토큰 사용량이 포함됩니다. `usage.total_tokens: 111` ## RunAPI MCP 서버의 Claude 도구 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. claude-opus-4.8, claude-sonnet-4.6, claude-haiku-4.5, 또는 RunAPI 카탈로그에 나열된 모든 Claude 변형. | | `messages` | `array` | 필수 항목. role(system, user, assistant)과 content 필드를 가진 메시지 객체 배열입니다. WorkBuddy가 프롬프트를 기반으로 이를 구성합니다. | | `max_tokens` | `integer` | 응답의 최대 토큰 수. 기본값은 모델마다 다릅니다 — 예측 가능한 요금 청구를 위해 명시적으로 설정하세요. | | `temperature` | `float` | 0~1 사이의 샘플링 온도. 낮은 값일수록 더 결정론적인 출력을 생성합니다. | | `top_p` | `float` | 핵 샘플링 임계값. temperature의 대안 — 둘 중 하나만 사용하세요. | | `stream` | `boolean` | true로 설정하면 응답이 점진적으로 스트리밍됩니다. WorkBuddy의 MCP 도구 호출에서는 기본 동기 결과만으로도 충분한 경우가 대부분입니다. | ## WorkBuddy에서 Claude란 무엇인가요? Claude는 Anthropic의 LLM 제품군입니다 — 심층 분석을 위한 200K 컨텍스트와 확장 사고 기능의 Opus 4.8, 일상적인 코딩 및 작성을 위한 Sonnet 4.6, 빠른 저비용 작업을 위한 Haiku 4.5. WorkBuddy는 단일 runapi MCP 서버를 통해 세 가지 모두에 접근하며, Anthropic 공식 토큰 요금의 50%로 청구됩니다. GPT, Gemini, 이미지·영상·음악 모델과 동일한 RUNAPI_API_KEY를 사용하며, 반복 컨텍스트의 비용 절감을 위한 프롬프트 캐싱도 지원됩니다. ## Claude 활용 사례 - **문서에 대한 구조화된 추론** - WorkBuddy에게 계약서, 보고서, 대용량 테이블 분석을 요청하고 구조화된 추론은 Claude에 맡기세요 — MCP 도구가 깔끔하게 정리된 답변을 워크벤치로 바로 반환합니다. - **200K 컨텍스트로 긴 문서 분석** - 전체 코드베이스, 법률 계약서 또는 연구 논문을 Claude Opus 4.8의 200K 토큰 컨텍스트 창에 입력하여 청킹 없이 분석, 요약 및 질의응답을 수행하세요. - **워크벤치 내 코딩 및 코드 리뷰** - WorkBuddy에서 Claude를 통해 코드 생성, 풀 리퀘스트 리뷰, 다중 파일 리팩터링을 처리하세요 — 아키텍처 결정에는 Opus 4.8, 일상적인 변경에는 Sonnet 4.6. ## Claude + WorkBuddy 자주 묻는 질문 ### RunAPI를 통해 WorkBuddy에서 Claude를 호출할 수 있나요? 네. WorkBuddy는 MCP를 기본 지원합니다. RUNAPI_API_KEY와 함께 https://runapi.ai/mcp를 가리키는 MCP 서버로 RunAPI를 등록하면 Claude가 호출 가능한 chat 도구로 나타납니다. 동일한 서버가 채팅, 이미지, 영상, 음악 모델도 지원합니다. ### RunAPI를 통한 Claude 이용 요금은 얼마인가요? RunAPI는 Anthropic 공식 요금의 50%를 청구합니다. Opus 4.8은 RunAPI를 통해 입력/출력 토큰 백만 개당 $7.50/$37.50이며, 직접 사용 시 $15/$75입니다. 프롬프트 캐싱을 활성화하면 캐시된 입력 토큰 비용이 더 낮아집니다. 정확한 요금은 RunAPI 가격 페이지를 확인하세요. ### WorkBuddy에서 Claude를 사용하려면 코드를 작성해야 하나요? 아니요. MCP 서버를 등록한 후에는 워크벤치에 프롬프트를 입력하면 됩니다. WorkBuddy가 RunAPI chat 도구를 선택하고, model과 messages를 채워 응답을 인라인으로 표시합니다 — curl 명령이나 SDK 설정이 필요 없습니다. ### WorkBuddy에서 Claude 모델을 어떻게 전환하나요? 프롬프트에 사용할 변형을 명시하세요 — claude-opus-4.8, claude-sonnet-4.6, 또는 claude-haiku-4.5. MCP 서버, 설정, API 키는 동일하게 유지되며 도구 호출의 model 인수만 바뀝니다. ### WorkBuddy에서 작업에 맞는 Claude 모델을 어떻게 선택하나요? 복잡한 다중 파일 리팩터링, 심층 분석, 아키텍처 결정에는 Opus 4.8. 일상적인 코딩 및 작성 — 리뷰, 테스트 생성, 초안 작성에는 Sonnet 4.6. 깊이보다 지연 시간이 중요한 빠른 대량 작업에는 Haiku 4.5. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [Claude 모델 →](https://runapi.ai/ko/models/claude.md) - 모든 Claude 변형, 토큰당 가격 및 컨텍스트 창 세부 정보를 확인하세요. ## 지금 바로 WorkBuddy에서 Claude를 사용해 보세요. 무료 RunAPI 키를 발급받고, MCP 서버를 등록한 후, 워크벤치를 벗어나지 않고 Anthropic 공식 요금의 50%로 Claude를 사용해 보세요. [모델 보기 →](https://runapi.ai/ko/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [x402](https://runapi.ai/ko/x402.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "SoftwareApplication", "name": "WorkBuddy용 RunAPI Claude", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 Anthropic Claude를 공식 가격 대비 50% 할인으로 호출하세요. Opus 4.8, Sonnet 4.6, Haiku 4.5 — 키 하나, MCP 설정 하나.", "url": "https://runapi.ai/ko/workbuddy-claude" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "RunAPI를 통해 WorkBuddy에서 Claude를 호출할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. WorkBuddy는 MCP를 기본 지원합니다. RUNAPI_API_KEY와 함께 https://runapi.ai/mcp를 가리키는 MCP 서버로 RunAPI를 등록하면 Claude가 호출 가능한 chat 도구로 나타납니다. 동일한 서버가 채팅, 이미지, 영상, 음악 모델도 지원합니다." } }, { "@type": "Question", "name": "RunAPI를 통한 Claude 이용 요금은 얼마인가요?", "acceptedAnswer": { "@type": "Answer", "text": "RunAPI는 Anthropic 공식 요금의 50%를 청구합니다. Opus 4.8은 RunAPI를 통해 입력/출력 토큰 백만 개당 $7.50/$37.50이며, 직접 사용 시 $15/$75입니다. 프롬프트 캐싱을 활성화하면 캐시된 입력 토큰 비용이 더 낮아집니다. 정확한 요금은 RunAPI 가격 페이지를 확인하세요." } }, { "@type": "Question", "name": "WorkBuddy에서 Claude를 사용하려면 코드를 작성해야 하나요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. MCP 서버를 등록한 후에는 워크벤치에 프롬프트를 입력하면 됩니다. WorkBuddy가 RunAPI chat 도구를 선택하고, model과 messages를 채워 응답을 인라인으로 표시합니다 — curl 명령이나 SDK 설정이 필요 없습니다." } }, { "@type": "Question", "name": "WorkBuddy에서 Claude 모델을 어떻게 전환하나요?", "acceptedAnswer": { "@type": "Answer", "text": "프롬프트에 사용할 변형을 명시하세요 — claude-opus-4.8, claude-sonnet-4.6, 또는 claude-haiku-4.5. MCP 서버, 설정, API 키는 동일하게 유지되며 도구 호출의 model 인수만 바뀝니다." } }, { "@type": "Question", "name": "WorkBuddy에서 작업에 맞는 Claude 모델을 어떻게 선택하나요?", "acceptedAnswer": { "@type": "Answer", "text": "복잡한 다중 파일 리팩터링, 심층 분석, 아키텍처 결정에는 Opus 4.8. 일상적인 코딩 및 작성 — 리뷰, 테스트 생성, 초안 작성에는 Sonnet 4.6. 깊이보다 지연 시간이 중요한 빠른 대량 작업에는 Haiku 4.5." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Claude를 사용하는 방법", "description": "RunAPI를 WorkBuddy의 MCP 서버로 등록하고, 워크벤치 에이전트에게 Claude chat 도구를 호출하도록 프롬프트를 입력한 후, 반환된 어시스턴트 메시지를 확인하세요.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 등록", "text": "WorkBuddy를 실행하는 환경에 RUNAPI_API_KEY를 설정한 후, streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키는 runapi라는 MCP 서버를 추가하세요. 다른 모델에 RunAPI가 이미 연결되어 있다면 동일한 서버가 Claude도 지원하므로 추가 설치가 필요 없습니다.", "url": "https://runapi.ai/ko/workbuddy-claude#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "WorkBuddy에 자연어 요청을 입력하고 모델명을 명시하세요. WorkBuddy가 runapi MCP 서버에서 RunAPI chat 도구를 선택하고, model claude-opus-4.8, 메시지, max_tokens를 채워 호출합니다 — curl이나 SDK 코드가 필요 없습니다.", "url": "https://runapi.ai/ko/workbuddy-claude#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "도구 결과 확인하기", "text": "MCP 도구는 어시스턴트 메시지를 동기적으로 반환하므로 작업 폴링이 필요 없습니다. WorkBuddy가 응답을 인라인으로 렌더링하며, 결과에는 각 요청의 비용을 확인할 수 있도록 토큰 사용량이 포함됩니다.", "url": "https://runapi.ai/ko/workbuddy-claude#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "WorkBuddy용 RunAPI Claude", "item": "https://runapi.ai/ko/workbuddy-claude" } ] } ] ```