核心规则先看这一行使用 OpenAI Compatible SDK 的工具填https://gw.claudeapi.com/v1仅 Claude Desktop 使用 Anthropic 原生 SDK填https://gw.claudeapi.com不加/v1。运行环境说明工具版本要求SDK 类型Base URLCursor0.40OpenAI Compatiblehttps://gw.claudeapi.com/v1Cline2.xOpenAI Compatiblehttps://gw.claudeapi.com/v1Dify0.6.xOpenAI Compatiblehttps://gw.claudeapi.com/v1Claude Desktop最新版Anthropic 原生https://gw.claudeapi.comChatBox0.9OpenAI Compatiblehttps://gw.claudeapi.com/v1Cherry Studio1.xOpenAI Compatiblehttps://gw.claudeapi.com/v1Open WebUI0.3.0OpenAI Compatiblehttps://gw.claudeapi.com/v1通用参数API Key 格式sk-xxx由 ClaudeAPI 控制台生成模型名称claude-haiku-4-5-20251001。一、Cursor 配置配置字段API Provider : OpenAI Compatible Base URL : https://gw.claudeapi.com/v1 API Key : 你的ClaudeAPI Key Model : claude-haiku-4-5-20251001操作步骤File → Preferences → Cursor Settings → ModelsAPI Provider选择OpenAI Compatible展开 BaseURL 和 API Key 两个字段BaseURL填https://gw.claudeapi.com/v1API Key填你的 ClaudeAPI Key点击Verify按钮成功标志Verify 旁出现绿色对勾✓。绿勾代表 Cursor 已成功完成鉴权握手后续所有 AI 补全请求均通过该地址路由。常见报错报错原因最小修复动作401 UnauthorizedKey 错误或含空格重新复制 Key粘贴前确认首尾无空格404 Not FoundBaseURL 缺/v1改为https://gw.claudeapi.com/v1Verify 超时本地代理拦截临时关闭代理后重试二、Cline 配置配置字段API Provider : OpenAI Compatible Base URL : https://gw.claudeapi.com/v1 API Key : 你的ClaudeAPI Key Model ID : claude-haiku-4-5-20251001 ← 必须手动输入操作步骤VS Code 侧边栏 Cline 图标 → 顶部⚙ 设置API Provider选OpenAI CompatibleBase URL填https://gw.claudeapi.com/v1API Key填你的 ClaudeAPI KeyClaudeAPI Key 可在 ClaudeAPI 控制台 创建和管理。Model ID手动输入claude-haiku-4-5-20251001下拉不可选必须手输Save保存成功标志Cline 对话框中发送任意消息状态栏显示claude-haiku-4-5-20251001并收到正常回复。若仍显示旧模型名重启 VS Code。常见报错报错原因最小修复动作Model not foundModel ID 拼写有误复制上方模型名重新手动输入401 UnauthorizedKey 失效或余额耗尽登录 ClaudeAPI 控制台检查余额Connection refusedURL 缺协议头确认 URL 以https://开头三、Dify 配置配置字段Provider : OpenAI-compatible API Base URL : https://gw.claudeapi.com/v1 ← 只填到 /v1不是 Endpoint API Key : 你的ClaudeAPI Key 模型名称手动添加: claude-haiku-4-5-20251001⚠️Dify 高频错误API Base URL 不是 Endpoint。此处只填https://gw.claudeapi.com/v1Dify 会自动拼接/chat/completions。若填入完整 Endpoint会出现404或双重路径错误。操作步骤右上角头像 →设置 → 模型供应商选择OpenAI-compatible→ 点击 添加API Base URL填https://gw.claudeapi.com/v1API Key填你的 ClaudeAPI Key点击保存成功后进入模型列表手动添加模型claude-haiku-4-5-20251001保存启用成功标志模型列表中claude-haiku-4-5-20251001状态显示绿色「可用」在 Dify 应用中选择该模型发送测试消息收到正常回复。四、Claude Desktop 配置⚠️Claude Desktop 是唯一不加/v1的工具使用 Anthropic 原生 SDKURL 格式与其他工具不同。配置文件路径系统路径Windows%APPDATA%\Claude\claude_desktop_config.jsonmacOS~/Library/Application Support/Claude/claude_desktop_config.json操作步骤完全退出Claude Desktop任务栏 → 右键 → Quit打开上方路径的配置文件不存在则新建写入以下内容并保存{mcpServers:{},apiSettings:{baseUrl:https://gw.claudeapi.com,apiKey:你的ClaudeAPI Key}}重启 Claude Desktop注意baseUrl值为https://gw.claudeapi.com没有/v1。成功标志重启后主界面正常显示模型选择器发消息收到回复无「API Error」提示。常见报错报错原因最小修复动作401JSON 中含中文引号或多余空格用文本编辑器确认引号为英文404baseUrl 误填了/v1改为https://gw.claudeapi.com无/v1配置不生效未完全退出就重启任务栏确认 Claude 进程已退出后再启动JSON 解析失败文件格式有误用 jsonlint.com 校验 JSON 语法五、ChatBox 配置⚠️模式选择是第一步ChatBox 有「Claude API」和「OpenAI API」两种模式。使用 ClaudeAPI Key必须选 OpenAI API 模式选错模式会导致持续401。配置字段AI Provider : OpenAI API不是 Claude API API Host : https://gw.claudeapi.com/v1 API Key : 你的ClaudeAPI Key Model : claude-haiku-4-5-20251001操作步骤左下角Settings→AI Provider选OpenAI APIAPI Host填https://gw.claudeapi.com/v1API Key填你的 ClaudeAPI KeyModel输入或选择claude-haiku-4-5-20251001点击Check验证成功标志弹出「Connection successful」主界面右上角模型名更新发消息正常回复。常见报错报错原因最小修复动作401 Unauthorized使用了「Claude API」模式返回 Settings切换至 OpenAI API 模式404 Not FoundAPI Host 缺/v1改为https://gw.claudeapi.com/v1模型列表为空Provider 类型不对确认 Provider 为 OpenAI API手动填写模型名六、Cherry Studio 配置配置字段服务商类型 : OpenAI Compatible不要选 Anthropic API 地址 : https://gw.claudeapi.com/v1 API Key : 你的ClaudeAPI Key 模型 : claude-haiku-4-5-20251001手动添加操作步骤左侧导航设置 → 模型服务→ 添加服务商类型选OpenAI CompatibleAPI 地址填https://gw.claudeapi.com/v1API Key填你的 ClaudeAPI Key切换到模型管理→ 添加模型→ 输入claude-haiku-4-5-20251001→ 保存成功标志对话界面右上角模型选择器出现claude-haiku-4-5-20251001发消息正常回复。常见报错报错原因最小修复动作401 Unauthorized类型误选 Anthropic改为 OpenAI Compatible404 Not FoundAPI 地址含完整 Endpoint 路径只填https://gw.claudeapi.com/v1模型下拉为空未手动添加模型进入模型管理手动添加七、Open WebUI 配置前置条件Open WebUI 版本 ≥ 0.3.0使用管理员账号登录配置字段OpenAI API Base URL : https://gw.claudeapi.com/v1 API Key : 你的ClaudeAPI Key操作步骤右上角头像 →Admin Panel → Settings → ConnectionsOpenAI API部分API Base URL填https://gw.claudeapi.com/v1API Key填你的 ClaudeAPI Key点击保存验证连通性可选curlhttps://gw.claudeapi.com/v1/models\-HAuthorization: Bearer 你的ClaudeAPI Key期望输出返回包含object: list的 JSONdata数组中出现已启用的 Claude 模型名称同时 Open WebUI 模型下拉列表同步刷新。成功标志Open WebUI 对话界面模型下拉中出现 Claude 模型发消息正常回复。常见报错报错原因最小修复动作401 UnauthorizedAPI Key 未保存成功重新进入 Admin Panel 确认 Key 已填写并保存模型列表为空Base URL 格式错误确认末尾为/v1不含/models403 Forbidden非管理员账号切换管理员账号操作八、排错速查表现象检查项正确值任意工具404Base URL 格式OpenAI 兼容工具https://gw.claudeapi.com/v1Claude Desktophttps://gw.claudeapi.com任意工具401Key 来源必须是 ClaudeAPI 控制台生成的 KeyAnthropic 官网 Key 不通Claude Desktop 配置不生效退出方式必须从任务栏彻底退出不能只关窗口Dify 双重路径404API Base URL 字段只填https://gw.claudeapi.com/v1不加/chat/completionscurl 快速验证命令# OpenAI 兼容工具验证Cursor/Cline/Dify/ChatBox/Cherry Studio/Open WebUIcurlhttps://gw.claudeapi.com/v1/chat/completions\-HContent-Type: application/json\-HAuthorization: Bearer 你的ClaudeAPI Key\-d{model:claude-haiku-4-5-20251001,messages:[{role:user,content:hi}]}期望输出返回含choices数组的 JSONchoices[0].message.content中有模型回复表示接口、Key、模型名均正确。# Claude DesktopAnthropic 原生验证curlhttps://gw.claudeapi.com/v1/messages\-HContent-Type: application/json\-Hx-api-key: 你的ClaudeAPI Key\-Hanthropic-version: 2023-06-01\-d{model:claude-haiku-4-5-20251001,max_tokens:100,messages:[{role:user,content:hi}]}期望输出返回含content数组的 JSONcontent[0].text中有模型回复。—本文的持续更新版本可查看Claude API Base URL 配置指南