如何在 Claude Code 中通过 Novita AI 使用 CoBuddy

如何在 Claude Code 中通过 Novita AI 使用 CoBuddy

CoBuddy 是百度在 Novita AI 上提供的编码专用模型,支持函数调用、推理、128K 上下文窗口,以及适合开发者工作流的低端到端延迟。由于 CoBuddy 仅提供 OpenAI 兼容的 chat/completions 接口,而非 Anthropic 兼容接口,因此在 Claude Code 中配置它需要将 ANTHROPIC_BASE_URL 指向 Novita AI 的 OpenAI 兼容路径。本指南将带你完成从 API 密钥到首次会话的每一步。

CoBuddy 是什么?

CoBuddy 是由百度开发的代码生成模型,可通过 Novita AI 的 LLM API 获取。它专为软件开发任务设计:生成代码、重构、编写测试、规划实现以及支持 Agent 工作流。

规格 详情
模型 ID baidu/cobuddy
上下文窗口 131,072 个 token(128K)
最大输出 65,536 个 token
输入价格 2.80 美元 / 1M token
输出价格 11.30 美元 / 1M token
缓存读取 0.70 美元 / 1M token
功能 函数调用、推理
接口 仅 OpenAI 兼容的 chat/completions

接口的区别对 Claude Code 的配置至关重要。CoBuddy 不支持 Anthropic 兼容接口,因此配置时使用 Novita AI 的 OpenAI 兼容基础 URL(https://api.novita.ai/v3/openai),而非 anthropic 路径。

为什么要在 Claude Code 中使用 CoBuddy?

Claude Code 是一个 Agent 式 CLI,让你可以用自然语言委托编码任务——文件编辑、终端命令、代码库分析以及多步骤工作流。默认情况下它使用 Claude 模型,但 ANTHROPIC_BASE_URL 环境变量允许你将请求路由到其他提供商和模型。

通过 Novita AI 切换为 CoBuddy 可以带来:

  • 编码专长。 CoBuddy 专为软件任务而非通用对话而构建。它直接针对代码生成、审查和 Agent 工作流。
  • 与 Claude Sonnet 的成本差异。 Claude Sonnet 4.5 的输入价格为 3.00 美元 / M token,输出价格为 15.00 美元 / M token。Novita AI 上的 CoBuddy 输入价格为 2.80 美元 / M,输出价格为 11.30 美元 / M——在大规模使用时可节省可观成本,缓存读取价格为 0.70 美元 / M。
  • 高吞吐量和低端到端延迟。 Novita AI 的 CoBuddy 部署针对持续吞吐量进行了优化,这对于需要多次增量请求的长时间 Agent 会话非常重要。
  • 128K 上下文窗口。 足以在单个提示中传入大量文件片段、测试输出和实现说明。

对于已经使用 Claude Code 并希望在不改变工作流工具的情况下评估编码优先替代方案的团队来说,CoBuddy 是一个实用的起点。

第一步:获取你的 Novita AI API 密钥

创建一个 Novita AI 账户——新账户会获得免费试用额度。登录后,前往 密钥管理 并点击 创建新密钥。立即复制密钥;它只显示一次。

第二步:安装 Claude Code

Claude Code 需要 Node.js 18 或更高版本。验证你的版本:

node --version

如果 Node.js 缺失或低于 v18,请从 nodejs.org 安装。

全局安装 Claude Code:

npm install -g @anthropic-ai/claude-code

确认安装:

claude --version

第三步:配置环境变量

CoBuddy 仅支持 OpenAI 兼容接口。将 ANTHROPIC_BASE_URL 设置为 Novita AI 的 OpenAI 兼容路径,以便 Claude Code 将请求转发到该地址。

macOS 和 Linux

export ANTHROPIC_BASE_URL="https://api.novita.ai/v3/openai"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
export ANTHROPIC_MODEL="baidu/cobuddy"
export ANTHROPIC_SMALL_FAST_MODEL="baidu/cobuddy"

Windows(命令提示符)

set ANTHROPIC_BASE_URL=https://api.novita.ai/v3/openai
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=baidu/cobuddy
set ANTHROPIC_SMALL_FAST_MODEL=baidu/cobuddy

Windows(PowerShell)

$env:ANTHROPIC_BASE_URL = "https://api.novita.ai/v3/openai"
$env:ANTHROPIC_AUTH_TOKEN = "<Your Novita API Key>"
$env:ANTHROPIC_MODEL = "baidu/cobuddy"
$env:ANTHROPIC_SMALL_FAST_MODEL = "baidu/cobuddy"

每个变量的作用:

  • ANTHROPIC_BASE_URL —— 将 Claude Code 的请求重定向到 Novita AI 的 OpenAI 兼容接口,而非 Anthropic 的服务器
  • ANTHROPIC_AUTH_TOKEN —— 用于身份验证的 Novita AI API 密钥
  • ANTHROPIC_MODEL —— 用于主要(复杂)任务的模型
  • ANTHROPIC_SMALL_FAST_MODEL —— 用于后台和轻量级任务的模型

若要在 macOS/Linux 上跨终端会话保持这些配置,请将 export 行添加到 ~/.zshrc~/.bashrc 中。

第四步:启动 Claude Code

导航到你的项目目录并启动 Claude Code:

cd /path/to/your/project
claude .

. 告诉 Claude Code 在当前目录中运行。你将看到交互式提示,可以用自然语言描述任务。

运行 /model 确认当前使用的模型,或运行 /doctor 诊断配置问题。

CoBuddy 规格与价格

以下是 Novita AI 上的 CoBuddy 与 Claude Sonnet 4.5 的完整对比:

CoBuddy(Novita AI) Claude Sonnet 4.5
输入(每 1M token) 2.80 美元 3.00 美元
输出(每 1M token) 11.30 美元 15.00 美元
缓存读取(每 1M token) 0.70 美元 0.30 美元
上下文窗口 131,072 个 token 200,000 个 token
最大输出 65,536 个 token 64,000 个 token
函数调用
推理
Anthropic 接口 原生支持

主要权衡:CoBuddy 的输出 token 价格低于 Sonnet 4.5,并且对于重用上下文的密集 Agent 会话,缓存读取费用更低。Claude Sonnet 4.5 拥有更大的上下文窗口,并且是 Claude Code 的原生模型。当你希望使用编码专注型模型并降低输出成本时,选择 CoBuddy;当你需要完整的 200K 上下文或更广泛的推理任务时,则继续使用 Sonnet。

实用编码工作流技巧

保持提示词任务具体化

CoBuddy 针对软件任务进行了优化。描述具体工程成果的提示词——如“为这个函数添加输入验证”、“为结账流程编写单元测试”、“重构此模块以消除循环依赖”——比开放式的探索性提示词效果更好。

有策略地使用 128K 上下文窗口

在 128K token 下,你可以在单个请求中传入相关的文件片段、测试输出、风格指南和 API 契约。尽管如此,请保持提示词结构清晰:描述任务、提供精选上下文、列出约束条件,并要求给出有边界的输出。长上下文并不能替代清晰的指令。

验证函数调用输出

CoBuddy 支持函数调用,Claude Code 使用它进行工具调用。对于修改文件或执行命令的任务,在批准之前请审查计划的操作。在 Claude Code 中使用 /review 命令检查更改,然后再应用。

缓存密集型会话受益于 CoBuddy 的价格

在缓存读取 token 价格为 0.70 美元 / M 的情况下,包含大型系统提示词或重复上下文的会话会随着时间的推移显著降低费用。如果你长时间运行 Agent 会话,并且反复引用相同的代码库上下文,缓存读取成本会累积——而 CoBuddy 的缓存读取价格具有竞争力。

在真实任务上评估后再下结论

评估 CoBuddy 是否适合你的团队的最佳方式是将其应用于实际待办事项:一个 bug 工单、一个测试生成任务、一次小型重构。在具体任务上比较输出质量,而不是依赖通用基准。

常见问题

Novita AI 上 CoBuddy 的模型 ID 是什么?

ANTHROPIC_MODEL 环境变量以及任何直接 API 请求体中使用 baidu/cobuddy

为什么不使用 anthropic 端点,而要使用 https://api.novita.ai/v3/openai

CoBuddy 仅支持 OpenAI 兼容的 chat/completions 端点。将 ANTHROPIC_BASE_URL 设置为 Novita AI 的 OpenAI 兼容路径(https://api.novita.ai/v3/openai)可以告诉 Claude Code 通过该端点路由请求。Anthropic 兼容路径(https://api.novita.ai/anthropic)适用于原生实现 Anthropic messages API 的模型——CoBuddy 不支持。

CoBuddy 在 Novita AI 上的价格是多少?

截至 2026 年 6 月:输入 token 2.80 美元 / M,输出 token 11.30 美元 / M,缓存读取 token 0.70 美元 / M。在生产规划前,请确认 CoBuddy 模型页面 上的当前价格。

CoBuddy 支持函数调用吗?

是的。CoBuddy 支持函数调用和推理,这两者都是 Claude Code Agent 循环所必需的。

我可以在 Cursor 或其他工具中使用 CoBuddy 吗?

可以。任何支持自定义 OpenAI 兼容基础 URL 的工具都可以通过 Novita AI 使用 CoBuddy。将基础 URL 设置为 https://api.novita.ai/v3/openai,模型设置为 baidu/cobuddy

Novita AI 是一个 AI 云平台,为开发者提供使用简单 API 部署 AI 模型的便捷方式,同时还提供经济实惠且可靠的 GPU 云服务用于构建和扩展。

推荐文章