---
title: WorkBuddy 接入 Claude API
description: WorkBuddy 配置 1折AI Claude API 中转的地址、密钥与模型教程，包含协议选择、配置示例、验证步骤和常见错误。
---

使用 WorkBuddy 的自定义供应商功能连接 1折AI。先[创建 API 密钥](/docs/api-keys/)，并确认[当前可用模型](/docs/models/)；下文模型 ID 是示例，请按你的密钥权限调整。

<Note>
官方配置核对日期：2026-10-15。以下配置依据官方文档整理，本站端到端验证尚未完成；请先完成简短问答和工具调用验证，再用于长任务。OpenAI / GPT 模型已上线，模型列表与价格见[模型说明](/docs/models/)。
</Note>

依据 [官方模型配置](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)：设置 → 模型 → 添加模型 → 自定义/Custom。填写本站密钥、模型 `claude-sonnet-4-6`。

采用完整请求地址配置：高级配置开启「自定义协议」，URL 填 `https://1zheai.com/v1/chat/completions`，保存后在对话模型选择器选该模型。官方说明开启此开关会直接使用所填 URL，不做路径校验和自动补全；关闭时会按标准 `/chat/completions` 补全。因此完整 URL 与开关必须配套描述。

这里的「自定义协议」不表示可以把 OpenAI 请求自动转换成 Anthropic 请求，不能填 `/v1/messages` 后就宣称原生 Claude 协议接通。优先采用 UI，不提供未经核实的 `models.json` 手工格式。官方页面同时出现当前本地配置路径和旧 `~/.codebuddy/models.json` 迁移说明，避免据此把旧路径写成通用现行路径。界面上的工具能力标记也不能替代本站端到端验证。

## 验证接入与排错

1. 保存并重新加载配置，确认当前选中的是 `onezhe` 供应商或你添加的自定义模型。
2. 发送一句简短问题，确认能够返回；随后尝试一个可撤销的小任务，单独确认工具调用和多轮对话。
3. 打开[调用日志](/docs/usage-logs/)，核对请求时间、模型、状态与用量。一次文本回复成功不代表所有 Agent 能力都已兼容。
4. 遇到 404，核对本文地址和协议是否配套；遇到 401，核对密钥来源和进程是否读取到环境变量；遇到 429，查看限流信息后再重试。更多情况见[错误码与排错](/docs/troubleshooting/)。

密钥只保存在本地环境或工具的凭据存储中，不要提交到代码仓库、截图或公开日志。后台服务可能不继承终端环境变量；辅助模型、搜索和其他工具也可能有独立的供应商设置，需要分别检查。

## 费用与其他接入方式

查看[Claude API 实时价格](https://1zheai.com/pricing/)和[计费规则](/docs/pricing-explained/)。需要其他客户端时返回[工具接入目录](/docs/integrations/)；自己编写程序可用[SDK 与开发指南](/docs/guides/)。