编码 Agent 集成

Claude Code

Claude Code 使用 Anthropic 原生 Messages 协议。JoyToken 当前公开模型入口是 OpenAI 兼容接口，因此 Claude Code 需要先接到一个 Anthropic 到 OpenAI 兼容桥接服务，再由桥接服务转发到 JoyToken。

Claude Code 是什么？

Claude Code 是 Anthropic 面向终端和编辑器工作流的编码 Agent。它围绕 Anthropic 认证和 Messages API 语义设计。

接入 JoyToken 时，推荐部署形态是：

Claude Code
  -> Anthropic 兼容桥接服务
  -> JoyToken /openai/v1/chat/completions
  -> 上游模型

快速开始

第 1 步：创建 JoyToken API Key

创建专用 Key，例如 dev-claude-code。测试桥接服务时先使用较小的开发预算。

第 2 步：运行桥接服务

桥接服务应在本地或内网暴露 Anthropic 兼容接口，并把模型调用转发到 JoyToken。

.env
$JOY_TOKEN_API_KEY="jt_xxx"
$JOY_TOKEN_OPENAI_BASE_URL="https://api-dev.joytokens.ai/openai/v1"
$JOY_TOKEN_DEFAULT_MODEL="auto"

推荐转发关系：

POST http://localhost:8787/v1/messages
  -> POST https://api-dev.joytokens.ai/openai/v1/chat/completions

第 3 步：配置 Claude Code

把 Claude Code 指向桥接服务：

~/.zshrc
$export ANTHROPIC_BASE_URL="http://localhost:8787"
$export ANTHROPIC_AUTH_TOKEN="$JOY_TOKEN_API_KEY"
$export ANTHROPIC_API_KEY=""

如果你的 Claude Code 版本必须读取 ANTHROPIC_API_KEY，可以设置为同一把 JoyToken Key。测试时不要保留旧 Anthropic 登录态。

第 4 步：清理旧登录态

如果之前用 Anthropic 账号登录过 Claude Code，执行：

> /logout

然后重启 Claude Code，让新环境变量生效。

第 5 步：验证

在 Claude Code 里运行 /status，确认 base URL 指向桥接服务。然后在 JoyToken 日志中查看 dev-claude-code Key 下是否有请求。

桥接服务要求

Claude Code 侧JoyToken 侧
Anthropic Messages 请求OpenAI 兼容聊天补全请求
ANTHROPIC_AUTH_TOKENAuthorization: Bearer $JOY_TOKEN_API_KEY
Claude 模型名auto 或 JoyToken 模型 key
工具调用块OpenAI 兼容工具调用
流式事件聊天补全 SSE 分块
Anthropic 格式错误将 JoyToken 状态码和错误响应映射回 Claude Code

为什么用 JoyToken 接入 Claude Code？

集中预算控制

使用 Claude Code 专用 Key，并在请求进入上游提供方前应用策略、预算、钱包和 IP 检查。

用量可见性

结合桥接服务日志、JoyToken 日志和用量，团队可以按 API Key 归因 Claude Code 流量。

模型路由

评估阶段可以把 Claude 模型名映射到 auto。生产环境建议维护明确的 JoyToken 模型 key 白名单。

故障排查

现象检查
Claude Code 无法开始会话ANTHROPIC_BASE_URL 是否指向桥接服务
JoyToken 返回 401桥接服务是否把 JoyToken Key 作为 Bearer 认证转发
工具调用失败桥接服务是否把 Anthropic 工具调用转成 OpenAI 兼容工具调用
流式响应卡住桥接服务是否逐块转发，而不是缓冲完整响应
JoyToken 没有用量Claude Code 是否仍在使用缓存的 Anthropic 会话或其他 base URL

相关资源