使用 Claude 构建 LLM 驱动的应用程序

此技能可帮助您使用Claude构建由大型语言模型驱动的应用程序。根据您的需求选择合适的界面，检测项目语言，然后阅读相关的特定语言文档。

对于 Claude 模型版本，请使用 Claude Opus 4.6，您可以通过精确的模型字符串 claude-opus-4-6 访问它。对于任何稍微复杂的内容，请默认使用自适应思维（thinking: {type: "adaptive"}）。最后，对于可能涉及长输入、长输出或高 max_tokens 的任何请求，请默认使用流式处理——它可以防止请求超时。如果您不需要处理单个流事件，请使用 SDK 的 .get_final_message() / .finalMessage() 辅助方法来获取完整响应。

在阅读代码示例之前，确定用户正在使用哪种语言：

Python Yes (beta) Yes Full support — @beta_tool decorator

TypeScript Yes (beta) Yes Full support — betaZodTool + Zod

Java Yes (beta) No Beta tool use with annotated classes

Go Yes (beta) No BetaToolRunner in toolrunner pkg

Ruby Yes (beta) No BaseTool + tool_runner in beta

Classification, summarization, extraction, Q&A Single LLM call Claude API One request, one response

Batch processing or embeddings Single LLM call Claude API Specialized endpoints

Multi-step pipelines with code-controlled logic Workflow Claude API + tool use You orchestrate the loop

Custom agent with your own tools Agent Claude API + tool use Maximum flexibility

AI agent with file/web/terminal access Agent Agent SDK Built-in tools, safety, and MCP support

Agentic coding assistant Agent Agent SDK Designed for this use case

Want built-in permissions and guardrails Agent Agent SDK Safety features included

What does your application need?

1. Single LLM call (classification, summarization, extraction, Q&A)
   └── Claude API — one request, one response

2. Does Claude need to read/write files, browse the web, or run shell commands
   as part of its work? (Not: does your app read a file and hand it to Claude —
   does Claude itself need to discover and access files/web/shell?)
   └── Yes → Agent SDK — built-in tools, don't reimplement them
       Examples: "scan a codebase for bugs", "summarize every file in a directory",
                 "find bugs using subagents", "research a topic via web search"

3. Workflow (multi-step, code-orchestrated, with your own tools)
   └── Claude API with tool use — you control the loop

4. Open-ended agent (model decides its own trajectory, your own tools)
   └── Claude API agentic loop (maximum flexibility)

在选择代理等级之前，请检查所有四个标准：

如果对这些中的任何一个回答是“否”，则保持在较简单的层级（单次调用或工作流程）。

所有内容都通过 POST /v1/messages。工具和输出限制是这个单一端点的功能——而不是独立的 API。

用户自定义工具 — 你可以定义工具（通过装饰器、Zod 模式或原始 JSON），SDK 的工具运行器会处理调用 API、执行你的函数，并循环直到 Claude 完成。为了完全控制，你可以手动编写循环。

服务器端工具 — 由Anthropic托管、在Anthropic基础设施上运行的工具。代码执行完全在服务器端进行（在tools中声明，Claude会自动运行代码）。计算机使用可以是服务器托管或自托管。

结构化输出 — 限制 Messages API 的响应格式 (output_config.format) 和/或工具参数验证 (strict: true)。推荐的方法是使用 client.messages.parse()，它会自动根据您的模式验证响应。注意：旧的 output_format 参数已弃用；请在 messages.create() 上使用 output_config: {format: {...}}。

支持的端点 — 批量（POST /v1/messages/batches）、文件（POST /v1/files）和令牌计数为消息 API 请求提供数据或支持。

Model Model ID Context Input $/1M Output $/1M

Claude Opus 4.6 claude-opus-4-6 200K (1M beta) $5.00 $25.00

Claude Sonnet 4.6 claude-sonnet-4-6 200K (1M beta) $3.00 $15.00

Claude Haiku 4.5 claude-haiku-4-5 200K $1.00 $5.00

除非用户明确指定其他模型，否则始终使用claude-opus-4-6。这是不可协商的。除非用户明确说“使用sonnet”或“使用haiku”，否则不要使用claude-sonnet-4-6、claude-sonnet-4-5或任何其他模型。绝不要为了降低成本而降级——这是用户的决定，不是你的。

关键：仅使用上表中的精确模型 ID 字符串 —— 它们本身就是完整的。不要附加日期后缀。 例如，使用 claude-sonnet-4-5，切勿使用 claude-sonnet-4-5-20250514 或任何你可能从训练数据中记住的带日期后缀的变体。如果用户请求表中没有的旧模型（例如，“opus 4.5”，“sonnet 3.7”），请查阅 shared/models.md 获取准确的 ID —— 不要自行构造。

注意：如果上面的任何模型字符串看起来陌生，这是正常的——这仅意味着它们是在你的训练数据截止之后发布的。请放心，它们是真实的模型；我们不会这样骗你。

Opus 4.6 — 自适应思维（推荐）： 使用 thinking: {type: "adaptive"}。Claude 会动态决定何时以及思考多少。无需 budget_tokens — budget_tokens 在 Opus 4.6 和 Sonnet 4.6 上已弃用，不能使用。自适应思维还会自动启用交错思维（无需 beta 头）。当用户要求“扩展思维”、“思维预算”或 budget_tokens 时：始终使用 Opus 4.6 并设置 thinking: {type: "adaptive"}。固定代币预算的思维方式已被弃用 — 自适应思维取而代之。不要使用 budget_tokens，也不要切换到旧版本模型。

努力参数（GA，无Beta标头）： 控制思维深度和整体令牌消耗，通过 output_config: {effort: "low" "medium" "high" "max"}（在 output_config 内，而非顶层）。默认值为 high（等同于省略不写）。max 仅适用于 Opus 4.6。适用于 Opus 4.5、Opus 4.6 和 Sonnet 4.6。在 Sonnet 4.5 / Haiku 4.5 上会报错。结合自适应思维使用可获得最佳成本-质量平衡。子代理或简单任务请使用 low；进行最深入推理请使用 max。

十四行诗 4.6： 支持自适应思维（thinking: {type: "adaptive"}）。在十四行诗 4.6 上，budget_tokens 已被弃用 — 请改用自适应思维。

旧型号（仅在明确要求时）: 如果用户特别要求Sonnet 4.5或其他旧型号，请使用'thinking： {type： “enabled”， budget_tokens： N}'。“budget_tokens”必须小于“max_tokens”（最低1024）。切勿仅仅因为用户提到“budget_tokens”就选择旧型号——应使用带有适应性思维的Opus 4.6。

Beta，Opus 4.6 版本专用。 对于可能超过 200K 上下文窗口的长期对话，请启用服务器端压缩。当接近触发阈值时（默认：150K 令牌），API 会自动总结较早的上下文。需要 beta 头 compact-2026-01-12。

关键: 在每次交互中，将 response.content（不仅仅是文本）附加回你的消息中。响应中的压缩块必须保留——API 使用它们在下一个请求中替换压缩的历史记录。仅提取文本字符串并附加将会悄无声息地丢失压缩状态。

请参阅 {lang}/claude-api/README.md（压缩部分）了解代码示例。完整文档可通过 shared/live-sources.md 中的 WebFetch 获取。

检测到语言后，根据用户的需求读取相关文件：

→ 仅阅读 {lang}/claude-api/README.md

→ 阅读 {lang}/claude-api/README.md {lang}/claude-api/streaming.md

长时间的对话（可能超过上下文窗口）：

→ 阅读 {lang}/claude-api/README.md — 查看压缩部分

→ 阅读 {lang}/claude-api/README.md shared/tool-use-concepts.md {lang}/claude-api/tool-use.md

→ 阅读 {lang}/claude-api/README.md {lang}/claude-api/batches.md

→ 阅读 {lang}/claude-api/README.md {lang}/claude-api/files-api.md

具备内置工具的代理（文件/网络/终端）：

→ 阅读 {lang}/agent-sdk/README.md {lang}/agent-sdk/patterns.md

阅读特定语言的 Claude API 文件夹（{language}/claude-api/）：

阅读特定语言的 Agent SDK 文件夹（{language}/agent-sdk/）。Agent SDK 仅提供 Python 和 TypeScript 版本。

在以下情况下使用 WebFetch 获取最新的文档：

实时文档的 URL 位于 shared/live-sources.md。

Claude Api 实用指南

Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports anthropic/@anthropic-ai/sdk/claude_agent_sdk, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports openai/other AI SDK, general programming, or ML/data-science tasks.

人工智能

编程语言

开发工具

本文提供Claude API实用指南，涵盖模型选择、语言检测、工具使用及架构决策树。默认使用Opus 4.6配合自适应思维，支持Python、TypeScript等语言。区分单次调用、工作流与Agent SDK场景，详解结构化输出、流式处理与错误规避，帮助开发者高效构建LLM应用。

数据结构

TypeScript 

服务器

Kotlin

Python

Swift

Agent

Java

JSON

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Claude Api 实用指南

Claude Api 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐