--- title: Encabezados beta url: https://platform.claude.com/docs/es/api/beta-headers description: Accede a funciones experimentales antes de que formen parte de la API estándar con el encabezado `anthropic-beta` o el parámetro `betas` del SDK. --- Los "beta headers" (encabezados beta) te permiten acceder a funciones experimentales y nuevas capacidades de los modelos antes de que formen parte de la API estándar. El [SDK de cliente](https://platform.claude.com/docs/es/cli-sdks-libraries/overview) expone un espacio de nombres `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) para llamar a la API con funciones beta habilitadas. ## Cómo usar los encabezados beta Para acceder a las funciones beta, incluye el encabezado `anthropic-beta` en tus solicitudes a la API: ```http POST /v1/messages x-api-key: YOUR_API_KEY anthropic-version: 2023-06-01 anthropic-beta: BETA_FEATURE_NAME content-type: application/json ``` La documentación de cada función indica el nombre exacto de la beta que debes enviar. La [descripción general de la API](https://platform.claude.com/docs/es/api/overview) enumera las API que actualmente están en beta. Los siguientes ejemplos muestran la misma solicitud con cURL, la CLI `ant` y el SDK, usando como ejemplo la beta de [edición de contexto](https://platform.claude.com/docs/es/build-with-claude/context-editing). El SDK recibe los nombres beta mediante `betas` (csharp, go: `Betas`; java: `.addBeta()`) y envía el encabezado `anthropic-beta` por ti: ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: context-management-2025-06-27" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }' ``` ```bash CLI ant beta:messages create \ --beta context-management-2025-06-27 \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}' ``` ```python Python client = Anthropic() response = client.beta.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Hello, Claude"}], betas=["context-management-2025-06-27"], ) print(response.content) ``` ```typescript TypeScript const client = new Anthropic(); const msg = await client.beta.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "Hello, Claude" }], betas: ["context-management-2025-06-27"] }); console.log(msg.content); ``` ```csharp C# var client = new AnthropicClient(); var message = await client.Beta.Messages.Create( new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 1024, Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], Betas = ["context-management-2025-06-27"], } ); Console.WriteLine(string.Join("\n", message.Content)); ``` ```go Go client := anthropic.NewClient() message, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 1024, Messages: []anthropic.BetaMessageParam{ anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude")), }, Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBetaContextManagement2025_06_27}, }) if err != nil { panic(err) } fmt.Printf("%+v\n", message.Content) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(1024) .addUserMessage("Hello, Claude") .addBeta(AnthropicBeta.CONTEXT_MANAGEMENT_2025_06_27) .build(); BetaMessage message = client.beta().messages().create(params); System.out.println(message.content()); ``` ```php PHP $client = new Client(); $message = $client->beta->messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', betas: ['context-management-2025-06-27'], ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new message = client.beta.messages.create( model: "claude-opus-5-5", max_tokens: 1024, messages: [{role: "user", content: "Hello, Claude"}], betas: ["context-management-2025-06-27"] ) puts(message.content) ``` Las funciones beta son experimentales y pueden: * Tener cambios incompatibles con previo aviso * Quedar obsoletas o ser eliminadas * Tener límites de velocidad o precios diferentes * No estar disponibles en todas las regiones ### Múltiples funciones beta Para usar múltiples funciones beta en una sola solicitud, incluye todos los nombres de las funciones en el encabezado separados por comas: ```http anthropic-beta: feature1,feature2,feature3 ``` También puedes enviar el encabezado `anthropic-beta` más de una vez en la misma solicitud. La Claude API lee cada encabezado `anthropic-beta`, por lo que lo siguiente es equivalente al ejemplo anterior: ```http anthropic-beta: feature1 anthropic-beta: feature2 anthropic-beta: feature3 ``` Con el SDK, enumera cada función (por ejemplo, `betas=["feature1", "feature2"]` (typescript, ruby: `betas: ["feature1", "feature2"]`; php: `betas: ['feature1', 'feature2']`; csharp: `Betas = ["feature1", "feature2"]`; go: `Betas: []anthropic.AnthropicBeta{"feature1", "feature2"}`; java: `.addBeta("feature1").addBeta("feature2")`)). Con la CLI, pasa un solo indicador `--beta` con los nombres de las funciones separados por comas (por ejemplo, `--beta feature1,feature2`). También puedes repetir el indicador (por ejemplo, `--beta feature1 --beta feature2`). ### Funciones beta en otras plataformas Los nombres beta son los mismos en todas las plataformas que los aceptan, pero no todas las plataformas aceptan todas las betas. [Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws), [Microsoft Foundry](https://platform.claude.com/docs/es/build-with-claude/claude-in-microsoft-foundry) y [Google Cloud](https://platform.claude.com/docs/es/build-with-claude/claude-on-vertex-ai) reciben los nombres beta en el encabezado `anthropic-beta`, al igual que la Claude API. Para enviar varias betas, coloca sus nombres en un solo encabezado, separados por comas: Google Cloud lee solo un encabezado `anthropic-beta` e ignora el resto, por lo que las betas de los demás no surten efecto. En Amazon Bedrock, dónde van los nombres beta depende de la API que llames: * [Claude en Amazon Bedrock](https://platform.claude.com/docs/es/build-with-claude/claude-in-amazon-bedrock) (endpoints `bedrock-mantle`) los recibe en el encabezado `anthropic-beta`. * La [API InvokeModel](https://platform.claude.com/docs/es/build-with-claude/claude-on-amazon-bedrock-legacy) los lee del cuerpo de la solicitud, no de un encabezado. Enuméralos en el arreglo `anthropic_beta` del cuerpo, un nombre por elemento, por ejemplo `"anthropic_beta": ["feature1", "feature2"]`. ### Encabezados específicos de endpoint Algunas API beta están limitadas a endpoints específicos y requieren un encabezado beta específico de la función en cada solicitud: | Endpoints | Encabezado beta | | ------------------------------------------------ | --------------------------- | | `/v1/agents`, `/v1/sessions`, `/v1/environments` | `managed-agents-2026-04-01` | | `/v1/tunnels` | `mcp-tunnels-2026-06-22` | | `/v1/memory_stores` y subrecursos | `agent-memory-2026-07-22` | El espacio de nombres `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) del SDK agrega estos encabezados automáticamente. Agrégalos tú mismo solo cuando hagas solicitudes HTTP sin procesar. Consulta la [descripción general de Managed Agents](https://platform.claude.com/docs/es/managed-agents/overview), [Uso de la memoria de agentes](https://platform.claude.com/docs/es/managed-agents/memory) y la [referencia de túneles MCP](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/reference#tunnels-api) para obtener más detalles. Los encabezados específicos de endpoint que se aplican al mismo endpoint no siempre se pueden combinar. En los endpoints de almacenes de memoria, `agent-memory-2026-07-22` reemplaza a `managed-agents-2026-04-01`: enviar ambos en la misma solicitud devuelve un error `400`. El SDK envía automáticamente el encabezado correcto para cada endpoint. ### Convenciones de nomenclatura de versiones Los nombres de las funciones beta normalmente siguen el patrón `feature-name-YYYY-MM-DD`, donde la fecha indica cuándo se lanzó la beta. Usa siempre el nombre exacto de la función beta tal como está documentado. ## Manejo de errores Si usas un nombre de beta no válido, o una beta a la que tu organización no tiene acceso, recibirás una respuesta de error `400`: ```json Output { "type": "error", "error": { "type": "invalid_request_error", "message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header." }, "request_id": "req_011CcnGfC9fELffo2EALu4Wd" } ``` ## Obtener ayuda Para conocer las actualizaciones de las funciones beta, consulta las [notas de la versión](https://platform.claude.com/docs/es/release-notes/overview). Para obtener ayuda con problemas en producción, contacta a [soporte](https://support.claude.com/). ## Próximos pasos Comprende los códigos de estado HTTP, la estructura de las respuestas de error y los ID de solicitud que devuelve la Claude API, y maneja los errores con las excepciones tipadas del SDK. Explora las funciones de la Claude API, incluidas las API que están actualmente en beta.