---
title: "WorkBuddy 接入 Claude：编程套餐与 API Key 配置"
description: "在 WorkBuddy 里用上 Claude Sonnet 5.5、Opus 5.5 与 Fable 5.2，每月 $10 起。添加自定义模型走 CodingPass 月额度，不再消耗内置积分。"
url: https://codingpass.ai/zh/tools/workbuddy
language: zh-CN
updated: 2026-11-18
---
# 在 WorkBuddy 里用上 Claude。

WorkBuddy 的桌面工作区、Skills 和微信/飞书遥控照旧用，只需添加一个自定义模型接入 CodingPass，就能用固定月额度跑 Claude Sonnet 5.5、Opus 5.5 和 Fable 5.2，不再消耗 WorkBuddy 内置积分。

- 60 秒接入
- 不会意外扣费
- 用量不超过 5% 可全额退款

WorkBuddy 模型设置

```
Base URL   https://codingpass.ai/v1
API Key    cp-live-…
Model ID   claude-sonnet-5-5
```

你套餐对应的模型 ID

**Go**

claude-sonnet-5-5

**Plus**

claude-opus-5-5

**Pro**

claude-fable-5-2

## 桌面 AI 工作台，直接跑 Claude。

腾讯出品的桌面 AI Agent，擅长本地文件处理、办公流与代码任务。配好自定义模型后全部能力都走 CodingPass。

### 突破内置模型限制，用上 Claude

WorkBuddy 默认内置国产模型。添加一个自定义模型指向 CodingPass，就能在同一个工作区里用上 Claude Sonnet 5.5、Opus 5.5 或 Fable 5.2。

### 不再消耗 WorkBuddy 积分

多文件任务和长对话很容易把内置积分刷光。切换到自定义 Claude 模型后，请求只走你的 CodingPass 月额度，不扣 WorkBuddy 官方积分。

### Skills、MCP 与 ClawHub 照常可用

添加模型时勾选「工具调用」，WorkBuddy 自带的办公技能包、MCP 连接器和 OpenClaw / ClawHub 扩展都能配合 Claude 正常执行。

### 手机端远程遥控

微信、企业微信、飞书、钉钉或 Slack 里远程下发任务、看进度，背后同样走你配置好的 CodingPass Key。

## WorkBuddy 选哪一档？

每一档都能接进 WorkBuddy。按你想默认用的 Claude 旗舰模型来选；开源模型每档都有，共用同一份月额度。

- [完整套餐详情](https://codingpass.ai/zh/pricing#compare-plans)
- [全部 27 个模型的额度](https://codingpass.ai/zh/models)

### Go: Claude Sonnet 5.5

适合 日常办公与编码，主力跑 Sonnet 5.5

$10/月

每月 $60 Sonnet 额度

**每月请求次数**

≈2,050

**每个 5 小时窗口**

≈342次

**每款开源模型**

$40/月

**模型 ID**

claude-sonnet-5-5

### Plus: Claude Opus 5.5

适合 复杂多文件任务、深度分析与长上下文

$30/月

每月 $200 Opus 额度

**每月请求次数**

≈3,420

**每个 5 小时窗口**

≈570次

**每款开源模型**

$125/月

**模型 ID**

claude-opus-5-5

### Pro: Claude Fable 5.2

适合 高频 Agent 工作流，攻最难的问题

$100/月

每月 $500 Fable 额度

**每月请求次数**

≈5,090

**每个 5 小时窗口**

≈848次

**每款开源模型**

$300/月

**模型 ID**

claude-fable-5-2

按 CodingPass 实际流量估算：每次请求约 10 万 token，其中约 5% 输入、1% 输出、94% 缓存读取。WorkBuddy 完成一个多步任务通常要发多次请求。额度按官方 API 价计量。

## 三步，大约一分钟。

WorkBuddy 在设置里支持 OpenAI 兼容的自定义模型。配好一次，勾选工具调用，再在对话里切过去就行。

1. ### 创建 Key
   用 Google、GitHub 或邮箱登录，选一个套餐。然后进入控制台，依次点 Keys → New key。Key 以 `cp-live-` 开头。
2. ### 在设置里添加自定义模型
   打开 WorkBuddy 设置（macOS 按 `Cmd + ,`，Windows 按 `Ctrl + ,`），进入 模型 → 添加模型 → 自定义。接口地址（Base URL）填 `https://codingpass.ai/v1`（若提示需要完整路径则填 `https://codingpass.ai/v1/chat/completions`），API Key 填你的 `cp-live-` 密钥，模型名称（Model ID）填 `claude-sonnet-5-5`。勾选**工具调用**（需要发截图时也勾选**图片输入**），点测试连接，通过后保存。
   `设置 → 模型 → 添加模型 → 自定义`
3. ### 在对话里切换到自定义模型
   回到对话界面，点输入框右下角的模型选择器，滑到底部的**自定义模型**分组，选中刚刚添加的 `claude-sonnet-5-5` 即可开聊。
   `自定义模型 → claude-sonnet-5-5`

~/Documents/q4-report 示例任务 WorkBuddy

```
> 汇总这个文件夹里的 CSV 数据，整理一份周报。

● Plan 3 steps · Tool Call enabled
● Read sales-oct.csv, churn-oct.csv
● Wrote weekly-brief.md (64 lines)
  已生成 weekly-brief.md，包含净留存与主要流失原因。
```

Sonnet 5.5

$2.80 / $60.00 11 天后重置

## 把每份额度用足。

一份月额度覆盖所有模型，另有 5 小时和每周上限。按任务选对模型，额度能用得更久。

### 简单任务交给 Haiku 5.5

每个模型单独添加成一个自定义模型，在对话框的模型选择器里随时切换。Haiku 5.5 每次请求的消耗只有 Sonnet 的零头，总结、整理文件这类活交给它，额度能用得更久。

```
claude-haiku-5-5    # 总结、小改动
claude-sonnet-5-5   # 日常任务
claude-opus-5-5     # 深度分析，Plus 套餐
```

### 也可以在 models.json 里添加

每个模型写一条，改完后**完全退出并重启** WorkBuddy。Windows 下文件在 `%USERPROFILE%\.workbuddy-ai`。`supportsToolCall` 要保持开启，否则任务执行到一半会中断。

~/.workbuddy-ai/models.json

```
{
  "models": [
    {
      "id": "claude-haiku-5-5",
      "name": "Claude Haiku 5.5",
      "vendor": "Custom",
      "url": "https://codingpass.ai/v1/chat/completions",
      "apiKey": "cp-live-…",
      "supportsToolCall": true,
      "supportsImages": true
    }
  ]
}
```

## WorkBuddy 用 Claude，大家最关心这些。

**会违反厂商条款吗？会不会被封号？**

你只用 CodingPass 的 Key。不用登录、共享或转发任何人的账号，你自己的 Claude 或 ChatGPT 账号也不牵涉其中。请求需遵守各厂商的使用政策。

**配好之后为什么还在扣 WorkBuddy 积分？**

添加自定义模型不会自动切换当前对话。请点对话输入框右下角的模型选择器，滑到最底部的**自定义模型**分组，手动选中你刚添加的 Claude 模型。只要选的还是内置模型（混元、GLM、Kimi 等），就依然会扣官方积分。

**测试连接报 401 或 404 怎么办？**

**401** 通常是 `cp-live-` Key 前后多复制了空格或漏了字符。**404** 通常是 Model ID 没对齐，请核对 CodingPass 的准确模型名（如 Go 档填 `claude-sonnet-5-5`，Plus 档填 `claude-opus-5-5`，Pro 档填 `claude-fable-5-2`）。如果仍报 404，可把 Base URL 在 `https://codingpass.ai/v1` 和 `https://codingpass.ai/v1/chat/completions` 之间切换尝试。

**为什么 Claude 在 WorkBuddy 里跑多步任务或 Skills 会失败？**

请检查自定义模型里是否开启了**工具调用**（`supportsToolCall: true`）。WorkBuddy 的 Agent 规划、本地文件操作和 ClawHub 技能都依赖工具调用。如果是手动改的 `models.json`，需要完全退出（Windows 托盘图标也要右键退出）再重新打开客户端。

**微信、飞书远程遥控和 ClawHub Skills 能用自定义 Claude 吗？**

可以。只要工作区当前选中的是你的自定义 Claude 模型，本地文件处理、MCP 连接器、OpenClaw / ClawHub 技能，以及通过微信、企业微信、飞书、钉钉或 Slack 远程发起的任务都会走 CodingPass。

**用到 5 小时上限会怎样？**

每个 5 小时窗口最多用月额度的 1/6（Go 上是 $10 的 Sonnet 5.5，约 342 次请求）。这道上限按所有模型合计，用到后 CodingPass 对所有模型都返回 429 和重置时间。可以等它重置、为当前窗口买重置卡，或升级套餐。[上限与 429 的规则](https://codingpass.ai/zh/usage-limits#response)。

## 同一个 Key，所有 Agent 通用。
