AIRI 接入 Anthropic ClaudeAPI Key 配置、内置模型列表与连接校验原理【免费下载链接】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/airiAnthropic 提供者让 AIRI 能够直接调用 Claude 聊天模型只需填入 API Key即可通过内置的模型目录在意识Consciousness模块中选择 Claude Haiku / Sonnet / Opus 系列模型无需手动填写模型 ID。本文以 docs/content/ko/docs/manual/config/providers/consciousness/anthropic.md 为骨架结合 AIRI 源码中 Anthropic 提供者的注册、校验与模型加载实现完整讲解从 Key 申请、界面配置到校验原理与排障的全流程。Anthropic 提供者在 AIRI 中的定位AIRI 将聊天能力归入意识模块Consciousness提供者Provider则是连接外部模型服务的统一抽象层。Anthropic 提供者直接复用官方 APIhttps://api.anthropic.com/v1/与用户自己的 API Key属于标准的云服务付费型提供者——在 packages/stage-ui/src/libs/providers/attributes.ts 的目录属性表中anthropic被标记为paidCloud付费、云端部署。与通用 OpenAI 兼容端点不同Anthropic 的模型目录内置于 AIRI 源码见下文内置模型列表小节因此首次配置时既不需要填 Base URL也不需要输入模型 ID起点门槛被降到最低只要你有可用的 Claude API Key 就能跑起来。第一步生成 Anthropic API Key在接入 AIRI 之前需要先到 Anthropic 控制台的 API Keys 页面完成以下操作登录 Anthropic 控制台进入 API Keys 设置页确认账号已开通 API 访问权限创建 Key 时设置合适的名称、有效期与使用量上限usage limit便于后续追踪与成本控制复制生成的 Key 并妥善保管。安全警告API Key 属于高敏感凭据。不要把它提交进代码仓库、不要出现在截图里、也不要分享给任何人。一旦怀疑泄露应立即在 Anthropic 控制台作废该 Key 并重新生成。AIRI 的提供者配置界面对 apiKey 字段使用type: password的密码输入控件见 anthropic/index.ts从 UI 层面降低误截屏、误展示的风险。第二步在 AIRI 中添加 Anthropic 提供者打开 AIRI 设置界面按如下路径进入配置页设置 → 提供者 → 聊天Chat→ Anthropic填入 API Key 即可。配置表单对应源码中的 Zod 校验模式anthropic/index.ts字段必填默认值说明apiKey是—Anthropic API Key密码输入框展示baseUrl否https://api.anthropic.com/v1/API 端点一般保持默认即可Base URL 字段带有默认值https://api.anthropic.com/v1/这也是createAnthropic()工厂函数的第二参数默认值anthropic/index.ts。绝大多数用户无需修改只有在需要走代理或网关如自建中转时才需要覆盖它。源码视角Anthropic 提供者注册实现在 AIRI 中每个提供者都是一个ProviderDefinition。Anthropic 的注册实现位于 packages/stage-ui/src/libs/providers/providers/anthropic/index.ts并通过 providers/index.ts 的import ./anthropic挂载进注册表标识与排序id: anthropicorder: 6tasks: [chat]表示它仅提供聊天任务外观图标使用 Claude 品牌图标i-lobe-icons:claude名称与描述支持 i18n 本地化中文文案见 packages/i18n/src/locales/zh-Hans/settings.yaml客户端构建createAnthropic()通过createChatProvidercreateModelProvider组合出同时具备聊天与模型列表能力的提供者实例anthropic/index.ts。值得注意的一个细节createAnthropic包装了 fetch自动为所有请求附加anthropic-dangerous-direct-browser-access: true请求头anthropic/index.ts。从源码注释与头名可以推断这是为了让运行在浏览器/Electron 渲染进程中的 AIRI 能够直接跨域访问 Anthropic API而无需经由本地服务端转发。内置模型列表开箱即用这是 Anthropic 提供者区别于通用兼容端点的关键能力它通过extraMethods.listModels直接返回一份静态模型目录anthropic/index.ts因此无需在启动时填写模型 ID模型 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擅长专门推理任务的卓越模型在模型加载链路中provider.ts 会优先调用definition.extraMethods.listModels只有提供者没有实现该扩展方法时才退回通用的/models列表接口——这印证了 Anthropic 的模型选择完全由这份内置目录驱动。需要注意该目录是源码中的静态快照其内容以当前仓库版本为准Anthropic 发布新模型后需要等待 AIRI 更新内置目录详见下文问题排查。第三步配置校验ValidationAIRI 会在你编辑配置的过程中自动校验校验状态机定义在 packages/stage-ui/src/libs/providers/types.tsunconfigured未配置→validating校验中→configured有效→invalid无效→bypassed跳过。校验何时触发通过validationRequiredWhen决定只有 apiKey 去空格后非空才进入自动校验anthropic/index.ts。也就是说空 Key 不会触发无意义的请求。两层运行时校验Anthropic 复用了 OpenAI 兼容校验器validators/openai-compatible.ts启用两个检查项连接性检查Connectivity向{baseUrl}/models发送 GET 请求请求头携带Authorization: Bearer apiKey以 10 秒AbortController超时兜底openai-compatible.ts聊天补全检查ChatCompletions即界面上的Ping API真正发送一次短对话请求——调用generateText发送一条内容为ping的用户消息max_tokens设为 16openai-compatible.ts验证端到端推理通路是否可用。校验过程中同样会附加anthropic-dangerous-direct-browser-access: true头anthropic/index.ts。由于结果带缓存与互斥锁Mutex去重短时间内反复编辑配置不会产生重复的 ping 请求openai-compatible.ts。校验通过之后校验通过后点击模型选择 →按钮跳转到设置 → 模块 → 意识页面完成提供者与模型的最终选择。意识模块的选择状态由 stores/modules/consciousness.ts 管理持久化在 localStorage 键settings/consciousness/active-provider与settings/consciousness/active-model中consciousness.ts并借助 Pinia 同步实现多窗口实时一致。这里有两个值得了解的工程细节切换提供者自动清空模型因为模型 ID 属于选定提供者的目录切换提供者后旧模型 ID 会失效否则会出现上游model_not_found。该 watcher 使用flush: sync同步执行保证先设提供者、再设模型的顺序操作不会被延迟重置误伤consciousness.ts推理模式透传意识设置中的推理开关reasoning持久化于settings/consciousness/reasoninggetChatProviderInstance会将其映射为enabled | disabled传给提供者consciousness-settings.ts、consciousness.ts。问题排查校验失败校验本质是一次最短的聊天请求失败时按以下顺序排查API Key 是否有效——粘贴时注意首尾空格必要时重新复制账号额度——确认账号仍有可用 credit且使用量上限usage limit没有耗尽是否触发限流——检查 Anthropic 速率限制rate limit状态网络连通性——确认当前网络能访问https://api.anthropic.com/v1/自建代理或防火墙场景下尤其要检查。从实现层面补充连接性检查对 5xx 响应直接判失败openai-compatible.ts而 4xx 状态码会被聊天检查视为连通但请求不合法便于区分网络不通与凭据/参数错误两类问题。模型选择器里找不到想要的模型内置模型目录是源码中的静态列表因此先升级 AIRI——新模型通常随版本发布进入目录若仍急需可切换到通用 OpenAI 兼容提供者或在意识页面直接手动输入 Anthropic 官方提供的准确模型 ID。小结接入 Anthropic 的完整链路可以概括为控制台申请 Key → 设置页填入 KeyBase URL 保持默认→ 自动校验通过 → 在意识模块从内置目录选择 Claude 模型 → 开始对话。理解源码侧的注册结构内置目录 浏览器直连头与两层校验机制连通性 真实 ping能帮你在 Key 有效但配置失败时快速定位是网络、额度还是目录版本的问题。延伸阅读提供者定义与校验生命周期packages/stage-ui/src/libs/providers/types.tsOpenAI 兼容校验器实现Anthropic 复用packages/stage-ui/src/libs/providers/validators/openai-compatible.ts提供者状态存储与模型加载packages/stage-ui/src/stores/providers/provider.ts意识模块选择状态与推理模式packages/stage-ui/src/stores/modules/consciousness.ts本文档原文韩文docs/content/ko/docs/manual/config/providers/consciousness/anthropic.md【免费下载链接】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），仅供参考