---
title: Совместимость с OpenAI SDK
url: https://platform.claude.com/docs/ru/cli-sdks-libraries/libraries/openai-sdk
description: Anthropic предоставляет слой совместимости, который позволяет использовать OpenAI SDK для тестирования Claude API. Внеся несколько изменений в код, вы можете быстро оценить возможности моделей Anthropic.
---
Этот слой совместимости предназначен в первую очередь для тестирования и сравнения возможностей моделей и не считается долгосрочным или готовым к производственному использованию решением для большинства сценариев. Хотя предполагается, что он останется полностью функциональным и не будет содержать критических изменений, приоритетом являются надёжность и эффективность [Claude API](https://platform.claude.com/docs/ru/api/overview).
Дополнительную информацию об известных ограничениях совместимости см. в разделе [Важные ограничения совместимости с OpenAI](https://platform.claude.com/docs/ru/cli-sdks-libraries/libraries/openai-sdk#important-openai-compatibility-limitations).
Если вы столкнётесь с какими-либо проблемами при использовании функции совместимости с OpenAI SDK, поделитесь своим отзывом через эту [форму обратной связи по совместимости](https://forms.gle/oQV4McQNiuuNbz9n8).
Для наилучшего опыта и доступа к полному набору функций Claude API ([обработка PDF](https://platform.claude.com/docs/ru/build-with-claude/pdf-support), [цитирование](https://platform.claude.com/docs/ru/build-with-claude/citations), [размышления](https://platform.claude.com/docs/ru/build-with-claude/thinking) и [кэширование подсказок](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching)) используйте нативный [Claude API](https://platform.claude.com/docs/ru/api/overview).
## Начало работы с OpenAI SDK
Чтобы использовать функцию совместимости с OpenAI SDK, вам необходимо:
1. Использовать официальный OpenAI SDK
2. Изменить следующее
* Обновите базовый URL, чтобы он указывал на Claude API
* Замените ваш ключ API на [ключ API Claude](https://platform.claude.com/settings/keys)
* Если ваш ключ является [персональным ключом или ключом сервисного аккаунта](https://platform.claude.com/docs/ru/manage-claude/authentication#key-types) с доступом к нескольким рабочим пространствам, также отправляйте заголовок `anthropic-workspace-id` с каждым запросом (например, `default_headers` в Python SDK или `defaultHeaders` в TypeScript); см. раздел [Выбор рабочего пространства](https://platform.claude.com/docs/ru/manage-claude/authentication#select-a-workspace)
* Обновите название модели, чтобы использовать [модель Claude](https://platform.claude.com/docs/ru/models/overview)
3. Ознакомиться со следующими разделами, чтобы узнать, какие функции поддерживаются
### Пример быстрого старта
```python Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("ANTHROPIC_API_KEY"), # Your Claude API key
base_url="https://api.anthropic.com/v1/", # the Claude API endpoint
)
response = client.chat.completions.create(
model="claude-opus-5-5", # Claude model name
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Who are you?"},
],
)
print(response.choices[0].message.content)
```
```typescript TypeScript
import OpenAI from "openai";
const openai = new OpenAI({
apiKey: process.env.ANTHROPIC_API_KEY, // Your Claude API key
baseURL: "https://api.anthropic.com/v1/" // Claude API endpoint
});
const response = await openai.chat.completions.create({
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "Who are you?" }
],
model: "claude-opus-5-5" // Claude model name
});
console.log(response.choices[0].message.content);
```
```csharp C#
using System.ClientModel;
using OpenAI;
using OpenAI.Chat;
ChatClient chatClient = new(
model: "claude-opus-5-5", // Claude model name
credential: new ApiKeyCredential(
Environment.GetEnvironmentVariable("ANTHROPIC_API_KEY")), // Your Claude API key
options: new OpenAIClientOptions()
{
Endpoint = new Uri("https://api.anthropic.com/v1/") // the Claude API endpoint
});
ChatCompletion completion = chatClient.CompleteChat(
new SystemChatMessage("You are a helpful assistant."),
new UserChatMessage("Who are you?"));
Console.WriteLine(completion.Content[0].Text);
```
```go Go
package main
import (
"context"
"fmt"
"os"
"github.com/openai/openai-go/v3"
"github.com/openai/openai-go/v3/option"
)
func main() {
client := openai.NewClient(
option.WithAPIKey(os.Getenv("ANTHROPIC_API_KEY")), // Your Claude API key
option.WithBaseURL("https://api.anthropic.com/v1/"), // the Claude API endpoint
)
response, err := client.Chat.Completions.New(context.Background(), openai.ChatCompletionNewParams{
Model: "claude-opus-5-5", // Claude model name
Messages: []openai.ChatCompletionMessageParamUnion{
openai.SystemMessage("You are a helpful assistant."),
openai.UserMessage("Who are you?"),
},
})
if err != nil {
panic(err)
}
fmt.Println(response.Choices[0].Message.Content)
}
```
```java Java
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.chat.completions.ChatCompletion;
import com.openai.models.chat.completions.ChatCompletionCreateParams;
public class QuickStart {
public static void main(String[] args) {
OpenAIClient client = OpenAIOkHttpClient.builder()
.apiKey(System.getenv("ANTHROPIC_API_KEY")) // Your Claude API key
.baseUrl("https://api.anthropic.com/v1/") // the Claude API endpoint
.build();
ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
.model("claude-opus-5-5") // Claude model name
.addSystemMessage("You are a helpful assistant.")
.addUserMessage("Who are you?")
.build();
ChatCompletion completion = client.chat().completions().create(params);
System.out.println(completion.choices().get(0).message().content().orElse(""));
}
}
```
У OpenAI нет официального SDK для PHP. Чтобы использовать Claude из PHP, используйте вместо этого [Claude SDK для PHP](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/php).
```ruby Ruby
require "openai"
openai = OpenAI::Client.new(
api_key: ENV["ANTHROPIC_API_KEY"], # Your Claude API key
base_url: "https://api.anthropic.com/v1/" # the Claude API endpoint
)
response = openai.chat.completions.create(
model: "claude-opus-5-5", # Claude model name
messages: [
{role: "system", content: "You are a helpful assistant."},
{role: "user", content: "Who are you?"}
]
)
puts response.choices.first.message.content
```
## Важные ограничения совместимости с OpenAI
### Поведение API
Вот наиболее существенные отличия от использования OpenAI:
* Параметр `strict` для вызова функций игнорируется, что означает, что JSON при использовании инструментов не гарантированно соответствует предоставленной схеме. Для гарантированного соответствия схеме используйте нативный [Claude API со структурированными выводами](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs).
* Аудиовход не поддерживается; он будет проигнорирован и удалён из входных данных
* Кэширование подсказок не поддерживается, но оно поддерживается в [Anthropic SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview)
* Системные сообщения и сообщения разработчика поднимаются и объединяются в поле верхнего уровня `system`, где бы они ни находились в разговоре. Чтобы добавить системные инструкции в середине разговора, используйте [системные сообщения в середине разговора](https://platform.claude.com/docs/ru/build-with-claude/mid-conversation-system-messages) в нативном Claude API.
Большинство неподдерживаемых полей молча игнорируются, а не вызывают ошибки. Все они задокументированы в следующих разделах.
### Соображения о качестве вывода
Если вы много работали над настройкой вашей подсказки, скорее всего, она хорошо настроена именно под OpenAI. Рассмотрите возможность её переработки для Claude с помощью [руководства по лучшим практикам составления подсказок](https://platform.claude.com/docs/ru/build-with-claude/prompt-engineering/claude-prompting-best-practices).
### Поднятие системных сообщений / сообщений разработчика
Большинство входных данных OpenAI SDK напрямую соответствуют параметрам API Anthropic, но одно явное отличие — обработка системных подсказок и подсказок разработчика. В OpenAI эти два типа подсказок могут размещаться в любом месте разговора. Слой совместимости берёт все системные сообщения и сообщения разработчика и объединяет их, разделяя одним символом новой строки (`\n`). Затем эта полная строка передаётся как поле верхнего уровня `system` перед всеми сообщениями.
### Поддержка размышлений
Вы можете включить [размышления](https://platform.claude.com/docs/ru/build-with-claude/thinking), добавив параметр `thinking`. На текущих моделях размышления являются адаптивными: Claude сам определяет, когда и насколько глубоко размышлять, а на моделях Claude 5 они включены по умолчанию; вручную настраиваемые расширенные размышления являются устаревшим режимом. Хотя размышления улучшают рассуждения Claude при решении сложных задач, OpenAI SDK не возвращает размышления Claude. Для использования всех возможностей размышлений, включая [сводные размышления](https://platform.claude.com/docs/ru/build-with-claude/thinking#summarized-thinking), используйте нативный Claude API.
```python Python
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Who are you?"}],
extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)
```
```typescript TypeScript
const response = await openai.chat.completions.create({
messages: [{ role: "user", content: "Who are you?" }],
model: "claude-sonnet-4-6",
// @ts-expect-error
thinking: { type: "enabled", budget_tokens: 2000 }
});
```
```csharp C#
// В .NET SDK нет параметра extra_body, как в Python, поэтому этот пример
// передаёт параметр thinking через документированный протокольный метод SDK
// (сырое тело запроса в формате JSON).
BinaryData input = BinaryData.FromString("""
{
"model": "claude-sonnet-4-6",
"messages": [{ "role": "user", "content": "Who are you?" }],
"thinking": { "type": "enabled", "budget_tokens": 2000 }
}
""");
using BinaryContent content = BinaryContent.Create(input);
ClientResult result = chatClient.CompleteChat(content);
```
```go Go
response, err := client.Chat.Completions.New(
context.Background(),
openai.ChatCompletionNewParams{
Model: "claude-sonnet-4-6",
Messages: []openai.ChatCompletionMessageParamUnion{
openai.UserMessage("Who are you?"),
},
},
option.WithJSONSet("thinking", map[string]any{"type": "enabled", "budget_tokens": 2000}),
)
```
```java Java
ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
.model("claude-sonnet-4-6")
.addUserMessage("Who are you?")
.putAdditionalBodyProperty("thinking",
JsonValue.from(Map.of("type", "enabled", "budget_tokens", 2000)))
.build();
ChatCompletion completion = client.chat().completions().create(params);
```
У OpenAI нет официального SDK для PHP. Чтобы использовать Claude из PHP, используйте вместо этого [Claude SDK для PHP](https://platform.claude.com/docs/ru/cli-sdks-libraries/sdks/php).
```ruby Ruby
response = openai.chat.completions.create(
model: "claude-sonnet-4-6",
messages: [{role: "user", content: "Who are you?"}],
request_options: {extra_body: {thinking: {type: "enabled", budget_tokens: 2000}}}
)
```
## Ограничения скорости
Ограничения скорости соответствуют [стандартным ограничениям](https://platform.claude.com/docs/ru/api/rate-limits) Anthropic для конечной точки `/v1/messages`.
## Подробная информация о поддержке OpenAI-совместимого API
### Поля запроса
#### Простые поля
| Поле | Статус поддержки |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `model` | Используйте названия моделей Claude |
| `max_tokens` | Полностью поддерживается |
| `max_completion_tokens` | Полностью поддерживается |
| `stream` | Полностью поддерживается |
| `stream_options` | Полностью поддерживается |
| `top_p` | Передаётся модели. Модели Claude 4.7 и более поздние, а также Claude Mythos Preview возвращают ошибку 400 для любого значения, кроме `0.99` (значение по умолчанию), поэтому не указывайте его. Запрос, в котором заданы и `temperature`, и `top_p`, также возвращает ошибку 400. См. [Работа с сообщениями](https://platform.claude.com/docs/ru/build-with-claude/working-with-messages). |
| `parallel_tool_calls` | Полностью поддерживается |
| `stop` | Работают все стоп-последовательности, не состоящие из пробельных символов |
| `temperature` | От 0 до 1 (включительно). Значения больше 1 ограничиваются значением 1. На моделях Claude 4.7 и более поздних, а также Claude Mythos Preview любое значение ниже 1 возвращает ошибку 400, поэтому не указывайте его. См. [Работа с сообщениями](https://platform.claude.com/docs/ru/build-with-claude/working-with-messages). |
| `n` | Должно быть равно ровно 1 |
| `logprobs` | Игнорируется |
| `metadata` | Игнорируется |
| `response_format` | Игнорируется. Для вывода в формате JSON используйте [структурированные выводы](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs) с нативным Claude API |
| `prediction` | Игнорируется |
| `presence_penalty` | Игнорируется |
| `frequency_penalty` | Игнорируется |
| `seed` | Игнорируется |
| `service_tier` | Игнорируется |
| `audio` | Игнорируется |
| `logit_bias` | Игнорируется |
| `store` | Игнорируется |
| `user` | Игнорируется |
| `modalities` | Игнорируется |
| `top_logprobs` | Игнорируется |
| `reasoning_effort` | Игнорируется |
#### Поля `tools` / `functions`
Поля `tools[n].function`
| Поле | Статус поддержки |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Полностью поддерживается |
| `description` | Полностью поддерживается |
| `parameters` | Полностью поддерживается |
| `strict` | Игнорируется. Используйте [структурированные выводы](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs) с нативным Claude API для строгой валидации схемы |
Поля `functions[n]`
OpenAI объявила поле `functions` устаревшим и предлагает вместо него использовать `tools`.
| Поле | Статус поддержки |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Полностью поддерживается |
| `description` | Полностью поддерживается |
| `parameters` | Полностью поддерживается |
| `strict` | Игнорируется. Используйте [структурированные выводы](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs) с нативным Claude API для строгой валидации схемы |
#### Поля массива `messages`
Поля для `messages[n].role == "developer"`
Сообщения разработчика поднимаются в начало разговора как часть начального системного сообщения
| Поле | Статус поддержки |
| --------- | ---------------------------------------- |
| `content` | Полностью поддерживается, но поднимается |
| `name` | Игнорируется |
Поля для `messages[n].role == "system"`
Системные сообщения поднимаются в начало разговора как часть начального системного сообщения
| Поле | Статус поддержки |
| --------- | ---------------------------------------- |
| `content` | Полностью поддерживается, но поднимается |
| `name` | Игнорируется |
Поля для `messages[n].role == "user"`
| Поле | Вариант | Подполе | Статус поддержки |
| --------- | -------------------------------- | -------- | ------------------------ |
| `content` | `string` | | Полностью поддерживается |
| | `array`, `type == "text"` | | Полностью поддерживается |
| | `array`, `type == "image_url"` | `url` | Полностью поддерживается |
| | | `detail` | Игнорируется |
| | `array`, `type == "input_audio"` | | Игнорируется |
| | `array`, `type == "file"` | | Игнорируется |
| `name` | | | Игнорируется |
Поля для `messages[n].role == "assistant"`
| Поле | Вариант | Статус поддержки |
| --------------- | ---------------------------- | ------------------------ |
| `content` | `string` | Полностью поддерживается |
| | `array`, `type == "text"` | Полностью поддерживается |
| | `array`, `type == "refusal"` | Игнорируется |
| `tool_calls` | | Полностью поддерживается |
| `function_call` | | Полностью поддерживается |
| `audio` | | Игнорируется |
| `refusal` | | Игнорируется |
Поля для `messages[n].role == "tool"`
| Поле | Вариант | Статус поддержки |
| -------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | `string` | Полностью поддерживается |
| | `array`, `type == "text"` | Полностью поддерживается |
| `tool_call_id` | | Полностью поддерживается |
| `tool_choice` | | Поддерживается. Значения `"required"` и значения с именем функции принудительно вызывают инструмент; Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.1 и Claude Mythos 5.1 не поддерживают принудительное использование инструментов и возвращают ошибку, поэтому на этих моделях используйте `"auto"`. См. [Принудительное использование инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/define-tools#forcing-tool-use). |
| `name` | | Игнорируется |
Поля для `messages[n].role == "function"`
| Поле | Вариант | Статус поддержки |
| ------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | `string` | Полностью поддерживается |
| | `array`, `type == "text"` | Полностью поддерживается |
| `tool_choice` | | Поддерживается. Значения `"required"` и значения с именем функции принудительно вызывают инструмент; Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.1 и Claude Mythos 5.1 не поддерживают принудительное использование инструментов и возвращают ошибку, поэтому на этих моделях используйте `"auto"`. См. [Принудительное использование инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/define-tools#forcing-tool-use). |
| `name` | | Игнорируется |
### Поля ответа
| Поле | Статус поддержки |
| --------------------------------- | -------------------------- |
| `id` | Полностью поддерживается |
| `choices[]` | Всегда будет иметь длину 1 |
| `choices[].finish_reason` | Полностью поддерживается |
| `choices[].index` | Полностью поддерживается |
| `choices[].message.role` | Полностью поддерживается |
| `choices[].message.content` | Полностью поддерживается |
| `choices[].message.tool_calls` | Полностью поддерживается |
| `object` | Полностью поддерживается |
| `created` | Полностью поддерживается |
| `model` | Полностью поддерживается |
| `finish_reason` | Полностью поддерживается |
| `content` | Полностью поддерживается |
| `usage.completion_tokens` | Полностью поддерживается |
| `usage.prompt_tokens` | Полностью поддерживается |
| `usage.total_tokens` | Полностью поддерживается |
| `usage.completion_tokens_details` | Всегда пусто |
| `usage.prompt_tokens_details` | Всегда пусто |
| `choices[].message.refusal` | Всегда пусто |
| `choices[].message.audio` | Всегда пусто |
| `logprobs` | Всегда пусто |
| `service_tier` | Всегда пусто |
| `system_fingerprint` | Всегда пусто |
### Совместимость сообщений об ошибках
Слой совместимости поддерживает форматы ошибок, согласованные с OpenAI API. Однако подробные сообщения об ошибках не будут эквивалентны. Используйте сообщения об ошибках только для логирования и отладки.
### Совместимость заголовков
Хотя OpenAI SDK автоматически управляет заголовками, вот полный список заголовков, поддерживаемых Claude API, для разработчиков, которым необходимо работать с ними напрямую.
| Заголовок | Статус поддержки |
| -------------------------------- | ------------------------ |
| `x-ratelimit-limit-requests` | Полностью поддерживается |
| `x-ratelimit-limit-tokens` | Полностью поддерживается |
| `x-ratelimit-remaining-requests` | Полностью поддерживается |
| `x-ratelimit-remaining-tokens` | Полностью поддерживается |
| `x-ratelimit-reset-requests` | Полностью поддерживается |
| `x-ratelimit-reset-tokens` | Полностью поддерживается |
| `retry-after` | Полностью поддерживается |
| `request-id` | Полностью поддерживается |
| `openai-version` | Всегда `2020-10-01` |
| `authorization` | Полностью поддерживается |
| `openai-processing-ms` | Всегда пусто |