Claude 兼容

Claude Desktop / Claude Code / OpenClaw 接入思路

Q: Claude Desktop、Claude Code、OpenClaw 的配置项名称一样吗？

不一样。不同客户端可能使用环境变量、JSON 配置、界面表单或 provider 配置。 教程应该讲清判断方法，而不是把一个客户端的变量名复制给所有工具。

Q: Base URL 应该填 https://api.ofapp.cn 还是 https://api.ofapp.cn/v1？

看客户端是否会自动拼 /v1/messages。如果会自动拼，Base URL 通常填 https://api.ofapp.cn；如果只拼 /messages，通常填 https://api.ofapp.cn/v1。最终目标是请求到 https://api.ofapp.cn/v1/messages。

Q: Claude Code 支持哪些模型？

不要从教程里猜。模型名、可用能力和额度应从 OfApp.cn 控制台或官方文档复制， 并确认当前 Claude Code 版本支持对应模型格式。

Q: OpenClaw 报 model not found 怎么办？

先确认模型名来自 OfApp.cn 当前账号，再确认客户端没有把模型发到错误端点。 如果仍失败，看 model not found。

Q: 客户端能聊天，但工具调用失败，说明 OfApp.cn 不可用吗？

不一定。普通文本、工具调用、文件、多模态和 MCP 权限是不同层次。先保留一 条纯文本请求，再逐个恢复工具能力。

Q: 可以把客户端完整日志发给 AI 排查吗？

可以发脱敏日志，不要发完整日志。删除 API Key、Cookie、用户材料、文件路 径、内部 URL、个人信息和业务数据后，再保留状态码、端点、模型名和错误摘要。

Q: 这篇是不是官方客户端配置手册？

不是。它是接入思路和排错方法。客户端变量名、配置路径、模型支持和协议细节 可能随版本变化，请以客户端当前文档、OfApp.cn 控制台和官方文档为准。

Claude Desktop、Claude Code、OpenClaw 接入思路说明如何用 OfApp.cn 配置 Claude 生态客户端的 Base URL、API Key、模型名、最小验证和排错边界。

预计阅读: 6 分钟
最近更新: 2026/07/06
维护方式: 人工编辑

Claude Desktop、Claude Code、OpenClaw 和其他 Claude 兼容客户端的配置方式会随版本变化。不要把接入教程写成某个固定路径或某个变量名的背诵题。更稳的方法是先确认客户端到底会把请求发到哪里、使用哪种 Key 字段、会不会自动拼接 /v1，再用最小 Claude Messages 请求验证。

OfApp.cn 官方入口当前提供 /v1/messages Claude 兼容能力，并说明一个 Key 可以接入 Claude Code、OpenClaw 等工具。具体模型、额度、价格、客户端兼容状态和字段要求，请以 OfApp.cn 控制台或官方文档为准。

适合谁读

读者	你可能正在做什么	读完能完成什么
Claude Code 用户	想把终端里的 AI 编程工具接到 OfApp.cn	知道先验证 Base URL、Key 和模型，再配置客户端
Claude Desktop 用户	想让桌面客户端或扩展使用兼容入口	分清客户端配置、MCP 配置和 API 配置
OpenClaw 用户	想把 Claude 生态工具接入统一 Key	建立不依赖过期截图的配置检查表
开发者	要给团队写内部接入文档	写出可复现、可排错、不会泄露 Key 的说明
AI 初学者	分不清 OpenAI 兼容和 Claude 兼容	理解 `/v1/messages`、Base URL 和模型名的关系

如果你还不理解 Claude Messages 请求体，先读 Claude Messages 兼容接口说明。如果已经遇到 400 或 messages format error，直接看常见 messages 格式错误排查。

接入流程图

这条流程的重点是“先验证入口，再配置客户端”。如果 cURL 最小请求都失败，客户端里怎么改都只是换一个地方失败。

核心配置表

配置项	应该确认什么	稳定写法
API Key	Key 来自 OfApp.cn 当前账号，不能写进公开仓库	用 `sk-xxxx` 做占位，真实 Key 放本机环境变量或客户端密钥框
Base URL	客户端是否会自动拼接 `/v1` 或 `/messages`	按客户端最终请求路径选择 `https://api.ofapp.cn` 或 `https://api.ofapp.cn/v1`
Endpoint	Claude Messages 兼容入口通常是 `/v1/messages`	用最小请求验证最终 URL
Model	当前账号可用模型，而不是教程里随手复制的名称	从 OfApp.cn 控制台或官方文档复制
Header	Claude 兼容请求常见需要版本头或客户端内置协议头	OfApp.cn 示例包含 `anthropic-version: 2023-06-01`
日志	需要能复现问题，又不能泄露密钥和隐私	记录脱敏 Key、状态码、端点、模型和客户端版本

这张表适合直接贴进团队文档。真正上线前，还要用当前客户端版本跑一次最小请求，不要只依赖过去能用的配置截图。

Base URL 怎么填

OfApp.cn 文档中常用的 API 入口是：

https://api.ofapp.cn/v1

但客户端的 Base URL 字段含义并不总一样。关键不是“永远填哪个字符串”，而是确认最终请求是不是发到 /v1/messages。

客户端行为	Base URL 可尝试写法	最终目标
客户端会自动拼 `/v1/messages`	`https://api.ofapp.cn`	`https://api.ofapp.cn/v1/messages`
客户端只会拼 `/messages`	`https://api.ofapp.cn/v1`	`https://api.ofapp.cn/v1/messages`
客户端要求完整 endpoint	`https://api.ofapp.cn/v1/messages`	直接请求 messages 端点
客户端不能改 Base URL	不要硬改配置文件	换支持自定义入口的客户端或用代理层验证

如果你不确定客户端会怎么拼路径，先看它的调试日志、网络日志或错误里的 URL。很多 404 都来自重复拼出 /v1/v1/messages，或少了一层 /v1。

Claude Code 怎么接

Claude Code 是终端里的 Claude 编程工具。Claude Code 生态常见配置会关注 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 等约定，其中 Base URL 类配置通常用于把请求路由到 Anthropic 协议兼容网关。不同版本和发行渠道可能调整行为，因此生产配置仍应以 Claude Code 当前文档和 OfApp.cn 文档为准。

你可以按这个顺序验证：

先用 cURL 跑通 OfApp.cn 的 /v1/messages 最小请求。
确认 Claude Code 当前版本是否允许自定义 Anthropic Base URL。
判断它的 Base URL 字段是否会自动拼 /v1/messages。
把真实 Key 放进本机环境变量、密钥管理或客户端安全配置里。
用一个无敏感信息的小项目验证“读文件、改一行、运行测试”。

示例只表达配置思路，不代表所有版本都使用同一变量名。

# 情况 A：客户端会自动拼 /v1/messages
export ANTHROPIC_BASE_URL="https://api.ofapp.cn"
export ANTHROPIC_API_KEY="sk-xxxx"

# 情况 B：客户端只会拼 /messages
export ANTHROPIC_BASE_URL="https://api.ofapp.cn/v1"
export ANTHROPIC_API_KEY="sk-xxxx"

如果 Claude Code 提供单独的配置文件、登录流程或 provider 字段，应优先使用官方推荐方式。不要把真实 Key 写进 shell 历史、README、截图或公共 issue。

Claude Desktop 怎么接

Claude Desktop 常被用于桌面对话、文件阅读、MCP 工具和本地工作流。接入 OfApp.cn 时，要先分清两件事。

你要改什么	说明
Claude 对话模型入口	关注 API Key、Base URL、模型名和 Claude Messages 兼容性
MCP 工具配置	关注本地工具服务器、权限、路径和环境变量

很多人把这两类配置混在一起：MCP 能不能启动，不等于模型请求能不能发出去；模型请求成功，也不代表本地工具权限已经配置正确。建议先关闭复杂 MCP 工具，只发一条文本消息，确认客户端能通过兼容入口完成普通对话。

OpenClaw 怎么接

OpenClaw 和类似 Claude 生态客户端通常会提供 provider、Base URL、API Key、 model 或 endpoint 配置项。不同版本名称可能不同，但排查顺序相同。

步骤	检查点
选择 provider	是否选择了 Claude / Anthropic / custom compatible 之类入口
填写 Key	是否读取 OfApp.cn API Key，而不是系统里旧的 Key
填写 Base URL	是否最终指向 `/v1/messages`
填写模型	是否来自 OfApp.cn 控制台或官方文档
发送测试消息	是否先用纯文本，不带工具、图片、文件和长上下文
保存日志	是否记录状态码、端点、客户端版本和脱敏响应

如果 OpenClaw 界面里只有 OpenAI 兼容入口，而没有 Claude Messages 兼容入口，不要直接把 OpenAI 的 /v1/chat/completions 配置套进去。先确认这个客户端当前版本支持哪种协议。

最小请求先跑通

下面请求用来证明 OfApp.cn 入口、Key、模型名和 Claude Messages 结构可以工作。它不是客户端配置文件，也不应该包含真实 Key。

export CLAUDE_BASE_URL="https://api.ofapp.cn/v1"
export OFAPP_API_KEY="sk-xxxx"
export CLAUDE_MODEL="以控制台可用模型为准"

curl "$CLAUDE_BASE_URL/messages" \
  -H "Authorization: Bearer $OFAPP_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$CLAUDE_MODEL\",
    \"max_tokens\": 512,
    \"messages\": [
      {
        \"role\": \"user\",
        \"content\": \"请回复：连接成功。\"
      }
    ]
  }"

如果 cURL 成功但客户端失败，说明问题更可能在客户端配置、路径拼接、请求头或客户端注入的 messages 结构。下一步去看常见 messages 格式错误排查。

接入验收清单

检查项	通过标准
Key 安全	真实 Key 不出现在仓库、截图、日志和聊天记录里
Base URL	最终请求不是 `/v1/v1/messages`，也不是缺少 `/v1`
模型名	从 OfApp.cn 控制台或官方文档复制
最小文本请求	一条 `user` 消息可以得到正常回复
客户端普通对话	不带工具、图片、文件时可以稳定返回
工具或 MCP	文本请求成功后，再逐个恢复工具能力
错误日志	能看到状态码、端点、客户端版本和脱敏错误体
团队文档	写清“以当前控制台和客户端文档为准”

把这张表当成上线前检查，而不是安装后的装饰。每一个“通过”都应该有命令输出、截图或日志能证明。

不要做的事

不要把真实 API Key 写进教程、README、截图或 issue。
不要承诺某个客户端版本永远支持某个字段。
不要把 OpenAI Chat Completions 的配置直接套到 Claude Messages 客户端。
不要在最小请求失败时继续调工具、MCP、多模态或长上下文。
不要猜模型名，模型、能力、价格和额度请以 OfApp.cn 控制台或官方文档为准。
不要把 ANTHROPIC_AUTH_TOKEN 当成 OfApp.cn API Key 的固定替代品，除非当前客户端文档明确要求这样配置。

常见问题

Claude Desktop、Claude Code、OpenClaw 的配置项名称一样吗？

不一样。不同客户端可能使用环境变量、JSON 配置、界面表单或 provider 配置。教程应该讲清判断方法，而不是把一个客户端的变量名复制给所有工具。

Base URL 应该填 `https://api.ofapp.cn` 还是 `https://api.ofapp.cn/v1`？

看客户端是否会自动拼 /v1/messages。如果会自动拼，Base URL 通常填 https://api.ofapp.cn；如果只拼 /messages，通常填 https://api.ofapp.cn/v1。最终目标是请求到 https://api.ofapp.cn/v1/messages。

Claude Code 支持哪些模型？

不要从教程里猜。模型名、可用能力和额度应从 OfApp.cn 控制台或官方文档复制，并确认当前 Claude Code 版本支持对应模型格式。

OpenClaw 报 model not found 怎么办？

先确认模型名来自 OfApp.cn 当前账号，再确认客户端没有把模型发到错误端点。如果仍失败，看 model not found。

客户端能聊天，但工具调用失败，说明 OfApp.cn 不可用吗？

不一定。普通文本、工具调用、文件、多模态和 MCP 权限是不同层次。先保留一条纯文本请求，再逐个恢复工具能力。

可以把客户端完整日志发给 AI 排查吗？

可以发脱敏日志，不要发完整日志。删除 API Key、Cookie、用户材料、文件路径、内部 URL、个人信息和业务数据后，再保留状态码、端点、模型名和错误摘要。

这篇是不是官方客户端配置手册？

不是。它是接入思路和排错方法。客户端变量名、配置路径、模型支持和协议细节可能随版本变化，请以客户端当前文档、OfApp.cn 控制台和官方文档为准。

Claude Messages 兼容接口说明：理解 /v1/messages 的请求结构。
常见 messages 格式错误排查：定位 role、content、system、工具和模型名问题。
Claude 兼容生态：查看本栏目入口。
如何获取 OfApp.cn API Key：准备安全的 Key。
如何配置 Base URL：处理 /v1 拼接问题。
常见错误排查：排查 Key、Base URL、模型名和网络。
model not found：处理模型不可用。

带走什么

Claude Desktop、Claude Code、OpenClaw 接入 OfApp.cn 的关键不是记住某个截图，而是确认最终请求、Key 来源、Base URL 拼接、模型名和最小 messages 结构。先用 https://api.ofapp.cn/v1/messages 跑通文本请求，再把配置迁移到客户端；涉及模型、价格、额度和客户端支持范围时，请以 OfApp.cn 控制台、官方文档和客户端当前文档为准。