mozex/anthropic-laravel

Anthropic API를 위한 커뮤니티 유지 관리 PHP SDK인 Anthropic PHP를 위한 Laravel 래퍼 (wrapper)입니다. Facade (파사드), 게시 가능한 설정 (config), 설치 명령어, 그리고 서비스 컨테이너 (service container)에 연결되는 테스트 통합 기능을 추가합니다.

전체 문서는 mozex.dev에서 확인하세요: 검색 가능한 문서, 버전 요구 사항, 상세 변경 이력 (changelog) 등을 제공합니다.

Laravel을 사용하지 않으시나요? 프레임워크에 구애받지 않는 (framework-agnostic) Anthropic PHP 패키지를 직접 사용하세요.

• 소개 (Introduction)
• 사용법 (Usage)
• 참조 (Reference)

저는 매일 수천 명의 개발자가 사용하는 여러 오픈 소스 PHP 패키지와 함께 이 패키지를 유지 관리하고 있습니다.

제 패키지가 시간을 절약해 주거나 비즈니스에 도움이 된다면, GitHub Sponsors를 통해 제 작업에 후원하는 것을 고려해 주세요. 여러분의 지원은 제가 패키지를 최신 상태로 유지하고, 이슈에 빠르게 대응하며, 새로운 기능을 출시할 수 있게 해줍니다.

비즈니스 후원자는 패키지 README에 로고를 배치할 수 있습니다. 후원 등급 보기 →

Anthropic::

모든 것을 위한 Facade (파사드)입니다. Anthropic::messages(), Anthropic::models(), Anthropic::batches(), Anthropic::files(), Anthropic::completions()를 사용하세요. 클라이언트 인스턴스화 (instantiation)나 팩토리 설정 (factory setup)이 필요 없습니다. 서비스 프로바이더 (service provider)가 이를 처리합니다.

테스트 시 Anthropic::fake()를 사용하세요. 실제 클라이언트를 가짜(fake)로 교체하고, 응답을 큐 (queue)에 쌓고, 정확히 어떤 요청이 전송되었는지 단언 (assert)할 수 있습니다. 이는 Event::fake() 및 Queue::fake()와 같은 Laravel의 기존 테스트 관용구 (idioms)와 함께 사용할 수 있습니다. 테스트 문서 보기 →

use Anthropic\
Laravel\Facades\Anthropic;
use Anthropic\Resources\Messages;
use Anthropic\Responses\Messages\CreateResponse;
...

한 번의 artisan 명령어로 설정 완료. php artisan anthropic:install을 실행하면 설정 파일이 게시되고 .env 파일에 ANTHROPIC_API_KEY=가 추가됩니다. 바로 시작할 준비가 됩니다.

하위 호환성 유지 (Forward-compatible). 매개변수 (parameters)가 API로 그대로 전달됩니다. Anthropic이 새로운 기능을 출시하면, 패키지 업데이트를 기다릴 필요 없이 당일에 바로 코드에서 작동합니다.

Full Anthropic API coverage (전체 Anthropic API 지원). Messages (메시지), streaming (스트리밍), tool use (도구 사용), extended thinking (확장된 사고), web search (웹 검색), code execution (코드 실행), citations (인용), token counting (토큰 계산), 그리고 batch processing (배치 처리)을 지원합니다. API가 지원하는 모든 기능은 Facade를 통해 사용할 수 있습니다.

PHP 8.2 이상이 필요합니다 - 모든 버전 요구 사항 확인

composer require mozex/anthropic-laravel

설치 명령어를 실행하세요:

php artisan anthropic:install

이 명령은 config/anthropic.php를 게시하고

.env 파일에

ANTHROPIC_API_KEY=를 추가합니다.

Anthropic Console에서 키를 설정하세요:

ANTHROPIC_API_KEY=sk-ant-...

앱 어디에서나 Anthropic Facade를 사용하세요:

use Anthropic\/Laravel\/Facades\/Anthropic;
$response = Anthropic::messages()->create([
'model' => 'claude-sonnet-4-6',
...

텍스트가 도착하는 대로 출력하세요:

$stream = Anthropic::messages()->createStreamed([
'model' => 'claude-sonnet-4-6',
'max_tokens' => 1024,
...

Claude에게 호출할 도구를 제공하고, 코드에서 실행한 뒤, 결과를 다시 전송하세요:

$response = Anthropic::messages()->create([
'model' => 'claude-sonnet-4-6',
'max_tokens' => 1024,
...

Claude가 답변하기 전에 복잡한 문제를 추론하도록 하세요:

$response = Anthropic::messages()->create([
'model' => 'claude-opus-4-6',
'max_tokens' => 16000,
...

전체 문서는 모든 기능을 다룹니다: vision (시각) 및 이미지, 웹 검색 및 코드 실행, 문서 인용, 배치 처리, 에러 핸들링 (error handling), 테스트, 그리고 더 많은 기능들을 포함합니다.

이 저장소에서 자동으로 업데이트되는 검색 가능한 문서를 보려면 문서 사이트를 방문하세요.

AI Integration (AI 통합): Context7 및 Laravel Boost를 통해 AI 코딩 어시스턴트와 이 패키지를 함께 사용하세요
Requirements (요구 사항): PHP, Laravel 및 종속성 버전
Changelog (변경 이력): 연결된 pull request 및 diff가 포함된 릴리스 기록
Contributing (기여하기): 개발 환경 설정, 코드 품질 및 PR 가이드라인
Questions & Issues (질문 및 이슈): 버그 보고, 기능 요청 및 도움말
Security (보안): 이메일을 통해 취약점을 직접 보고하세요

MIT License (MIT). 자세한 내용은 License 파일을 참조하세요.