CodexHub CN 使用说明

CodexHub CN 是一款面向国内用户的 AI 模型聚合与智能路由平台。它汇集了国内外主流大语言模型，提供统一的 API 接口和友好的图形界面，让开发者无需为每个模型单独注册和对接，一站式完成模型调用与管理。

快速导航

• 什么是 CodexHub CN
• 快速开始
• API 使用指南
• 智能路由
• 个性化设置
• 常见问题

什么是 CodexHub CN

CodexHub CN 定位为「软件厂商 + 模型厂商 + C端用户」的三方桥梁。它解决的核心痛点是：

• 免登录 —— 不需要为每个 AI 模型注册账户
• 国内直连 —— 无需科学上网即可访问海外模型
• 智能路由 —— 根据任务类型自动选择最合适的模型
• 统一 API —— 使用一套标准格式对接所有模型

快速开始

系统要求

• 操作系统：Windows 10+ / macOS 13+ / Linux（Ubuntu 20.04+ 推荐）
• 网络：能够正常访问国内互联网
• 依赖：Node.js 18+、Python 3.9+（仅 API 中转模块需要）

安装步骤

1. 下载安装包

   从官网 codexhubcn.com 下载对应操作系统的安装包。

2. 安装运行

   # 解压后进入目录
   cd codexhub-cn
   
   # 启动服务
   ./codexhub-cn start
   
   # 查看状态
   ./codexhub-cn status
   

3. 访问界面

   启动后浏览器打开 http://localhost:3000 即可进入 CodexHub CN 主界面。

4. 配置 API Key

   在设置页面添加你的模型 API Key（如 DeepSeek、智谱、Anthropic 等），或使用内置的临时体验额度。

API 使用指南

CodexHub CN 提供兼容 OpenAI API 格式的接口，让你现有工具和代码可以无缝迁移。

标准 API 端点

# Chat Completions
curl https://api.codexhubcn.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好"}]
  }'

支持模型列表

模型名称	厂商	特点
deepseek-chat	DeepSeek	综合能力强，性价比高
deepseek-reasoner	DeepSeek	推理能力强，适合复杂逻辑
glm-4-plus	智谱 AI	中文理解优秀，适合国产化场景
claude-sonnet-4-6	Anthropic	编程和长文本处理

API 格式转换

CodexHub CN 内置请求格式转换引擎，自动将 OpenAI 格式转换为各模型的私有格式：

• Anthropic 格式：自动将 /v1/chat/completions 转换为 /v1/messages
• 智谱格式：自动处理 SSE 流式响应差异
• DeepSeek 格式：原生兼容 OpenAI 格式，无需转换

智能路由

CodexHub CN 的智能路由功能可以根据任务类型自动选择最合适的模型，无需手动指定。

路由策略

任务类型	默认路由模型	说明
聊天对话	deepseek-chat	日常对话、问答
代码生成	claude-sonnet-4-6	编程、代码审查、重构
数学推理	deepseek-reasoner	复杂逻辑推理、数学题
中文创作	glm-4-plus	中文文章、文案、创意

自定义路由规则

你可以在设置中自定义路由规则，例如：

{
  "routing": {
    "default": "deepseek-chat",
    "overrides": [
      {"pattern": "代码审查", "model": "claude-sonnet-4-6"},
      {"pattern": "翻译", "model": "glm-4-plus"}
    ],
    "fallback": "deepseek-chat"
  }
}

个性化设置

API Key 管理

• 支持多个 API Key 轮询
• 自动检测失效 Key 并切换
• 额度监控和预警

界面偏好

• 主题色：默认蓝色（#1d4ed8），支持自定义
• 语言：中文（简体）/ English
• 显示模式：浅色 / 深色 / 跟随系统

代理设置

部分国内网络环境可能需要配置代理访问海外模型：

# 环境变量方式
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 或在配置文件中设置
./codexhub-cn config set proxy http://127.0.0.1:7890

常见问题

Q: 为什么需要安装本地代理？

本地代理负责 API 格式转换和请求路由，所有请求经本地代理转发出站，数据仅在本地中转，不存储任何会话内容。

Q: CodexHub CN 会保存我的对话吗？

不会。CodexHub CN 仅做请求转发，不存储用户的对话记录。所有对话数据直接传递给目标模型 API 服务。

Q: 支持哪些国产模型？

目前已支持 DeepSeek、智谱 AI、通义千问（即将上线）、文心一言（即将上线）。

Q: 遇到连接问题时怎么办？

首先检查本地代理是否正常运行，然后检查 API Key 是否有效。如果问题持续，可以查看运行日志：./codexhub-cn logs。

Q: 如何获取帮助？

可以访问我们的 帮助中心，或发送邮件至 support@codexhubcn.com。

---

文档版本：v1.0 | 最后更新：2026-07-18