MedgeClaw API 연동 가이드: 5분 만에 바이오 의약 AI 연구 어시스턴트 설정하기

March 15, 2026

WARNING

이 가이드는 Node.js 22 이상 및 Docker 환경이 필요합니다.

서버에 대화하듯 명령을 내리면 유전자 데이터를 분석하고, 약물을 선별하며, 과학 연구 도표를 생성해 준다고 상상해 보세요. 이것이 바로 MedgeClaw입니다. OpenClaw와 Claude Code를 기반으로 구축된 바이오 의약 전용 AI 연구 어시스턴트로, 140가지 전문 과학 기술이 통합되어 있습니다.

대상 독자

  • 생명과학 분야의 연구원
  • 데이터 분석 자동화가 필요한 생물정보학(Bioinformatics) 엔지니어
  • AI를 활용해 연구를 보조하고자 하는 대학(원)생

소개

MedgeClaw의 핵심은 대화형 AI 에이전트이며, 내부적으로는 Claude Code를 통해 분석 작업을 수행합니다. WhatsApp, Slack, Discord 또는 Feishu(Lark)를 통해 명령을 보낼 수 있으며, 다음과 같은 작업을 자동으로 처리합니다:

  • 로컬 파일 읽기 및 쓰기
  • Python/R 코드 실행
  • Docker 컨테이너 조작
  • 시각화 차트 생성
  • 과학 연구 보고서 작성

중요한 점은 MedgeClaw가 작동하려면 모델 제공자(Model Provider) 설정이 필요하다는 것입니다. 기본적으로 Anthropic 공식 API를 사용하지만 가격이 높을 수 있습니다. 이 글에서는 다양한 연동 방안을 소개하며, 그중 Defapi는 공식 가격의 절반 수준으로 서비스를 제공합니다.

방법 1: Defapi (권장 - 반값 요금제)

Defapi는 OpenAI 형식을 호환하는 모델 애그리게이터 플랫폼으로, Claude 시리즈 모델을 공식 가격의 50% 수준으로 제공합니다.

왜 Defapi를 선택해야 하나요?

  • 공식 가격의 **50%**에 불과한 비용
  • Claude Code의 v1/chat/completions 인터페이스와 완벽하게 호환
  • 국내(중국 포함)에서 프록시 없이 직접 접속 가능

설정 단계

1단계: API Key 획득

https://defapi.org 에 접속하여 계정을 등록하고 API Key를 받습니다.

2단계: 설정 수정

프로젝트 루트 디렉토리의 .env 파일을 편집합니다:

# Defapi 설정
ANTHROPIC_API_KEY=dk-xxxxxxxxxxxxxxxx
ANTHROPIC_BASE_URL=https://api.defapi.org
MODEL=anthropic/claude-sonnet-4.5

# 중요: Claude Code 프리플라이트(사전 점검)를 위해 설정 필요
ANTHROPIC_SMALL_FAST_MODEL=anthropic/claude-sonnet-4.5

3단계: 설치 스크립트 실행

bash setup.sh

이 작업은 다음을 자동으로 수행합니다:

  • ~/.claude/settings.json 설정
  • Docker 분석 환경 구축 (R + Python + RStudio + JupyterLab)
  • MedgeClaw 기술을 OpenClaw로 동기화

4단계: 서비스 시작

# 분석 환경 실행
docker compose up -d

# OpenClaw 시작
openclaw onboard

방법 2: Anthropic 공식 API

최고의 안정성을 원한다면 공식 인터페이스를 직접 사용할 수 있습니다.

# 공식 Anthropic API
ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxx
ANTHROPIC_BASE_URL=https://api.anthropic.com
MODEL=claude-sonnet-4-6
# SMALL_FAST_MODEL 설정은 불필요

방법 3: OpenRouter

OpenRouter는 전 세계 200개 이상의 모델을 통합 제공합니다.

ANTHROPIC_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxx
ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
MODEL=anthropic/claude-3.5-sonnet
ANTHROPIC_SMALL_FAST_MODEL=anthropic/claude-3.5-haiku

방법 4: MiniMax (중국 내 사용 가능)

중국 내에 거주 중이라면 MiniMax가 좋은 대안이 될 수 있습니다.

ANTHROPIC_API_KEY=your_minimax_key
ANTHROPIC_BASE_URL=https://api.minimax.chat/anthropic
MODEL=minimax-2.1
ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514

방법 5: Ollama (로컬 배포)

완전한 오프라인 환경이 필요하다면 Ollama를 사용할 수 있습니다.

# Ollama 설치
curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5:14b

# 설정
ANTHROPIC_API_KEY=ollama
ANTHROPIC_BASE_URL=http://localhost:11434/v1
MODEL=qwen2.5:14b

정상 작동 여부 검증

설정이 완료되면 다음 명령어를 실행하여 확인합니다:

# 30초 내에 완료되고 "hello"가 반환되어야 합니다.
claude --dangerously-skip-permissions -p 'run: echo hello'

만약 명령어가 멈춘다면 ANTHROPIC_SMALL_FAST_MODEL 설정이 잘못된 것입니다. Claude Code의 사전 점검 모델이 현재 사용 중인 API에서 지원되지 않는 경우입니다.

내부 메커니즘: 왜 사전 점검 모델이 필요한가요?

흥미로운 설계 방식입니다. Claude Code는 bash 명령을 실행하기 전, 매번 경량 모델(기본값 Haiku)을 사용하여 보안 검사를 수행하고 잠재적인 악성 작업을 식별합니다.

# 의사 코드: 사전 점검 로직
async def preflight_check(command: str) -> bool:
    # 경량 모델을 사용하여 명령의 의도 분석
    model = os.environ.get("ANTHROPIC_SMALL_FAST_MODEL", "claude-3-5-haiku")
    result = await call_api(model, f"Is this command safe? {command}")
    return result.safety_score > 0.8

이로 인해 발생하는 문제가 있습니다. 대부분의 서드파티 API는 Haiku를 지원하지 않습니다. Haiku는 Anthropic 전용 모델이기 때문입니다. 대리(Proxy) 서버를 사용할 때 반드시 ANTHROPIC_SMALL_FAST_MODEL을 별도로 설정해야 하는 이유가 바로 이것입니다.

5가지 주요 활용 사례

1. RNA-seq 차별 발현 분석

Analyze RNA-seq data at data/counts.csv vs data/meta.csv, treatment vs control

MedgeClaw가 자동으로 다음을 수행합니다:

  • 카운트 행렬(Count Matrix) 로드
  • DESeq2/edgeR 차별 발현 분석 실행
  • 화산도(Volcano Plot), 열지도(Heatmap) 생성
  • 유의미한 차이가 있는 유전자 목록 출력

2. 임상 생존 분석

Run survival analysis on data/clinical.csv, time=OS_months, event=OS_status

Kaplan-Meier 곡선 및 Cox 비례 위험 모델을 자동으로 실행합니다.

3. 단일 세포 RNA-seq 클러스터링

Perform single-cell RNA-seq analysis on the 10X data in data/10x/

Scanpy를 사용하여 차원 축소, 클러스터링 및 Marker 식별을 수행합니다.

4. 가상 약물 스크리닝

Virtual screen EGFR inhibitors from ChEMBL (IC50 < 50nM), generate SAR report

ChEMBL 데이터베이스에서 화합물을 선별하고 구조-활성 관계(SAR) 보고서를 생성합니다.

5. 문헌 검토 및 요약

Search PubMed for recent papers on CRISPR base editing, summarize top 10

PubMed에서 관련 논문을 자동으로 검색하고 요약 및 분석을 생성합니다.

Updated March 15, 2026