NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #3236 most downloaded on Packagist
The Claude companion for Laravel: the Anthropic API behind a facade, with batches, token counting, files, refusal fallback, named connections, events and test fakes, beside laravel/ai.
Latest stable
1.15.0
Last release 16 days ago
06 Nov 2026
Release timing varies
gaps range from 2 weeks to 12 months
Nearly every release is documented
notes for 22 of 22 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
22 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
Requires mozex/anthropic-php 1.15, with its stream helpers and the streamed refusal fallback.
mozex/anthropic-php 1.15, with its stream helpers and the streamed refusal fallback.Anthropic::messages()->createStreamed() can be returned from a route: toEventStream() for Laravel's useEventStream, toTextStream() for useStream, and toVercelStream() for the AI SDK's useChat.broadcastTo() sends a stream over Reverb or Pusher from a queued job, its text coalesced into claude.delta events that stay under the broadcaster's size limit.InteractsWithClaudeStreams trait streams a reply into a Livewire component with streamClaude($stream, to: 'answer').ANTHROPIC_FALLBACK_MODELS set, streams fall back too.Anthropic::messages() returns the package's own Messages resource, which implements MessagesContract.UPGRADING.md lists the changes that can affect code written against 1.14, such as an instanceof Anthropic\Resources\Messages check that's now false.
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.14.0...1.15.0
Requires mozex/anthropic-php 1.14, with its stream completion handler and the billed-token helpers.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
mozex/anthropic-php 1.14, with its stream completion handler and the billed-token helpers.anthropic_requests table, each row billed to whoever Anthropic::for($user, feature: ...) names. php artisan anthropic:usage sums it, and model:prune prunes it.UsageRecorded is dispatched for every billed call, whether the ledger is on or not.Anthropic::budget('user:'.$user->id)->perDay(200_000)->enforce(), the anthropic.budget route middleware and the Anthropic\Laravel\Queue\TokenBudget job middleware. Once a budget is used up, calls are refused before they're sent, with a 429 on a route and a release on a queue. Several budgets can hold at once.ANTHROPIC_CONTEXT=true, streams add their tokens to Context too.UPGRADING.md lists the changes that can affect code written against 1.13, such as streams now adding their tokens to Context.
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.13.0...1.14.0
Requires mozex/anthropic-php 1.13, with its new fakes, batches()->wait() and the token-limit helpers.
mozex/anthropic-php 1.13, with its new fakes, batches()->wait() and the token-limit helpers.Anthropic::batch($requests)->then(...)->dispatch() sends a Message Batch and polls it in a queued job until it ends, on any connection or tenant key. catch(), onQueue(), onConnection(), every() and timeout() set the rest, and BatchSubmitted, BatchResultReceived (once per result) and BatchEnded are dispatched along the way.Anthropic::connection() and withApiKey() return Anthropic\Laravel\Connection.Anthropic::record() records the default connection's calls once and replays them from a file.Anthropic::assertBatched(), assertNotBatched(), and the fake's new assertions and responders through the facade.ThrottlesAnthropic job middleware fails a job on the spend cap (dispatching SpendCapReached) and on errors a retry can't fix, and releases it on rate limits and overloads, holding the key back meanwhile.Anthropic::models()->cached() keeps the model list in the cache, refreshed in the background once it's an hour old.php artisan anthropic:batches, anthropic:ping, anthropic:count-tokens, anthropic:chat and anthropic:models.FitsInTokens validation rule fails a text that would count more input tokens than a limit.UPGRADING.md lists the changes that can affect code written against 1.12, such as Anthropic::connection() now returning Connection.
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.12.0...1.13.0
Requires mozex/anthropic-php 1.12, with its typed exceptions, retries, middleware, per-request options and refusal fallback.
mozex/anthropic-php 1.12, with its typed exceptions, retries, middleware, per-request options and refusal fallback.connections, reached with Anthropic::connection('name'). Anthropic::withApiKey() builds a client for a tenant's key (without the default workspace_id), and Anthropic::organization(), enterprise() and compliance() reach the Admin, Enterprise and Compliance keys.Anthropic::fake() answers every connection; assertSentOn() checks which one a call used.AnthropicManager, so macros work on it.auth_token, workspace_id, connect_timeout, max_retries, fallback_models, middleware (the client's own, such as OpenTelemetryMiddleware), headers, context and http (Guzzle middleware, laravel_client, laravel_events, telescope, nightwatch). anthropic:install names the keys an older published file lacks and adds their .env lines, commented out.max_retries, throws when the client is built, naming the key.Anthropic::withOptions(), Anthropic::request() and iterate() on the list resources, with fakes.RequestSending, ResponseReceived, RequestFailed and RateLimited, with serializable data and no credentials or MCP server tokens.http.laravel_client lets Http::fake() see the calls, and http.laravel_events lets Telescope record them.php artisan anthropic:doctor checks the key, the API, the queues' retry_after against the longest call, and the fallback models' lifecycle, and exits non-zero on a failure.php artisan about shows an Anthropic section.ANTHROPIC_CONTEXT=true adds request IDs and token counts to Laravel's Context, and ANTHROPIC_HTTP_TELESCOPE=true records tagged Telescope entries. With Laravel Nightwatch installed, the calls show up there; ANTHROPIC_HTTP_NIGHTWATCH=false leaves them out.lifecycle filter now applies.ANTHROPIC_REQUEST_TIMEOUT= line means the default 30 seconds instead of making every request throw a TypeError.UPGRADING.md lists the changes that can affect code written against 1.10.
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.10.0...1.12.0
Requires mozex/anthropic-php 1.10, with its typed fields, lossless toArray(), API version option and error fixes.
mozex/anthropic-php 1.10, with its typed fields, lossless toArray(), API version option and error fixes.api_version (ANTHROPIC_API_VERSION) and base_url (ANTHROPIC_BASE_URL) config keys. base_url works like the official SDKs: /v1 is added unless the URL already ends in it. A config published by an earlier release needs both keys added by hand; anthropic:install names what's missing.anthropic:install adds each .env key a file lacks, the optional ones commented out.Anthropic::fake() also replaces the client for code that has ClientContract injected.php artisan vendor:publish --tag=anthropic-config publishes the config file.toolset_name), programmatic tool calling, the MCP connector, streamed refusals, model lifecycle checks, reading retryAfter in a queued job, and uploading a request's file under its original name. The skill also says to keep the queue's retry_after above the job's timeout, so a slow call isn't run and paid for twice.getErrorType(), which also catches an overload in the middle of a stream.$this->app->extend(ClientContract::class, ...); a binding made earlier in a service provider was dropped when the deferred provider loaded.A dependency typed Anthropic\Client can't take the fake and throws a TypeError after Anthropic::fake(); type-hint ClientContract. Classes are no longer final. See UPGRADING.md.
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.9.0...1.10.0
Laravel 11 stopped receiving security fixes on March 12, 2026. Three advisories published since then (GHSA-5vg9-5847-vvmq, GHSA-crmm-hgp2-wgrp and GHS…
laravel/framework requirement from ^11.29|^12.12|^13.0 to ^12.69|^13.30Laravel 11 stopped receiving security fixes on March 12, 2026. Three advisories published since then (GHSA-5vg9-5847-vvmq, GHSA-crmm-hgp2-wgrp and GHSA-jh5r-qr3c-85q8) affect every Laravel 11 release and were fixed only in Laravel 12 and 13. The new minimums, 12.69.0 and 13.30.0, are the first releases that include all three fixes.
If your app is still on Laravel 11, Composer keeps you on 1.8.2.
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.8.2...1.9.0
### What's Changed * Improve package setup Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.8.1...1.8.2
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.8.1...1.8.2
The description in resources/boost/skills/anthropic-laravel/SKILL.md is down from 1,226 to 814 characters, under the 1,024-character limit in the Agen
Boost skill
description in resources/boost/skills/anthropic-laravel/SKILL.md is down from 1,226 to 814 characters, under the 1,024-character limit in the Agent Skills spec. Codex CLI before 0.142 skipped the whole skill because of the length, and newer Codex and VS Code cut the description off at 1,024. Every trigger term is still there. The Context7 pointer that left the description still lives in the skill body.php artisan boost:update after updating so your agents pick up the new description.Reported by @kasparovabi in https://github.com/mozex/anthropic-laravel/issues/16
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.8.0...1.8.1
Server-side fallback for refused requests
Server-side fallback for refused requests
'fallbacks' => 'default' with the server-side-fallback-2026-07-01 beta so the API retries a refused request on another model instead of returning the refusal. The response DTOs from anthropic-php 1.8.0 parse the whole flow: the fallback content block, per-attempt usage->iterations, and stop_details->recommended_model.use Anthropic\Laravel\Facades\Anthropic;
use Illuminate\Support\Facades\Log;
$response = Anthropic::messages()->create([
'model' => 'claude-fable-5',
'max_tokens' => 1024,
'fallbacks' => 'default',
'betas' => ['server-side-fallback-2026-07-01'],
'messages' => [['role' => 'user', 'content' => $prompt]],
]);
foreach ($response->usage->iterations ?? [] as $iteration) {
if ($iteration->type === 'fallback_message') {
Log::info('Served by fallback model', ['model' => $iteration->model]);
}
}
Documentation
frontier_llm, reasoning_extraction, general_harms) and the new fallback section with a logging pattern, so refusal metrics don't misreport which model answered.web_search_20260318 version and its response_inclusion parameter.Boost skill
resources/boost/skills/anthropic-laravel/SKILL.md picks up the expanded category list and a pointer to the fallback flow, so AI assistants working in your app suggest current values.Dependency
mozex/anthropic-php to ^1.8.0. Everything in that release flows through the facade automatically: usage->outputTokensDetails (thinking token breakdown), usage->speed (fast mode), usage->iterations, compaction content blocks and context_management, and cache diagnostics. See the PHP 1.8.0 release notes for details and examples.Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.7.0...1.8.0
Anthropic::files() exposes the full Files resource: upload, list, retrieveMetadata, download, delete. Upload a document once and reference it by file_
Files API
Anthropic::files() exposes the full Files resource: upload, list, retrieveMetadata, download, delete. Upload a document once and reference it by file_id in later Messages calls, or read outputs produced by the code execution tool and Skills.use Anthropic\Laravel\Facades\Anthropic;
use Illuminate\Support\Facades\Storage;
$file = Anthropic::files()->upload([
'file' => Storage::disk('local')->readStream('doc.pdf'),
]);
$response = Anthropic::messages()->create([
'model' => 'claude-opus-4-6',
'max_tokens' => 1024,
'betas' => ['files-api-2025-04-14'],
'messages' => [[
'role' => 'user',
'content' => [
['type' => 'text', 'text' => 'Summarise this.'],
['type' => 'document', 'source' => ['type' => 'file', 'file_id' => $file->id]],
],
]],
]);
anthropic-beta: files-api-2025-04-14 header on every Anthropic::files() call, so there's nothing to configure. When you reference a file_id inside a Messages call, pass 'betas' => ['files-api-2025-04-14'] on the Messages call as well; the Messages endpoint also needs the header when a file is referenced. If every Messages call in your app references uploaded files, put the beta globally via config('anthropic.beta') instead.Testing
FileResponse::fake(), FileListResponse::fake(), and DeletedFileResponse::fake() now plug into Anthropic::fake([...]) with assertSent(Files::class, ...) assertions, same as every other resource.Documentation
Storage::readStream for uploads, queued jobs that stream downloads to S3, Eloquent anthropic_file_id columns, and the RateLimiter::for('anthropic-files', fn () => Limit::perMinute(90)) throttle for bulk uploads.Boost skill
resources/boost/skills/anthropic-laravel/SKILL.md picks up a new Files section covering the five methods, the Messages-side beta gotcha, block-to-file-type pairing, and the Eloquent + queued-job patterns. Triggers expanded to include Anthropic::files(), FileResponse, and file upload/reference work.mozex/anthropic-php to ^1.7.0. See the PHP 1.7.0 release notes for the underlying implementation, including the auto-injection mechanism and the 40 Files-specific tests behind this release.Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.6.0...1.7.0
Add Anthropic beta header support
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.5.0...1.6.0
Full Changelog : 1.5.0...1.6.0
Ship a Laravel Boost skill at resources/boost/skills/anthropic-laravel/SKILL.md so AI coding assistants pick up package conventions automatically when
Laravel Boost skill
resources/boost/skills/anthropic-laravel/SKILL.md so AI coding assistants pick up package conventions automatically when working in a Laravel project. Activates on any mention of the Anthropic facade, the underlying SDK classes, or Claude-related work.Anthropic::fake(), and error handling with the queue-retry pattern.caller?->type === 'direct' filter required in tool dispatchers, pause_turn resume semantics, refusal responses arriving with HTTP 200, and mid-stream errors throwing after the response started./mozex/anthropic-laravel, /mozex/anthropic-php) or direct fetches from the docs site, both of which serve markdown for AI agents.Documentation site
ShouldQueue jobs, Cache::remember for the model list, Storage::disk for vision and PDF citations, broadcasting from streamed responses, scheduled commands for batch polling, and bootstrap/app.php reportable() callbacks for silencing overload errors.mozex/anthropic-php to ^1.5.0. All API additions land transparently through the Anthropic facade: the caller object on tool blocks, container_upload blocks, stop_details on refusals, the typed model capabilities tree, inferenceGeo on usage, and Priority Tier rate-limit headers as typed properties on MetaInformation. See the PHP 1.5.0 release notes for the full feature list.Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.4.0...1.5.0
Expand README to document new Anthropic features and improved testing controls
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.3.3...1.4.0
Expand README to document new Anthropic features and improved testing controls
bump mozex/anthropic-php dependency
Full Changelog : 1.3.3...1.4.0
Laravel 13.x Compatibility by @laravel-shift in https://github.com/mozex/anthropic-laravel/pull/12
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.3.2...1.3.3
Laravel 13.x Compatibility by @laravel-shift in #12
updated model names for consistency
Full Changelog : 1.3.2...1.3.3
sync version with anthropic-php
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.3.0...1.3.2
bump anthropic-php
update readme
sync version with anthropic-php
Full Changelog : 1.3.0...1.3.2
Bump mozex/anthropic-php to ^1.2.0
mozex/anthropic-php to ^1.2.0See the anthropic-php UPGRADING.md for details on new features and changes. All changes are backwards compatible.
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.2.0...1.3.0
Bump mozex/anthropic-php to ^1.2.0
bump dependencies
dropped php 8.1 support
dropped laravel 9 and 10 support
See the anthropic-php UPGRADING.md for details on new features and changes. All changes are backwards compatible.
Full Changelog : 1.2.0...1.3.0
Add Laravel 12 compatibility by @mozex in https://github.com/mozex/anthropic-laravel/pull/6
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.1.0...1.2.0
Full Changelog : 1.1.0...1.2.0
Changed underlying mozex/anthropic-php package version from v1.0.3 to v1.1.0
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.0.3...1.1.0
Full Changelog : 1.0.3...1.1.0
Changed underlying mozex/anthropic-php package version from v1.0.2 to v1.0.3
Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.0.2...1.0.3
bump dependencies
add php 8.4 to workflow
Changed underlying mozex/anthropic-php package version from v1.0.2 to v1.0.3
Full Changelog : 1.0.2...1.0.3
Changed underlying mozex/anthropic-php package version from v1.0.1 to v1.0.2
mozex/anthropic-php package version from v1.0.1 to v1.0.2Full Changelog: https://github.com/mozex/anthropic-laravel/compare/1.0.1...1.0.2
Bump dependencies
Changed underlying mozex/anthropic-php package version from v1.0.1 to v1.0.2
Full Changelog : 1.0.1...1.0.2
- fix facade docs
Initial Release
One column per month.