---
title: Kompatibilitas OpenAI SDK
url: https://platform.claude.com/docs/id/cli-sdks-libraries/libraries/openai-sdk
description: Anthropic menyediakan lapisan kompatibilitas yang memungkinkan Anda menggunakan OpenAI SDK untuk menguji Claude API. Dengan beberapa perubahan kode, Anda dapat dengan cepat mengevaluasi kemampuan model Anthropic.
---
Lapisan kompatibilitas ini terutama ditujukan untuk menguji dan membandingkan kemampuan model, dan tidak dianggap sebagai solusi jangka panjang atau siap produksi untuk sebagian besar kasus penggunaan. Meskipun lapisan ini dimaksudkan untuk tetap berfungsi penuh dan tidak mengalami perubahan yang merusak, prioritasnya adalah keandalan dan efektivitas [Claude API](https://platform.claude.com/docs/id/api/overview).
Untuk informasi lebih lanjut tentang keterbatasan kompatibilitas yang diketahui, lihat [Keterbatasan penting kompatibilitas OpenAI](https://platform.claude.com/docs/id/cli-sdks-libraries/libraries/openai-sdk#important-openai-compatibility-limitations).
Jika Anda mengalami masalah apa pun dengan fitur kompatibilitas OpenAI SDK, silakan bagikan masukan Anda melalui [formulir masukan kompatibilitas](https://forms.gle/oQV4McQNiuuNbz9n8) ini.
Untuk pengalaman terbaik dan akses ke rangkaian fitur lengkap Claude API ([pemrosesan PDF](https://platform.claude.com/docs/id/build-with-claude/pdf-support), [kutipan](https://platform.claude.com/docs/id/build-with-claude/citations), [thinking](https://platform.claude.com/docs/id/build-with-claude/thinking), dan ["prompt caching" (caching prompt)](https://platform.claude.com/docs/id/build-with-claude/prompt-caching)), gunakan [Claude API](https://platform.claude.com/docs/id/api/overview) native.
## Memulai dengan OpenAI SDK
Untuk menggunakan fitur kompatibilitas OpenAI SDK, Anda perlu:
1. Menggunakan OpenAI SDK resmi
2. Mengubah hal-hal berikut
* Perbarui base URL Anda agar mengarah ke Claude API
* Ganti "API key" (kunci API) Anda dengan [kunci API Claude](https://platform.claude.com/settings/keys)
* Jika kunci Anda adalah [kunci personal atau kunci akun layanan](https://platform.claude.com/docs/id/manage-claude/authentication#key-types) dengan akses ke beberapa workspace, kirimkan juga header `anthropic-workspace-id` pada setiap permintaan (misalnya, `default_headers` di Python SDK atau `defaultHeaders` di TypeScript); lihat [Memilih workspace](https://platform.claude.com/docs/id/manage-claude/authentication#select-a-workspace)
* Perbarui nama model Anda untuk menggunakan [model Claude](https://platform.claude.com/docs/id/models/overview)
3. Tinjau bagian-bagian berikut untuk mengetahui fitur apa saja yang didukung
### Contoh mulai cepat
```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 tidak memiliki SDK PHP resmi. Untuk menggunakan Claude dari PHP, gunakan [Claude SDK untuk PHP](https://platform.claude.com/docs/id/cli-sdks-libraries/sdks/php) sebagai gantinya.
```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
```
## Keterbatasan penting kompatibilitas OpenAI
### Perilaku API
Berikut adalah perbedaan paling substansial dibandingkan menggunakan OpenAI:
* Parameter `strict` untuk function calling diabaikan, yang berarti JSON "tool use" (penggunaan alat) tidak dijamin mengikuti skema yang diberikan. Untuk kesesuaian skema yang terjamin, gunakan [Claude API native dengan Structured Outputs](https://platform.claude.com/docs/id/build-with-claude/structured-outputs).
* Input audio tidak didukung; input tersebut akan diabaikan dan dihapus dari input
* Caching prompt tidak didukung, tetapi didukung di [Anthropic SDK](https://platform.claude.com/docs/id/cli-sdks-libraries/overview)
* Pesan system/developer diangkat (hoisted) dan digabungkan ke dalam field `system` tingkat atas, di mana pun pesan tersebut muncul dalam percakapan. Untuk menambahkan instruksi sistem di tengah percakapan, gunakan [pesan sistem di tengah percakapan](https://platform.claude.com/docs/id/build-with-claude/mid-conversation-system-messages) di Claude API native.
Sebagian besar field yang tidak didukung diabaikan secara diam-diam alih-alih menghasilkan error. Semuanya didokumentasikan di bagian-bagian berikut.
### Pertimbangan kualitas output
Jika Anda telah melakukan banyak penyesuaian pada prompt Anda, kemungkinan besar prompt tersebut telah disetel dengan baik khusus untuk OpenAI. Pertimbangkan untuk mengerjakannya ulang untuk Claude menggunakan [panduan praktik terbaik prompting](https://platform.claude.com/docs/id/build-with-claude/prompt-engineering/claude-prompting-best-practices).
### Pengangkatan pesan system / developer
Sebagian besar input ke OpenAI SDK dipetakan secara langsung ke parameter API Anthropic, tetapi satu perbedaan yang jelas adalah penanganan prompt system / developer. Kedua prompt ini dapat ditempatkan di sepanjang percakapan chat melalui OpenAI. Lapisan kompatibilitas mengambil semua pesan system/developer dan menggabungkannya dengan satu baris baru (`\n`) di antaranya. String lengkap ini kemudian diberikan sebagai field `system` tingkat atas, sebelum setiap pesan.
### Dukungan thinking
Anda dapat mengaktifkan [thinking](https://platform.claude.com/docs/id/build-with-claude/thinking) dengan menambahkan parameter `thinking`. Pada model saat ini, thinking bersifat adaptif, dengan Claude menentukan kapan dan seberapa dalam untuk berpikir, dan pada model Claude 5 fitur ini aktif secara default; "extended thinking" (pemikiran diperpanjang) yang dikonfigurasi secara manual adalah mode lama (legacy). Meskipun thinking meningkatkan penalaran Claude untuk tugas-tugas kompleks, OpenAI SDK tidak mengembalikan thinking Claude. Untuk fitur thinking lengkap, termasuk [thinking yang diringkas](https://platform.claude.com/docs/id/build-with-claude/thinking#summarized-thinking), gunakan Claude API native.
```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#
// SDK .NET tidak memiliki parameter extra_body seperti Python, jadi contoh ini
// mengirim parameter thinking dengan metode protokol terdokumentasi milik SDK
// (body permintaan JSON mentah).
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 tidak memiliki SDK PHP resmi. Untuk menggunakan Claude dari PHP, gunakan [Claude SDK untuk PHP](https://platform.claude.com/docs/id/cli-sdks-libraries/sdks/php) sebagai gantinya.
```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}}}
)
```
## Batas laju
"Rate limit" (batas laju) mengikuti [batas standar](https://platform.claude.com/docs/id/api/rate-limits) Anthropic untuk endpoint `/v1/messages`.
## Dukungan API kompatibel OpenAI secara terperinci
### Field permintaan
#### Field sederhana
| Field | Status dukungan |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | Gunakan nama model Claude |
| `max_tokens` | Didukung penuh |
| `max_completion_tokens` | Didukung penuh |
| `stream` | Didukung penuh |
| `stream_options` | Didukung penuh |
| `top_p` | Diteruskan ke model. Model Claude 4.7 dan yang lebih baru serta Claude Mythos Preview mengembalikan error 400 untuk nilai apa pun selain `0.99`, yaitu nilai default, jadi hilangkan parameter ini. Permintaan yang menetapkan `temperature` dan `top_p` sekaligus juga mengembalikan error 400. Lihat [Bekerja dengan pesan](https://platform.claude.com/docs/id/build-with-claude/working-with-messages). |
| `parallel_tool_calls` | Didukung penuh |
| `stop` | Semua stop sequence non-whitespace berfungsi |
| `temperature` | Antara 0 dan 1 (inklusif). Nilai lebih besar dari 1 dibatasi menjadi 1. Pada model Claude 4.7 dan yang lebih baru serta Claude Mythos Preview, nilai apa pun di bawah 1 mengembalikan error 400, jadi hilangkan parameter ini. Lihat [Bekerja dengan pesan](https://platform.claude.com/docs/id/build-with-claude/working-with-messages). |
| `n` | Harus tepat 1 |
| `logprobs` | Diabaikan |
| `metadata` | Diabaikan |
| `response_format` | Diabaikan. Untuk output JSON, gunakan [Structured Outputs](https://platform.claude.com/docs/id/build-with-claude/structured-outputs) dengan Claude API native |
| `prediction` | Diabaikan |
| `presence_penalty` | Diabaikan |
| `frequency_penalty` | Diabaikan |
| `seed` | Diabaikan |
| `service_tier` | Diabaikan |
| `audio` | Diabaikan |
| `logit_bias` | Diabaikan |
| `store` | Diabaikan |
| `user` | Diabaikan |
| `modalities` | Diabaikan |
| `top_logprobs` | Diabaikan |
| `reasoning_effort` | Diabaikan |
#### Field `tools` / `functions`
Field `tools[n].function`
| Field | Status dukungan |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Didukung penuh |
| `description` | Didukung penuh |
| `parameters` | Didukung penuh |
| `strict` | Diabaikan. Gunakan [Structured Outputs](https://platform.claude.com/docs/id/build-with-claude/structured-outputs) dengan Claude API native untuk validasi skema yang ketat |
Field `functions[n]`
OpenAI telah menghentikan (deprecated) field `functions` dan menyarankan untuk menggunakan `tools` sebagai gantinya.
| Field | Status dukungan |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | Didukung penuh |
| `description` | Didukung penuh |
| `parameters` | Didukung penuh |
| `strict` | Diabaikan. Gunakan [Structured Outputs](https://platform.claude.com/docs/id/build-with-claude/structured-outputs) dengan Claude API native untuk validasi skema yang ketat |
#### Field array `messages`
Field untuk `messages[n].role == "developer"`
Pesan developer diangkat ke awal percakapan sebagai bagian dari pesan sistem awal
| Field | Status dukungan |
| --------- | ------------------------------- |
| `content` | Didukung penuh, tetapi diangkat |
| `name` | Diabaikan |
Field untuk `messages[n].role == "system"`
Pesan system diangkat ke awal percakapan sebagai bagian dari pesan sistem awal
| Field | Status dukungan |
| --------- | ------------------------------- |
| `content` | Didukung penuh, tetapi diangkat |
| `name` | Diabaikan |
Field untuk `messages[n].role == "user"`
| Field | Varian | Sub-field | Status dukungan |
| --------- | -------------------------------- | --------- | --------------- |
| `content` | `string` | | Didukung penuh |
| | `array`, `type == "text"` | | Didukung penuh |
| | `array`, `type == "image_url"` | `url` | Didukung penuh |
| | | `detail` | Diabaikan |
| | `array`, `type == "input_audio"` | | Diabaikan |
| | `array`, `type == "file"` | | Diabaikan |
| `name` | | | Diabaikan |
Field untuk `messages[n].role == "assistant"`
| Field | Varian | Status dukungan |
| --------------- | ---------------------------- | --------------- |
| `content` | `string` | Didukung penuh |
| | `array`, `type == "text"` | Didukung penuh |
| | `array`, `type == "refusal"` | Diabaikan |
| `tool_calls` | | Didukung penuh |
| `function_call` | | Didukung penuh |
| `audio` | | Diabaikan |
| `refusal` | | Diabaikan |
Field untuk `messages[n].role == "tool"`
| Field | Varian | Status dukungan |
| -------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | `string` | Didukung penuh |
| | `array`, `type == "text"` | Didukung penuh |
| `tool_call_id` | | Didukung penuh |
| `tool_choice` | | Didukung. Nilai `"required"` dan nilai fungsi bernama memaksa pemanggilan alat; Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.1, dan Claude Mythos 5.1 tidak mendukung penggunaan alat yang dipaksakan dan mengembalikan error, jadi gunakan `"auto"` pada model-model tersebut. Lihat [Memaksa penggunaan alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/define-tools#forcing-tool-use). |
| `name` | | Diabaikan |
Field untuk `messages[n].role == "function"`
| Field | Varian | Status dukungan |
| ------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | `string` | Didukung penuh |
| | `array`, `type == "text"` | Didukung penuh |
| `tool_choice` | | Didukung. Nilai `"required"` dan nilai fungsi bernama memaksa pemanggilan alat; Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5.1, dan Claude Mythos 5.1 tidak mendukung penggunaan alat yang dipaksakan dan mengembalikan error, jadi gunakan `"auto"` pada model-model tersebut. Lihat [Memaksa penggunaan alat](https://platform.claude.com/docs/id/agents-and-tools/tool-use/define-tools#forcing-tool-use). |
| `name` | | Diabaikan |
### Field respons
| Field | Status dukungan |
| --------------------------------- | ------------------------------ |
| `id` | Didukung penuh |
| `choices[]` | Akan selalu memiliki panjang 1 |
| `choices[].finish_reason` | Didukung penuh |
| `choices[].index` | Didukung penuh |
| `choices[].message.role` | Didukung penuh |
| `choices[].message.content` | Didukung penuh |
| `choices[].message.tool_calls` | Didukung penuh |
| `object` | Didukung penuh |
| `created` | Didukung penuh |
| `model` | Didukung penuh |
| `finish_reason` | Didukung penuh |
| `content` | Didukung penuh |
| `usage.completion_tokens` | Didukung penuh |
| `usage.prompt_tokens` | Didukung penuh |
| `usage.total_tokens` | Didukung penuh |
| `usage.completion_tokens_details` | Selalu kosong |
| `usage.prompt_tokens_details` | Selalu kosong |
| `choices[].message.refusal` | Selalu kosong |
| `choices[].message.audio` | Selalu kosong |
| `logprobs` | Selalu kosong |
| `service_tier` | Selalu kosong |
| `system_fingerprint` | Selalu kosong |
### Kompatibilitas pesan error
Lapisan kompatibilitas mempertahankan format error yang konsisten dengan OpenAI API. Namun, pesan error terperincinya tidak akan sama. Gunakan pesan error hanya untuk logging dan debugging.
### Kompatibilitas header
Meskipun OpenAI SDK mengelola header secara otomatis, berikut adalah daftar lengkap header yang didukung oleh Claude API bagi developer yang perlu bekerja dengannya secara langsung.
| Header | Status Dukungan |
| -------------------------------- | ------------------- |
| `x-ratelimit-limit-requests` | Didukung penuh |
| `x-ratelimit-limit-tokens` | Didukung penuh |
| `x-ratelimit-remaining-requests` | Didukung penuh |
| `x-ratelimit-remaining-tokens` | Didukung penuh |
| `x-ratelimit-reset-requests` | Didukung penuh |
| `x-ratelimit-reset-tokens` | Didukung penuh |
| `retry-after` | Didukung penuh |
| `request-id` | Didukung penuh |
| `openai-version` | Selalu `2020-10-01` |
| `authorization` | Didukung penuh |
| `openai-processing-ms` | Selalu kosong |