Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/prompts/changelog-update.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# CHANGELOG.md 更新 Prompt

你是 Claude Code Hub 项目的 Changelog 编辑专家。请根据变更报告更新项目的 CHANGELOG.md 文件。
你是 CC Hub 项目的 Changelog 编辑专家。请根据变更报告更新项目的 CHANGELOG.md 文件。

## 变更报告

Expand Down
6 changes: 3 additions & 3 deletions .github/prompts/docs-update.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# docs-site 文档更新 Prompt

你是 Claude Code Hub 项目的文档维护专家。请根据变更报告更新在线文档站点。
你是 CC Hub 项目的文档维护专家。请根据变更报告更新在线文档站点。

## 变更报告

Expand Down Expand Up @@ -45,12 +45,12 @@ title: 更新日志
nextjs:
metadata:
title: 更新日志
description: Claude Code Hub 各版本更新记录
description: CC Hub 各版本更新记录
---

# 更新日志

本页面记录 Claude Code Hub 各版本的更新内容。
本页面记录 CC Hub 各版本的更新内容。

---

Expand Down
2 changes: 1 addition & 1 deletion .github/prompts/release-analysis.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Release 变更分析 Prompt

你是 Claude Code Hub 项目的发布文档专家。请分析以下代码变更并生成结构化的变更报告。
你是 CC Hub 项目的发布文档专家。请分析以下代码变更并生成结构化的变更报告。

## 版本信息

Expand Down
4 changes: 2 additions & 2 deletions .github/prompts/release-notes.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# GitHub Release Notes 生成 Prompt

你是 Claude Code Hub 项目的发布说明撰写专家。请根据变更报告生成适合 GitHub Release 的发布说明。
你是 CC Hub 项目的发布说明撰写专家。请根据变更报告生成适合 GitHub Release 的发布说明。

## 变更报告

Expand All @@ -23,7 +23,7 @@
### 2. 格式模板

```markdown
## Claude Code Hub {{ VERSION }}
## CC Hub {{ VERSION }}

{{ SUMMARY }}

Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/claude-unified-docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ jobs:
github_token: ${{ secrets.GITHUB_TOKEN || secrets.GH_PAT }}

prompt: |
你是 Claude Code Hub 项目的发布文档专家。请执行完整的文档更新流程。
你是 CC Hub 项目的发布文档专家。请执行完整的文档更新流程。
## 发布信息
Expand Down
6 changes: 3 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@

### 1. 介绍 Introduction

Claude Code Hub 是一个面向团队的 AI API 代理平台,支持统一管理多家供应商、智能分流和现代化运维工具。本文档说明如何按照项目既定流程参与贡献,帮助你提交高质量的 Pull Request(PR)。
CC Hub 是一个面向团队的 AI API 代理平台,支持统一管理多家供应商、智能分流和现代化运维工具。本文档说明如何按照项目既定流程参与贡献,帮助你提交高质量的 Pull Request(PR)。

### 2. 行为准则 Code of Conduct

Expand Down Expand Up @@ -166,7 +166,7 @@ docker compose build

### 1. Introduction

Claude Code Hub centralizes multiple AI providers with smart routing, tenant controls, and observability. This document explains how to deliver high-quality Pull Requests (PRs) that align with the project roadmap.
CC Hub centralizes multiple AI providers with smart routing, tenant controls, and observability. This document explains how to deliver high-quality Pull Requests (PRs) that align with the project roadmap.

### 2. Code of Conduct

Expand Down Expand Up @@ -272,4 +272,4 @@ GitHub Actions runs `Docker Build Test` on every PR to `dev` and `main`; see `.g

---

感谢你为 Claude Code Hub 做出的贡献!Thanks for helping improve Claude Code Hub!
感谢你为 CC Hub 做出的贡献!Thanks for helping improve CC Hub!
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# ================================
# Claude Code Hub - 根目录快捷命令
# CC Hub - 根目录快捷命令
# ================================
#
# 这个 Makefile 将命令转发到 dev/Makefile
Expand Down
12 changes: 8 additions & 4 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

<div align="center">

# Claude Code Hub
# CC Hub

**🚀 Intelligent AI API relay platform — the control center for multi-provider onboarding, elastic routing, and granular operations**

Expand All @@ -14,7 +14,7 @@
[![Telegram Group](https://img.shields.io/badge/Telegram-Join%20Group-blue?logo=telegram)](https://t.me/ygxz_group)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ding113/claude-code-hub)

Claude Code Hub combines Next.js 15, Hono, PostgreSQL, and Redis to deliver a Claude/OpenAI-compatible API gateway with smart load balancing, live observability, price governance, and automated documentation, enabling teams to manage multiple AI vendors safely and transparently.
CC Hub combines Next.js 16, Hono, PostgreSQL, and Redis to deliver a Claude/OpenAI-compatible API gateway with smart load balancing, live observability, price governance, and automated documentation, enabling teams to manage multiple AI vendors safely and transparently.

💬 **Join the discussion**: Questions about deployment, features or technical issues? Join our [Telegram community](https://t.me/ygxz_group)!

Expand All @@ -25,7 +25,7 @@ Claude Code Hub combines Next.js 15, Hono, PostgreSQL, and Redis to deliver a Cl
> [!IMPORTANT]
> **This project is currently under active refactoring**
>
> Claude Code Hub Plus, the refactored version of Claude Code Hub, is expected to be open-sourced under the AGPL license in Q3. Claude Code Hub Plus is dedicated to building a high-performance, stable, commercial-grade LLM gateway, offering comprehensive commercial features such as format conversion, privacy filtering, a model marketplace, and top-up billing, while significantly improving the theoretical performance of the forwarding core. During development of the refactored version, progress and community support for the Node.js version may be delayed — thank you for your understanding.
> CC Hub Plus, the refactored version of CC Hub, is expected to be open-sourced under the AGPL license in Q3. CC Hub Plus is dedicated to building a high-performance, stable, commercial-grade LLM gateway, offering comprehensive commercial features such as format conversion, privacy filtering, a model marketplace, and top-up billing, while significantly improving the theoretical performance of the forwarding core. During development of the refactored version, progress and community support for the Node.js version may be delayed — thank you for your understanding.

<table>
<tr>
Expand Down Expand Up @@ -233,7 +233,7 @@ Once started:
Clients / CLI / Integrations
Next.js 15 App Router (v1 API routes)
Next.js 16 App Router (v1 API routes)
Hono + Proxy Pipeline (Auth → Session Allocation → Rate Limiting → Provider Selection → Forwarding → Response Handling)
Expand Down Expand Up @@ -392,3 +392,7 @@ This project builds on [zsio/claude-code-hub](https://github.com/zsio/claude-cod
## 📜 License

Released under the [MIT License](LICENSE). You’re welcome to use and extend the project as long as you comply with the license and retain the attribution.

---

<sub>CC Hub is not an official Anthropic project and is not affiliated with Anthropic. Claude Code and Claude are trademarks of Anthropic.</sub>
12 changes: 8 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

<div align="center">

# Claude Code Hub
# CC Hub

**🚀 智能 AI API 代理中转服务平台|面向团队的多供应商统一接入、弹性调度与精细化运营中心**

Expand All @@ -14,7 +14,7 @@
[![Telegram Group](https://img.shields.io/badge/Telegram-交流群-blue?logo=telegram)](https://t.me/ygxz_group)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ding113/claude-code-hub)

Claude Code Hub 通过 Next.js 15 + Hono + PostgreSQL + Redis 组合,实现 Claude/OpenAI 兼容 API 代理、智能负载均衡、实时监控、价格管理与自动化文档,帮助团队安全、可观测地管理多家 AI 服务商。
CC Hub 通过 Next.js 16 + Hono + PostgreSQL + Redis 组合,实现 Claude/OpenAI 兼容 API 代理、智能负载均衡、实时监控、价格管理与自动化文档,帮助团队安全、可观测地管理多家 AI 服务商。

💬 **加入讨论**:有部署、功能或技术问题?欢迎加入 [Telegram 交流群](https://t.me/ygxz_group) 与社区一起讨论!

Expand All @@ -25,7 +25,7 @@ Claude Code Hub 通过 Next.js 15 + Hono + PostgreSQL + Redis 组合,实现 Cl
> [!IMPORTANT]
> **当前项目正处于积极重构阶段**
>
> Claude Code Hub 的重构版本 Claude Code Hub Plus 预计将于第三季度以 AGPL 形式开源。Claude Code Hub Plus 致力于打造高性能、稳定的商用级 LLM 网关,提供格式转换、隐私过滤、模型广场、充值计费等完善的商用功能,并显著提升转发核心的理论性能。重构版本开发期间,Node.js 版本的开发进度和社区支持可能延误,敬请理解。
> CC Hub 的重构版本 CC Hub Plus 预计将于第三季度以 AGPL 形式开源。CC Hub Plus 致力于打造高性能、稳定的商用级 LLM 网关,提供格式转换、隐私过滤、模型广场、充值计费等完善的商用功能,并显著提升转发核心的理论性能。重构版本开发期间,Node.js 版本的开发进度和社区支持可能延误,敬请理解。

<table>
<tr>
Expand Down Expand Up @@ -238,7 +238,7 @@ Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
客户端 / CLI / 第三方系统
Next.js 15 App Router (v1 API 路由)
Next.js 16 App Router (v1 API 路由)
Hono + Proxy Pipeline (认证 → Session 分配 → 限流 → 供应商选择 → 请求转发 → 响应处理)
Expand Down Expand Up @@ -405,3 +405,7 @@ cch doctor # 诊断集群与部署状态
## 📜 许可证 License

本项目采用 [MIT License](LICENSE),可自由使用与二次开发,仍需遵守条款并保留致谢信息。

---

<sub>CC Hub 并非 Anthropic 官方项目,与其无任何关联。Claude Code、Claude 等均属 Anthropic 公司的商标。</sub>
2 changes: 1 addition & 1 deletion deploy/k8s/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Claude Code Hub — K8s Manifests
# CC Hub — K8s Manifests

本目录是 Kubernetes 部署清单模板,由 `scripts/deploy-k8s.sh` 在部署时做占位符替换后下发到集群。
不建议直接 `kubectl apply -f` 本目录 — 文件中包含 `{{VAR}}` 占位符,需先渲染。
Expand Down
4 changes: 2 additions & 2 deletions dev/Makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# ================================
# Claude Code Hub - dev 工具链
# CC Hub - dev 工具链
# ================================
#
# 目标:
Expand Down Expand Up @@ -35,7 +35,7 @@ LOCAL_REDIS_URL ?= redis://$(REDIS_HOST):$(REDIS_PORT)

help:
@echo ""
@echo "Claude Code Hub - dev 工具链"
@echo "CC Hub - dev 工具链"
@echo ""
@echo "常用命令:"
@echo " make db 启动 PostgreSQL + Redis(Docker)"
Expand Down
4 changes: 2 additions & 2 deletions docs/api-authentication-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 概述

Claude Code Hub 的新版管理 API 位于 `/api/v1/*`。它和代理 API `/v1/*`
CC Hub 的新版管理 API 位于 `/api/v1/*`。它和代理 API `/v1/*`
互相独立,也和已弃用的 Server Action 适配层 `/api/actions/*` 独立。

新版管理 API 支持三种凭据传递方式:
Expand Down Expand Up @@ -35,7 +35,7 @@ Cookie 认证的写操作需要 CSRF 保护:先调用 `GET /api/v1/auth/csrf`

适合浏览器内测试和 Scalar/Swagger UI。

1. 访问 Claude Code Hub 登录页面。
1. 访问 CC Hub 登录页面。
2. 使用 `ADMIN_TOKEN` 或允许 Web UI 登录的用户 API Key 登录。
3. 浏览器会设置 `auth-token` Cookie。
4. 在同一浏览器访问 `/api/v1/scalar` 或 `/api/v1/docs`,文档页会自动携带
Expand Down
2 changes: 1 addition & 1 deletion docs/api-docs-summary.md
Original file line number Diff line number Diff line change
Expand Up @@ -158,5 +158,5 @@ $ bun run typecheck

---

**维护者**: Claude Code Hub Team
**维护者**: CC Hub Team
**最后更新**: 2025-12-17
2 changes: 1 addition & 1 deletion docs/api/v1/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Management REST API v1

`/api/v1/*` is the REST management API for Claude Code Hub. Its HTTP surface is
`/api/v1/*` is the REST management API for CC Hub. Its HTTP surface is
mounted separately from:

- `/v1/*`: Claude/OpenAI-compatible proxy endpoints.
Expand Down
14 changes: 7 additions & 7 deletions docs/architecture-claude-code-hub-2025-11-29.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

## Document Overview

This document defines the system architecture for Claude Code Hub. It provides the technical blueprint for implementation, addressing all functional and non-functional requirements from the PRD.
This document defines the system architecture for CC Hub. It provides the technical blueprint for implementation, addressing all functional and non-functional requirements from the PRD.

**Related Documents:**

Expand All @@ -22,7 +22,7 @@ This document defines the system architecture for Claude Code Hub. It provides t

## Executive Summary

Claude Code Hub (CCH) is an intelligent AI API proxy platform built on a **Modular Monolith** architecture using Next.js 15 with App Router and Hono. The system provides multi-provider management, intelligent load balancing, circuit breaker patterns, and comprehensive monitoring for AI coding tools like Claude Code and Codex.
CC Hub (CCH) is an intelligent AI API proxy platform built on a **Modular Monolith** architecture using Next.js 16 with App Router and Hono. The system provides multi-provider management, intelligent load balancing, circuit breaker patterns, and comprehensive monitoring for AI coding tools like Claude Code and Codex.

The architecture emphasizes:

Expand Down Expand Up @@ -61,7 +61,7 @@ These requirements heavily influence architectural decisions:

### High-Level Architecture

Claude Code Hub follows a **Modular Monolith** pattern with clear internal boundaries:
CC Hub follows a **Modular Monolith** pattern with clear internal boundaries:

```
┌─────────────────────────────────────────────────────────────────────────────┐
Expand All @@ -75,7 +75,7 @@ Claude Code Hub follows a **Modular Monolith** pattern with clear internal bound
┌─────────────────────────────────────────────────────────────────────────────┐
│ API GATEWAY LAYER │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Next.js 15 + Hono Router │ │
│ │ Next.js 16 + Hono Router │ │
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
│ │ │ /v1/ │ │ /api/ │ │ /settings │ │ /dashboard│ │ │
│ │ │ messages │ │ actions │ │ (UI) │ │ (UI) │ │ │
Expand Down Expand Up @@ -217,11 +217,11 @@ flowchart TB

### Frontend

**Choice:** Next.js 15 (App Router) + React 19 + Tailwind CSS + shadcn/ui
**Choice:** Next.js 16 (App Router) + React 19 + Tailwind CSS + shadcn/ui

**Rationale:**

- **Next.js 15**: Latest stable with App Router, Server Components, and Server Actions
- **Next.js 16**: Latest stable with App Router, Server Components, and Server Actions
- **React 19**: Latest features for optimal performance
- **Tailwind CSS**: Utility-first CSS for rapid UI development
- **shadcn/ui**: High-quality, accessible component library
Expand Down Expand Up @@ -1780,7 +1780,7 @@ _To continue: Run `/workflow-status` to see your progress and next recommended w

| Category | Choice | Alternatives Considered | Key Factor |
| ---------- | ---------- | ----------------------- | -------------------------- |
| Framework | Next.js 15 | Remix, Nuxt | SSR + API in one |
| Framework | Next.js 16 | Remix, Nuxt | SSR + API in one |
| Router | Hono | Express, Fastify | Performance |
| ORM | Drizzle | Prisma, TypeORM | Type safety + SQL |
| Database | PostgreSQL | MySQL, SQLite | JSON support + reliability |
Expand Down
4 changes: 2 additions & 2 deletions docs/k8s-deployment.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Kubernetes / k3s 部署指南

本文说明如何把 Claude Code Hub 部署到 Kubernetes(含轻量级 k3s)集群。若你只需要单机 Docker 部署,请参考 [`scripts/deploy.sh`](../scripts/deploy.sh) 与 [`docker-compose.yaml`](../docker-compose.yaml)。
本文说明如何把 CC Hub 部署到 Kubernetes(含轻量级 k3s)集群。若你只需要单机 Docker 部署,请参考 [`scripts/deploy.sh`](../scripts/deploy.sh) 与 [`docker-compose.yaml`](../docker-compose.yaml)。

---

Expand Down Expand Up @@ -106,7 +106,7 @@ bash scripts/deploy-k8s.sh --install-k3s -y

```console
+================================================================+
| Claude Code Hub Deployment Complete! |
| CC Hub Deployment Complete! |
+================================================================+

Access URL: http://<node-ip>:<nodeport>
Expand Down
Loading
Loading