AIRI 接入 Anthropic ClaudeAPI Key 配置、内置模型列表与 Ping 校验全指南【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi本篇技术指南讲解在 AIRI 中配置 Anthropic 服务商、接入 Claude 系列聊天模型的完整流程覆盖 API Key 的创建与安全、设置面板中的基础配置项、Ping API 校验机制以及常见故障排查。读完本文你将能够在 AIRI 的意识模块中接入 Claude Haiku / Sonnet / Opus 模型并理解配置背后的 provider 实现原理与浏览器端限制。Anthropic 服务商在 AIRI 中的定位Anthropic 是 AIRI 内置的云服务商之一用于让 AIRI 使用 Claude 聊天模型。它与 OpenAI、DeepSeek、Google Gemini 等服务商并列注册在 provider 注册表中见 providers/index.ts同属于意识/聊天consciousness / chat能力的可选后端。在 AIRI 中使用 Anthropic 有两个显著特点仅需 API Key 即可开始AIRI 已内置 Anthropic 的 API 地址与模型列表无需手动填写 Base URL 或模型 ID 就能开始使用任务类型为 chatprovider 定义中tasks: [chat]见 anthropic/index.ts表明它专门服务于聊天/意识对话链路。在 stage-ui 的服务商属性表中Anthropic 被标记为付费云服务paidCloud与本地推理服务商如 Ollama、LM Studio形成区分。第一步创建 Anthropic API Key在开始配置前需要先拥有一个可用的 Anthropic API Key打开并登录 Anthropic 控制台创建 API Key并确认账户已开通 API 使用权限为密钥设置适当的名称、有效期和额度限制复制密钥并妥善保存。::: warning API Key 安全 不要将 API Key 提交到仓库、放入截图或发送给他人。密钥泄露后请立即在 Anthropic 控制台撤销它并创建新密钥。 :::从源码角度apiKey是 Anthropic 配置中唯一必填的字段provider 的配置 schema 将apiKey定义为必填字符串校验器在配置校验阶段会执行apiKey.trim()判空未填写时直接报错 API key is required.见 openai-compatible.ts。此外输入框在 UI 层被声明为type: password见 anthropic/index.ts确保密钥不会被明文显示。第二步在 AIRI 中配置打开设置 → 服务商 → 聊天 → Anthropic按以下步骤操作将 API Key 粘贴到基础设置Base Settings中保留默认 Base URLhttps://api.anthropic.com/v1/。配置字段说明Anthropic provider 的配置结构在源码中定义如下见 anthropic/index.tsconst anthropicConfigSchema z.object({ apiKey: z.string(API Key), // 必填 baseUrl: z.string(Base URL).optional() .default(https://api.anthropic.com/v1/), // 可选默认官方地址 })字段必填默认值说明apiKey是无Anthropic 平台生成的密钥UI 中以密码框展示baseUrl否https://api.anthropic.com/v1/API 基础地址一般保持默认即可baseUrl之所以可选且带默认值是因为 AIRI 通过zod的.default()在运行时补齐默认地址再传入createChatProvider与createModelProvider构建推理客户端见 anthropic/index.ts。若你使用代理中转 Anthropic API也可在此覆盖该地址。底层调用链请求如何被发出当配置保存后AIRI 通过createAnthropic(apiKey, baseURL)合并聊天与模型两个 provider并在所有请求中注入一个特殊请求头anthropic-dangerous-direct-browser-access: true该请求头由 Anthropic 官方要求的浏览器直连标识createAnthropic中的包装 fetch 会兼容Headers数组与Headers对象两种形式进行注入见 anthropic/index.ts。同时校验器也会携带同一请求头发起验证请求见 openai-compatible.ts。第三步验证配置完成填写后通过两步验证配置是否生效Ping API点击此按钮测试网络是否连通以及 API Key 是否填写正确选择模型测试成功后点击此处选择你想要使用的具体模型。Ping API 到底做了什么Ping API 并非简单的网络探测它实际执行两项校验见 anthropic/index.ts 与 openai-compatible.tsConnectivity连通性检查向${baseUrl}/models发起带Authorization: Bearer apiKey的 GET 请求10 秒超时HTTP 5xx 视为失败ChatCompletions聊天补全检查选择一个校验模型发送一条内容为ping的极短用户消息并携带max_tokens: 16的最小输出上限验证真实聊天链路可用。校验结果带有缓存与互斥锁Mutex避免同一配置在短时间内被重复探测见 openai-compatible.ts。内置模型列表测试成功后即可选择模型。Anthropic 的模型列表由 AIRI 内置维护见 anthropic/index.ts当前内置三个模型模型 ID显示名称官方定位claude-haiku-4-5-20251001Claude Haiku 4.5最快模型接近前沿水平的智能claude-sonnet-4-5-20250929Claude Sonnet 4.5面向复杂 Agent 与编码的最聪明模型claude-opus-4-1-20250805Claude Opus 4.1专精推理任务的顶级模型正因为模型列表由extraMethods.listModels静态返回所以你无需手动输入模型 ID当需要最新的模型时通常先更新 AIRI 获取新版本内置列表即可。排查指南Ping API 失败Ping API 会检查网络连通性并发送一条很短的聊天请求。若失败请按顺序确认API Key 是否可用重新核对密钥是否完整复制、是否已过期或被撤销账户是否有额度确认账户已开通 API 使用权限且配额未耗尽网络能否访问 Anthropic API检查网络环境是否能连通api.anthropic.com包括是否存在代理、防火墙或地域限制。模型选择器没有显示预期模型先更新 AIRI 到最新版本获取最新内置模型列表若仍需特定模型可以在意识页面手动输入服务商提供的精确模型 ID。浏览器环境下的 CORS 限制这是一个值得注意的实现事实虽然 Anthropic 最近宣布正在提供对 OpenAI SDK 兼容性的 Beta 版支持但由于其实现细节与 OpenAI SDK 存在不一致目前该 provider 无法直接在浏览器中运行见 i18n 设置文案。如果你确实需要在浏览器场景使用 Anthropic需要部署一个专用的代理后端例如在 Serverless 平台上运行的 Serverless Function或者借助其他绕过 CORS 限制的服务来转发请求。因此在桌面端Electron等非浏览器运行环境中使用 Anthropic 是顺畅的而在纯 Web 端使用时需提前规划代理方案。总结在 AIRI 中接入 Anthropic 的核心路径非常简洁创建并保管好 API Key → 在设置 → 服务商 → 聊天 → Anthropic中粘贴密钥并保留默认 Base URL → 通过 Ping API 验证 → 选择内置的 Claude 模型。其底层由 provider-inference 包中的 provider 定义、anthropic-dangerous-direct-browser-access请求头注入以及连通性 聊天补全双重校验器共同支撑。遇到问题时优先检查密钥有效性、账户额度与网络连通性并留意浏览器端 CORS 的代理需求。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考