---
title: Ошибки Claude API
url: https://platform.claude.com/docs/ru/api/errors
description: Узнайте о кодах состояния HTTP, структуре ответа об ошибке и идентификаторах запросов, которые возвращает Claude API, и обрабатывайте ошибки с помощью типизированных исключений SDK.
---
## Ошибки HTTP
API использует предсказуемый формат кодов ошибок HTTP:
* 400 - `invalid_request_error`: возникла проблема с форматом или содержимым вашего запроса. Этот тип ошибки также может использоваться для других кодов состояния 4XX, не перечисленных в этом разделе. API также возвращает 400, когда использование достигает [установленного вами лимита расходов](https://platform.claude.com/docs/ru/api/rate-limits#setting-your-own-spend-limit) для организации или рабочего пространства, за исключением лимитов для [рабочего пространства Claude Code](https://platform.claude.com/docs/ru/manage-claude/workspaces#claude-code-workspace), которые вместо этого могут возвращать 429.
* 401 - `authentication_error`: возникла проблема с вашим [ключом API](https://platform.claude.com/docs/ru/get-api-key) (например, он имеет неверный формат, отозван или истёк; см. [Истечение срока действия ключа](https://platform.claude.com/docs/ru/manage-claude/authentication#key-expiration)). В Claude Platform on AWS это также может указывать на проблему с вашими учётными данными AWS или подписью SigV4.
* 402 - `billing_error`: возникла проблема с вашей платёжной информацией или данными об оплате. Проверьте платёжные данные в [Claude Console](https://platform.claude.com) или в AWS Marketplace, если вы используете Claude Platform on AWS.
* 403 - `permission_error`: у вашего ключа API нет разрешения на использование указанного ресурса. Проверьте настройки доступа вашей организации и рабочего пространства в [Claude Console](https://platform.claude.com).
* 404 - `not_found_error`: запрошенный ресурс не найден. Проверьте путь к эндпоинту и все идентификаторы ресурсов в URL запроса.
* 409 - `conflict_error`: запрос конфликтует с текущим состоянием ресурса. Например, ресурс был изменён параллельно, или значение, которое должно быть уникальным, уже используется. Устраните конфликт, а затем повторите запрос.
* 413 - `request_too_large`: запрос превышает максимально допустимое количество байтов. Максимальные значения для каждого эндпоинта см. в разделе [Ограничения размера запроса](https://platform.claude.com/docs/ru/api/errors#request-size-limits).
* 429 - `rate_limit_error`: ваша организация достигла [«rate limit» (ограничения скорости)](https://platform.claude.com/docs/ru/api/rate-limits), месячного предела расходов своего уровня использования или лимита расходов для рабочего пространства Claude Code. Ошибка 429 из-за предела расходов уровня не содержит заголовка `retry-after` и продолжает возникать до восстановления доступа; как её распознать, см. в разделе [Достижение предела расходов](https://platform.claude.com/docs/ru/api/rate-limits#reaching-your-spend-cap).
* 500 - `api_error`: во внутренних системах Anthropic произошла непредвиденная ошибка. Повторите запрос с экспоненциальной задержкой; если ошибка сохраняется, обратитесь в службу поддержки, указав [идентификатор запроса](https://platform.claude.com/docs/ru/api/errors#request-id).
* 504 - `timeout_error`: время ожидания запроса истекло во время обработки. Для длительных запросов рассмотрите возможность использования [Messages API с потоковой передачей](https://platform.claude.com/docs/ru/build-with-claude/streaming). Дополнительные варианты см. в разделе [Длительные запросы](https://platform.claude.com/docs/ru/api/errors#long-requests).
* 529 - `overloaded_error`: API временно перегружен.
Ошибки 529 могут возникать, когда API испытывает высокую нагрузку со стороны всех пользователей.
В редких случаях, если использование в вашей организации резко возрастает, вы можете получать ошибки 429 из-за «acceleration limits» (ограничений на ускорение) в API. Чтобы не достигать ограничений на ускорение, наращивайте трафик постепенно и поддерживайте стабильные шаблоны использования.
Официальный SDK автоматически повторяет запросы при временных сбоях (таких как ошибки соединения, ограничения скорости и серверные ошибки 5xx) с экспоненциальной задержкой — по умолчанию дважды, учитывая заголовок `retry-after`, если он присутствует. Клиент SDK принимает `max_retries` (typescript, java, php: `maxRetries`; csharp: `MaxRetries`; go: `option.WithMaxRetries`) для настройки или отключения этого поведения.
При получении ответа с [потоковой передачей](https://platform.claude.com/docs/ru/build-with-claude/streaming) через «server-sent events» (события, отправляемые сервером), или SSE, ошибка может возникнуть после того, как API вернул ответ 200. В этом случае обработка ошибок не следует этим стандартным механизмам. Структуру ошибок, возникающих в середине потока, см. в разделе [События ошибок](https://platform.claude.com/docs/ru/build-with-claude/streaming#error-events).
## Ограничения размера запроса
API применяет ограничения на размер запроса:
| Тип эндпоинта | Максимальный размер запроса |
| ----------------------------------------------------------------------------------- | --------------------------- |
| Messages API | 32 MB |
| Token Counting API | 32 MB |
| [Batch API](https://platform.claude.com/docs/ru/build-with-claude/batch-processing) | 256 MB |
| [Files API](https://platform.claude.com/docs/ru/build-with-claude/files) | 500 MB |
При превышении этих ограничений вы получите ошибку 413 `request_too_large`. При прямом использовании Claude API эту ошибку возвращает Cloudflare ещё до того, как запрос достигнет серверов API.
## Структура ошибок
API всегда возвращает ошибки в формате JSON. Ответ содержит объект `error` верхнего уровня, который всегда включает значения `type` и `message`. Ответ также включает поле `request_id` для упрощения отслеживания и отладки. Например:
```json JSON
{
"type": "error",
"error": {
"type": "not_found_error",
"message": "The requested resource could not be found."
},
"request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}
```
В соответствии с политикой [версионирования](https://platform.claude.com/docs/ru/api/versioning) набор значений внутри этих объектов может расширяться. Со временем могут появиться и новые значения `type`.
## Типы ошибок SDK
Официальный SDK выбрасывает типизированные исключения для этих ошибок вместо возврата необработанного JSON. Например, ошибка 404 проявляется как `anthropic.NotFoundError` (typescript: `Anthropic.NotFoundError`; ruby: `Anthropic::Errors::NotFoundError`; java: `com.anthropic.errors.NotFoundException`; csharp: `AnthropicNotFoundException`; php: `Anthropic\Core\Exceptions\NotFoundException`; go: `*anthropic.Error`). В Go SDK есть один тип ошибки для всех статусов — `*anthropic.Error`: выполняйте ветвление по `StatusCode`. Перехватывайте типизированные классы SDK, а не сопоставляйте строки сообщений об ошибках, обрабатывая сначала наиболее специфичные классы. Полная иерархия исключений описана на странице вашего SDK:
* [Python](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/python#handling-errors) · [TypeScript](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/typescript#handling-errors) · [C#](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/csharp#error-handling) · [Go](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/go#error-handling) · [Java](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/java#error-handling) · [PHP](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/php#error-handling) · [Ruby](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/ruby#handling-errors)
## Идентификатор запроса
Каждый ответ API включает уникальный заголовок `request-id`. Этот заголовок содержит значение вида `req_018EeWyXxfu5pfWkrYcMdjWG`. Тот же идентификатор передаётся в поле `request_id` в [телах ответов с ошибками](https://platform.claude.com/docs/ru/api/errors#error-shapes). При обращении в службу поддержки по поводу конкретного запроса укажите этот идентификатор, чтобы вашу проблему решили быстрее.
В [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws) ответы включают два идентификатора запроса: идентификатор запроса AWS (`x-amzn-requestid`, основной, индексируется в CloudTrail) и идентификатор запроса Anthropic (`request-id`, дополнительный). Используйте идентификатор запроса AWS для поиска в CloudTrail, а идентификатор запроса Anthropic — для обращений в службу поддержки Anthropic.
SDK для Python и TypeScript предоставляют идентификатор запроса в виде свойства `_request_id` у объектов ответа верхнего уровня. SDK для C#, Go, Java и PHP предоставляют его через свои методы доступа к необработанному ответу, а SDK для Ruby — через [middleware](https://platform.claude.com/docs/ru/cli-sdks-libraries/middleware). Во всех SDK, кроме Ruby, используйте `with_raw_response` (typescript: `.withResponse()`; java: `.withRawResponse()`; csharp: `WithRawResponse`; go: `option.WithResponseInto`; php: `->raw`), чтобы прочитать любой другой [заголовок ответа](https://platform.claude.com/docs/ru/api/overview#response-headers). Например, так можно прочитать `anthropic-organization-id` и [`anthropic-workspace-id`](https://platform.claude.com/docs/ru/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). В Ruby используйте то же middleware. В Claude Platform on AWS метод доступа к необработанному ответу также позволяет прочитать идентификатор запроса AWS (`x-amzn-requestid`):
```bash cURL
# Вывести заголовки ответа (включая request-id); тело ответа отбросить
curl -sS -D - -o /dev/null https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'
```
```bash CLI
# Заголовок request-id выводится в stderr при использовании --debug:
ant --debug messages create \
--model claude-sonnet-5 \
--max-tokens 1024 \
--message '{role: user, content: "Hello, Claude"}'
```
```python Python
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(f"Request ID: {message._request_id}")
```
```typescript TypeScript
const client = new Anthropic();
const message = await client.messages.create({
model: "claude-sonnet-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello, Claude" }]
});
console.log("Request ID:", message._request_id);
```
```csharp C#
AnthropicClient client = new();
using var response = await client.WithRawResponse.Messages.Create(new MessageCreateParams
{
Model = Model.ClaudeSonnet5,
MaxTokens = 1024,
Messages = [new() { Role = Role.User, Content = "Hello, Claude" }]
});
Console.WriteLine($"Request ID: {response.RequestID}");
```
```go Go
client := anthropic.NewClient()
var response *http.Response
_, err := client.Messages.New(
context.Background(),
anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5,
MaxTokens: 1024,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")),
},
},
option.WithResponseInto(&response),
)
if err != nil {
panic(err)
}
fmt.Println("Request ID:", response.Header.Get("request-id"))
```
```java Java
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.core.http.HttpResponseFor;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
HttpResponseFor response = client.messages().withRawResponse().create(
MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5)
.maxTokens(1024)
.addUserMessage("Hello, Claude")
.build()
);
IO.println("Request ID: " + response.requestId().orElse(null));
}
```
```php PHP
$client = new Client();
$response = $client->messages->raw->create([
'model' => 'claude-sonnet-5',
'maxTokens' => 1024,
'messages' => [['role' => 'user', 'content' => 'Hello, Claude']],
]);
echo 'Request ID: ' . $response->getHeaderLine('request-id') . "\n";
```
```ruby Ruby
client = Anthropic::Client.new
# Читайте заголовки ответа в middleware для каждого запроса, которое получает
# необработанный HTTP-ответ до того, как SDK его разберёт
request_id = nil
read_request_id = lambda do |request, call_next|
response = call_next.call(request)
# Ключи в response.headers записаны в нижнем регистре
request_id = response.headers["request-id"]
response
end
client.messages.create(
model: Anthropic::Model::CLAUDE_SONNET_5,
max_tokens: 1024,
messages: [{ role: "user", content: "Hello, Claude" }],
request_options: { middleware: [read_request_id] }
)
puts "Request ID: #{request_id}"
```
```python Python (Claude Platform on AWS)
from anthropic import AnthropicAWS
client = AnthropicAWS(aws_region="us-west-2")
response = client.messages.with_raw_response.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(f"AWS request ID: {response.headers.get('x-amzn-requestid')}")
message = response.parse()
print(f"Anthropic request ID: {message._request_id}")
```
```typescript TypeScript (Claude Platform on AWS)
import AnthropicAws from "@anthropic-ai/aws-sdk";
const client = new AnthropicAws({ awsRegion: "us-west-2" });
const { response: raw, request_id } = await client.messages
.create({
model: "claude-opus-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello, Claude" }]
})
.withResponse();
console.log("AWS request ID:", raw.headers.get("x-amzn-requestid"));
console.log("Anthropic request ID:", request_id);
```
Примеры получения идентификатора запроса в Claude Platform on AWS на других языках см. в разделе [Идентификаторы запросов](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#request-ids).
## Длительные запросы
Для длительных запросов, особенно продолжительностью более 10 минут, рассмотрите возможность использования [Messages API с потоковой передачей](https://platform.claude.com/docs/ru/build-with-claude/streaming) или [Message Batches API](https://platform.claude.com/docs/ru/api/messages/batches/create).
Избегайте установки большого значения `max_tokens` без использования [Messages API с потоковой передачей](https://platform.claude.com/docs/ru/build-with-claude/streaming) или [Message Batches API](https://platform.claude.com/docs/ru/api/messages/batches/create):
* Некоторые сети могут разрывать неактивные соединения через различные промежутки времени, что может привести к сбою запроса или истечению времени ожидания без получения ответа от Anthropic.
* Сети различаются по надёжности. [Message Batches API](https://platform.claude.com/docs/ru/api/messages/batches/create) может помочь вам управлять риском сетевых проблем, позволяя опрашивать результаты вместо того, чтобы требовать непрерывного сетевого соединения.
Если вы создаёте прямую интеграцию с API, установка [TCP socket keep-alive](https://tldp.org/HOWTO/TCP-Keepalive-HOWTO/programming.html) может снизить влияние тайм-аутов неактивных соединений в некоторых сетях.
[SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview) проверяют, что ваши запросы к Messages API без потоковой передачи не должны превысить 10-минутный тайм-аут. Они также устанавливают параметр сокета для TCP keep-alive.
Если вам не нужно обрабатывать события по мере поступления, SDK может прочитать поток за вас и вернуть полный объект `Message`, идентичный тому, что возвращает вызов без потоковой передачи:
Запрос curl выводит необработанные события потока и не может объединить их в итоговое сообщение. Чтобы получить полный объект `Message` из потока, используйте [Claude SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview).
```bash CLI
# CLI передаёт события потоково; --format jsonl выводит по одному событию на строку
ant messages create --stream --format jsonl <<'YAML'
model: claude-sonnet-5
max_tokens: 128000
messages:
- role: user
content: Write a detailed analysis...
YAML
```
```python Python
client = anthropic.Anthropic()
with client.messages.stream(
max_tokens=128000,
messages=[{"role": "user", "content": "Write a detailed analysis..."}],
model="claude-sonnet-5",
) as stream:
message = stream.get_final_message()
print(next(block.text for block in message.content if block.type == "text"))
```
```typescript TypeScript
const client = new Anthropic();
const stream = client.messages.stream({
max_tokens: 128000,
messages: [{ role: "user", content: "Write a detailed analysis..." }],
model: "claude-sonnet-5"
});
const message = await stream.finalMessage();
const textBlock = message.content.find((block) => block.type === "text");
if (textBlock && textBlock.type === "text") {
console.log(textBlock.text);
}
```
```csharp C#
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = Model.ClaudeSonnet5,
MaxTokens = 128000,
Messages = [new() { Role = Role.User, Content = "Write a detailed analysis..." }]
};
var message = await client.Messages.CreateStreaming(parameters).Aggregate();
Console.WriteLine(message);
```
```go Go
client := anthropic.NewClient()
stream := client.Messages.NewStreaming(context.TODO(), anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5,
MaxTokens: 128000,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Write a detailed analysis...")),
},
})
message := anthropic.Message{}
for stream.Next() {
event := stream.Current()
if err := message.Accumulate(event); err != nil {
log.Fatal(err)
}
}
if err := stream.Err(); err != nil {
log.Fatal(err)
}
for _, block := range message.Content {
if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok {
fmt.Println(textBlock.Text)
break
}
}
```
```java Java
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.helpers.MessageAccumulator;
import com.anthropic.models.messages.ContentBlock;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5)
.maxTokens(128000L)
.addUserMessage("Write a detailed analysis...")
.build();
MessageAccumulator accumulator = MessageAccumulator.create();
try (var streamResponse = client.messages().createStreaming(params)) {
streamResponse.stream().forEach(accumulator::accumulate);
}
Message message = accumulator.message();
message.content().stream()
.filter(ContentBlock::isText)
.findFirst()
.flatMap(ContentBlock::text)
.ifPresent(textBlock -> IO.println(textBlock.text()));
}
```
```php PHP
use Anthropic\Lib\Streaming\MessageAccumulator;
$client = new Client();
$stream = $client->messages->createStream(
model: 'claude-sonnet-5',
maxTokens: 128000,
messages: [['role' => 'user', 'content' => 'Write a detailed analysis...']],
);
$accumulator = MessageAccumulator::forMessages();
foreach ($stream as $event) {
$accumulator->accumulate($event);
}
echo array_find($accumulator->message()->content, static fn ($block): bool => $block->type === 'text')->text;
```
```ruby Ruby
client = Anthropic::Client.new
message = client.messages.stream(
model: "claude-sonnet-5",
max_tokens: 128000,
messages: [{ role: "user", content: "Write a detailed analysis..." }]
).accumulated_message
puts message.content.find { it.type == :text }.text
```
Подробнее см. в разделе [Потоковая передача сообщений](https://platform.claude.com/docs/ru/build-with-claude/streaming#get-the-final-message-without-handling-events).
## Распространённые ошибки валидации
### Предварительное заполнение не поддерживается
Модели Claude 4.6 и более поздние, а также [Claude Mythos Preview](https://anthropic.com/glasswing) не поддерживают «prefill» (предварительное заполнение) сообщений ассистента. Отправка запроса с предварительно заполненным последним сообщением ассистента любой из этих моделей возвращает ошибку 400 `invalid_request_error`:
```json
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "This model does not support assistant message prefill. The conversation must end with a user message."
}
}
```
Вместо этого используйте [структурированные выходные данные](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs) на моделях, которые их поддерживают, инструкции в «system prompt» (системной подсказке) или [`output_config.format`](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs#usage).
### Блоки размышлений нельзя изменять
Последнее сообщение ассистента может содержать блоки `thinking` или `redacted_thinking`, которые перед отправкой обратно в API были отредактированы, переупорядочены, отфильтрованы или реконструированы. В этом случае запрос возвращает ошибку 400 `invalid_request_error`. Сообщение об ошибке начинается с позиции проблемного блока (например, `messages.1.content.0`) и содержит:
```text wrap
`thinking` or `redacted_thinking` blocks in the latest assistant message cannot be modified. These blocks must remain as they were in the original response.
```
При «tool use» (использовании инструментов) каждый блок `thinking` и `redacted_thinking` из хода ассистента нужно передать обратно точно в том виде, в котором он был получен. Это относится и к блокам с пустым полем `thinking`. Передавайте блоки размышлений («thinking») обратно без изменений. Если ваше приложение перед повторной отправкой фильтрует блоки содержимого по типу, включайте как `thinking`, так и `redacted_thinking`. См. [Устранение неполадок с размышлениями](https://platform.claude.com/docs/ru/build-with-claude/thinking-troubleshooting#error-thinking-blocks-modified), [Сохранение блоков размышлений](https://platform.claude.com/docs/ru/build-with-claude/thinking#preserving-thinking-blocks) и [Сохранённые размышления](https://platform.claude.com/docs/ru/build-with-claude/thinking#preserved-thinking).
### Расширенные размышления не поддерживаются
В моделях Claude 4.7 и более поздних «extended thinking» (расширенные размышления) удалены. Отправка `thinking: {"type": "enabled"}` любой из этих моделей возвращает ошибку 400 `invalid_request_error`:
```text wrap
"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```
Вместо этого используйте [«adaptive thinking» (адаптивные размышления)](https://platform.claude.com/docs/ru/build-with-claude/thinking). Соответствие параметров показано в разделе [Переход на адаптивные размышления](https://platform.claude.com/docs/ru/build-with-claude/extended-thinking#migrating-to-adaptive-thinking). Исправление, начиная с симптома, описано в разделе [Устранение неполадок с размышлениями](https://platform.claude.com/docs/ru/build-with-claude/thinking-troubleshooting#error-thinking-type-enabled).
### Адаптивные размышления не поддерживаются
Модели, поддерживающие только расширенные размышления (Claude 4.5 и более ранние модели), отклоняют `thinking: {"type": "adaptive"}` с ошибкой 400 `invalid_request_error`:
```text wrap
adaptive thinking is not supported on this model
```
На этих моделях используйте `thinking: {"type": "enabled", "budget_tokens": N}`. Конфигурацию см. в разделе [Расширенные размышления](https://platform.claude.com/docs/ru/build-with-claude/extended-thinking), а исправление, начиная с симптома, — в разделе [Устранение неполадок с размышлениями](https://platform.claude.com/docs/ru/build-with-claude/thinking-troubleshooting#error-thinking-type-adaptive).
### Размышления нельзя отключить
На Claude Fable 5.1, [Claude Mythos 5.1](https://platform.claude.com/docs/ru/models/mythos-5-1/overview), Claude Fable 5, [Claude Mythos 5](https://platform.claude.com/docs/ru/models/mythos-5/overview), Claude Opus 5.5 и [Claude Mythos Preview](https://anthropic.com/glasswing) размышления всегда включены. Отправка `thinking: {"type": "disabled"}` любой из этих моделей возвращает ошибку 400 `invalid_request_error`. На всех этих моделях, кроме Claude Mythos Preview, сообщение гласит:
```text wrap
"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```
На Claude Mythos Preview — единственной из этих моделей, которая принимает расширенные размышления, — сообщение гласит:
```text wrap
"thinking.type.disabled" is not supported for this model. Thinking defaults to adaptive mode when not specified; use "thinking.type.enabled" with "budget_tokens" for extended thinking.
```
На Claude Sonnet 5.5 для размышлений нельзя установить значение `disabled`. Используйте `thinking: {"type": "between_tools"}` для минимальной настройки размышлений, которая отключает предварительные размышления. Отправка `thinking: {"type": "disabled"}` возвращает ошибку 400 `invalid_request_error` с таким сообщением:
```text wrap
To turn thinking off on this model, send "thinking": {"type": "between_tools"} instead of {"type": "disabled"}. The model does not think before responding. The short updates it writes between tool calls come back as thinking blocks.
```
При [уровне усилий](https://platform.claude.com/docs/ru/build-with-claude/effort) `xhigh` или `max` запрос с `between_tools` также возвращает ошибку 400 `invalid_request_error`. В сообщении говорится, что размышления отключены, поскольку в `between_tools` нет предварительных размышлений:
```text wrap
output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.
```
При использовании `between_tools` уровень усилий нельзя изменить в середине диалога: значение `output_config.effort` для отдельного сообщения, отличающееся от действующего уровня, возвращает ошибку 400. В ошибке указывается позиция сообщения, которое установило новый уровень:
```text wrap
messages.N: output_config.effort 'low' differs from the 'high' in effect before it; effort cannot change when thinking is disabled on this model. Use effort 'high', or enable thinking.
```
Claude Haiku 5.5 принимает `thinking: {"type": "disabled"}` и применяет к нему те же два ограничения на уровень усилий, что действуют для `between_tools`: при уровне усилий `xhigh` или `max`, либо при значении `output_config.effort` для отдельного сообщения, отличающемся от действующего уровня, запрос возвращает ошибку 400 `invalid_request_error` с соответствующим сообщением, показанным выше.
В обоих сообщениях «enable thinking» означает адаптивные размышления: опустите поле `thinking` или отправьте `thinking: {"type": "adaptive"}`. Claude Sonnet 5.5 и Claude Haiku 5.5 отклоняют `"enabled"` с ошибкой 400. Чтобы менять уровень усилий от хода к ходу, используйте адаптивные размышления.
Отправка `thinking: {"type": "between_tools"}` любой модели, кроме Claude Sonnet 5.5, возвращает ошибку 400 `invalid_request_error`:
```text wrap
"thinking.type.between_tools" is not supported for this model.
```
Исправления см. в разделе [Устранение неполадок с размышлениями](https://platform.claude.com/docs/ru/build-with-claude/thinking-troubleshooting#error-thinking-type-between-tools), где рассматриваются ошибки `between_tools` и уровня усилий.
Если опустить параметр `thinking`, запрос выполняется с адаптивными размышлениями. Чтобы исключить содержимое размышлений из ответов, не отключая сами размышления, установите `display: "omitted"` в конфигурации размышлений. См. [Устранение неполадок с размышлениями](https://platform.claude.com/docs/ru/build-with-claude/thinking-troubleshooting#error-thinking-type-disabled).
### Принудительное использование инструментов не поддерживается
Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.1 и [Claude Mythos 5.1](https://platform.claude.com/docs/ru/models/mythos-5-1/overview) не поддерживают принудительное использование инструментов. Отправка `tool_choice: {"type": "any"}` или `tool_choice: {"type": "tool", "name": "..."}` любой из этих моделей, в том числе на [эндпоинт подсчёта токенов](https://platform.claude.com/docs/ru/build-with-claude/token-counting), возвращает ошибку 400 `invalid_request_error`:
```text wrap
tool_choice: type "tool" and "any" are not supported for this model.
```
`tool_choice: {"type": "auto"}` (значение по умолчанию) и `{"type": "none"}` принимаются. Используйте `auto` со [строгим использованием инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/strict-tool-use), чтобы входные данные инструментов соответствовали схеме, или [структурированные выходные данные](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs), если сам ответ нужен в фиксированной структуре JSON. См. [Принудительное использование инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/define-tools#forcing-tool-use).
### Версия инструмента computer use не поддерживается
В Claude API и Google Cloud модели Claude Opus 5.5, Claude Sonnet 5.5 и Claude Haiku 5.5 поддерживают [computer use](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool) только в виде набора инструментов `computer_toolset_20260801`. На этих платформах отправка любой из этих моделей записи `tools` более раннего типа `computer_20251124` или `computer_20250124` с бета-заголовком этого инструмента возвращает ошибку 400 `invalid_request_error`. В сообщении указывается отклонённый тип, а затем после `Did you mean one of` перечисляются типы инструментов, которые модель принимает. Для Claude Opus 5.5 оно начинается так:
```text wrap
'claude-opus-5-5' does not support tool types: computer_20251124.
```
API возвращает то же сообщение для любого определённого Anthropic типа инструмента, который запрошенная модель не поддерживает. Объявите `{"type": "computer_toolset_20260801"}` без бета-заголовка и обновите цикл агента, как описано в разделе [Миграция с `computer_20251124`](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124). Чтобы перейти с `computer_20250124`, см. раздел [Перенесите использование компьютера на набор инструментов](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide#computer-use-toolset) в руководстве по миграции на Claude Haiku 5.5. Более ранние модели, поддерживающие набор инструментов, продолжают принимать `computer_20251124`, как и Claude Opus 5.5, Claude Sonnet 5.5 и Claude Haiku 5.5 в Amazon Bedrock.
### Блок размышлений больше не соответствует диалогу
В моделях Claude Fable 5.1, Claude Opus 5.5, Claude Sonnet 5.5 и Claude Haiku 5.5 API принимает повторно переданный блок размышлений только до тех пор, пока подсказка `system`, `tools` и предшествующие ему сообщения остаются неизменными. Для новых аккаунтов, созданных 31 августа 2026 года или позже, а также для любого запроса, в котором `thinking.block_binding.prefix_mismatch_behavior` установлен в `"error"`, повторно переданный блок, предшествующая история которого изменилась, отклоняется с ошибкой 400 `invalid_request_error` (при `"drop_block"` API отбрасывает блок, и запрос выполняется успешно). Сообщение начинается с позиции первого блока, не прошедшего проверку:
```text wrap
messages.{i}.content.{j}: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block".
```
Без бета-заголовка `thinking-binding-controls-2026-08-01` в сообщении также указывается этот заголовок. Сохраняйте историю диалога в режиме только добавления или отправьте бета-заголовок с `prefix_mismatch_behavior: "drop_block"`, чтобы отбросить блок и продолжить. В Claude Sonnet 5.5 и Claude Haiku 5.5 `block_binding` работает только с `thinking: {"type": "adaptive"}`. При использовании `between_tools` в Claude Sonnet 5.5 или `thinking: {"type": "disabled"}` в Claude Haiku 5.5 сохраняйте историю в режиме только добавления или удаляйте блоки размышлений начиная с отредактированного хода. Блок от модели, которую целевая модель не может прочитать, отбрасывается, а не отклоняется. См. [Сохранение префикса неизменным](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking#prefix-check) и [Устранение неполадок с размышлениями](https://platform.claude.com/docs/ru/build-with-claude/thinking-troubleshooting#error-thinking-block-signature).
Отправка `thinking.block_binding` без [бета-заголовка](https://platform.claude.com/docs/ru/api/beta-headers) `thinking-binding-controls-2026-08-01` возвращает ошибку 400 `invalid_request_error`, сообщение которой заканчивается так:
```text wrap
block_binding: Extra inputs are not permitted
```
Добавьте заголовок или удалите поле.
### Исходящая федерация веб-удостоверений отключена (Claude Platform on AWS)
Если каждый запрос к [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws) возвращает `"Outbound web identity federation is disabled for your account"`, выполните `aws iam enable-outbound-web-identity-federation` один раз для каждого аккаунта AWS. Подробнее см. в разделе [Включение исходящей федерации веб-удостоверений](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation).
## Дальнейшие шаги
Исправления, начиная с симптома: ошибки 400 в конфигурации размышлений, пустые блоки размышлений и остановки по `max_tokens`.
Чтобы предотвратить злоупотребления и управлять пропускной способностью API, объём использования Claude API организацией ограничен.
Получайте ответы Messages API постепенно через события, отправляемые сервером, включая дельты текста, использования инструментов и расширенных размышлений.