JoyCode2Api

JoyCode2Api

JoyCode → Anthropic / OpenAI 协议翻译器

让 Claude Code、Cursor、Codex 直接用上 JoyCode 背后的模型

JoyAI-Code · Claude-Opus-4.7 · GLM-5.1 · Kimi-K2.6 · MiniMax-M2.7 · Doubao-Seed-2.0-pro

快速开始 · 配置 · 部署 · API 参考 · FAQ · 贡献

概述

JoyCode（京东 AI 编程助手）背后挂了 GLM、Kimi、MiniMax、Doubao、Claude-Opus 等模型，但它的 API 是私有协议，主流编程工具接不上。JoyCode2Api 在中间做协议翻译，对外同时暴露两套标准协议：

- Anthropic Messages API (/v1/messages) — Claude Code 走这个
- OpenAI Chat Completions API (/v1/chat/completions) — Cursor / Codex 走这个

工具调用（tool use）、流式输出（SSE）、上下文截断全部完整翻译，使用体验和原生 API 一致。
⚠️ 免责声明：本项目仅供个人学习和技术研究使用。禁止用于商业转售、API 中转服务（中转站属于违法行为）、大规模薅号或任何违法违规活动。因不当使用造成的一切后果由使用者自行承担，与项目作者无关。本项目不是 JoyCode 官方产品。

功能特性

界面预览

数据概览 — 请求量、Token、延迟、模型分布
账号管理 — 多 JD 账号，扫码 / OAuth / 手动

账号详情 — 单账号用量与请求记录
系统设置 — 默认模型、超时、日志保留

快速开始
TL;DR — 编译 → serve --skip-validation → 浏览器加账号 → 配环境变量 → claude。

第 1 步：编译

需要 Go 1.25+。项目是纯 Go（SQLite 用 modernc 纯 Go 驱动），无需任何 C 工具链：

前端已随仓库提交（cmd/JoyCode2Api/static/），不装 Node.js 也能编出带界面的二进制。只有要改前端时才需要 cd web && npm install && npm run build。
不想编译？去 Releases 下载预编译二进制，跳到第 2 步。

第 2 步：首次启动
⚠️ 两个必看的坑
1. ./JoyCode2Api（不带子命令）只会打印帮助然后退出，不会启动服务。必须用 ./JoyCode2Api serve。
2. 首次启动时本机还没有任何 JoyCode 凭据（没装 JoyCode IDE / 非 macOS / Docker），serve 默认会去本地找凭据，找不到就直接报错退出。第一次启动必须加 --skip-validation，让服务先跑起来，凭据后面在 Dashboard 里加。

看到下面这段 banner 就说明起来了：
macOS 且已装 JoyCode IDE：可以不加 --skip-validation，程序会自动从 ~/Library/Application Support/JoyCode/User/globalStorage/state.vscdb 读取已登录凭据。其他平台首次启动一律加 --skip-validation。

第 3 步：配置 Dashboard

浏览器打开 ：

1. 首次访问进入初始化页面，设置 root 密码（≥ 6 位）。这是 Dashboard 登录密码，跟 JoyCode 账号无关。
2. 用刚设置的密码登录。

第 4 步：添加 JD 账号

在「账号管理」里添加 JoyCode 账号，三种方式任选：

OAuth 在 Docker / 远程部署时：浏览器会跳转到一个打不开的 localhost 页面，这是正常的。把地址栏里完整的 URL（形如 http://127.0.0.1:34891/?pt_key=xxx&...）复制下来，粘进弹窗输入框，点「提交授权」。

添加成功后，每个账号会生成独立的 API Key（形如…