使用手册

CodexHub CN 使用手册

2026-07-18 · 使用手册

📖 版本 v0.1.2 · 2026-07-18

CodexHub CN 使用手册

> 版本：v0.1.2 | 更新：2026-07-18 | 官网：https://agent.eake.cn/codexhub-cn/

1. 产品简介

1.1 什么是 CodexHub CN

CodexHub CN（CodexHub 中国版）是一款AI CLI 配置管理器，帮助开发者统一管理多款主流 AI Coding 工具的 API 配置，通过国内大模型 API 实现本地化工作流。

1.2 核心能力

能力	说明
🔧 统一管理	同时管理 8 款 AI CLI 工具的配置
🔄 一键切换	在不同 Provider/模型之间秒级切换
💰 Token 统计	实时记录每次 API 调用的用量与费用
🔌 MCP 扩展	支持 MCP 服务器扩展工具能力
🎯 技能市场	安装社区技能包，扩展工具能力
🛡️ 本地路由	本地代理网关，API Key 不出本机
📊 账本功能	记录使用账目，帮助成本管控
🖥️ 截图工具	内置截图工具，辅助信息提取

1.3 支持的 CLI 工具

工具	安装命令	官方文档
Claude Code	`npm install -g @anthropic-ai/claude-code`	<a href="https://code.claude.com/docs/en/cli-reference" target="blank" rel="noopener">官方文档
Claude Desktop	<a href="https://claude.com/download" target="blank" rel="noopener">官方下载	<a href="https://docs.anthropic.com/zh-CN/docs/claude-desktop" target="blank" rel="noopener">官方文档
Codex CLI	`npm install -g @openai/codex`	<a href="https://github.com/openai/codex" target="blank" rel="noopener">GitHub
Gemini CLI	`npm install -g @google/gemini-cli`	<a href="https://www.npmjs.com/package/@google/gemini-cli" target="blank" rel="noopener">npm
OpenCode	`npm install -g opencode-ai`	<a href="https://github.com/opencode-ai/opencode" target="blank" rel="noopener">GitHub
OpenClaw	`npm install -g openclaw`	<a href="https://openclaw.ai" target="blank" rel="noopener">官网
Hermes Agent	`npm install -g hermes-agent`	<a href="https://github.com/NousResearch/hermes-agent" target="blank" rel="noopener">GitHub
DeepSeek CLI	`npm install -g deepseek`	GitHub

1.4 系统要求

操作系统：Windows 10/11（x64）

磁盘空间：200MB+

网络：需要访问目标 API（部分 Provider 需国际网络）

2. 下载与安装

2.1 下载地址

官网下载地址：https://agent.eake.cn/codexhub-cn/

提供三种安装包：

类型	文件名	说明
🪟 NSIS 安装包	`CodexHub CNx.x.xx64-setup.exe`	推荐，标准 Windows 安装向导
📦 MSI 安装包	`CodexHub CNx.x.xx64zh-CN.msi`	企业部署用，支持静默安装
💿 免安装版	`CodexHub CNx.x.x_x64-portable.zip`	解压即用，无需安装

2.2 安装步骤

NSIS 安装包（推荐）：

下载 .exe 安装包

双击运行，点击「下一步」

选择安装路径（建议保持默认 C:Program FilesCodexHub CN）

点击「安装」，等待完成

点击「完成」，启动 CodexHub CN

MSI 企业部署：

msiexec /i "CodexHub CNx.x.xx64_zh-CN.msi" /quiet

卸载方法：

开始菜单 → CodexHub CN → 卸载

或 Windows「设置」→「应用」→ 找到 CodexHub CN → 卸载

3. 首次启动

3.1 启动流程

首次启动会依次显示：

启动遮罩（约 7 秒）

- 显示进度条和加载提示

- 自动检测环境状态

环境检测

- 检测 Node.js 是否安装

- 检测各 CLI 工具是否已安装

- 检测 npm 全局目录

风险协议确认

- 首次必须阅读并勾选免责声明

- 双勾选后点击「我已阅读并同意」方可进入

欢迎/主界面

- 如果检测到未安装的工具，显示安装引导

- 如果环境正常，直接进入主界面

3.2 首次环境配置

启动后，CodexHub CN 会自动检测已安装的工具。未安装的工具会显示为红色状态，参考以下方式安装：

方式一：通过 CodexHub CN 一键安装

在工具列表中找到未安装的工具，点击绿色的「安装」按钮。

方式二：通过 npm 安装

npm install -g @anthropic-ai/claude-code npm install -g @openai/codex npm install -g @google/gemini-cli npm install -g opencode-ai npm install -g hermes-agent

npm install -g deepseek

> ⚠️ 注意：Claude Desktop 是图形化应用，需从官网下载安装包，不能通过 npm 安装。

4. 界面概览

4.1 主界面结构

┌──────────────────────────────────────────────────────────┐ │ [工具图标] CodexHub CN [⚙️] [💬] [🖼️] [📊] │ ← 顶部工具栏 ├──────────┬───────────────────────────────────────────────┤ │ │ │ │ 工具列表 │ 主视图区域 │ │ (左侧) │ ┌─────────────────────────────────────────┐ │ │ │ │ 欢迎使用 CodexHub CN │ │ │ Claude │ │ ───────────────────────────── │ │ │ Claude │ │ 当前工具：Claude Code │ │ │ Desktop │ │ 模型：claude-sonnet-4-6 │ │ │ Codex │ │ Provider：Eake API │ │ │ Gemini │ └─────────────────────────────────────────┘ │ │ CLI │ │ │ OpenCode│ ┌─────────────────────────────────────────┐ │ │ OpenClaw│ │ 💬 聊天 / 📝 终端切换 │ │ │ Hermes │ └─────────────────────────────────────────┘ │ │ DeepSeek│ │ │ │ ┌─────────────────────────────────────────┐ │ │ ────── │ │ [对话内容区域] │ │ │ [➕] │ │ │ │ │ │ └─────────────────────────────────────────┘ │ ├──────────┴───────────────────────────────────────────────┤ │ Provider: Eake API | 模型: claude-sonnet-4-6 | Token 1.2K │ ← 底部状态栏

└──────────────────────────────────────────────────────────┘

4.2 顶部工具栏

图标	名称	功能
⚙️	设置	主题切换、缓存清理、关于
💬	反馈	提交问题或建议
🖼️	截图	启动截图工具（三件套）
📊	账本	查看使用账目与成本
🧩	技能	打开技能市场
🔌	MCP	管理 MCP 服务器
🤖	Agent	Agent 管理（版本升级等）
📦	安装工具	一键安装缺失的 CLI
🌐	Provider	添加/管理 API Provider
📢	公告	查看官方公告
☕	捐赠	支持项目发展

4.3 底部状态栏

显示当前活跃的：

Provider：当前使用的 API 来源

模型：当前选中的模型

Token：本次会话累计 Token 消耗（点击可展开详情）

5. 工具管理

5.1 工具列表

左侧栏列出了所有 8 款支持的 CLI 工具。每款工具的状态指示：

状态	颜色	含义
🟢 绿色	工具已安装且可用	正常
🔴 红色	工具未安装	需安装
🟡 黄色	工具已安装但无法运行	检查 PATH 或版本
🟠 橙色	可升级	有新版本可用

5.2 一键安装

对于未安装的工具，点击工具卡片右侧的「安装」按钮，CodexHub CN 会自动调用 npm 安装对应工具包。

安装过程：

[████████████████████░░░░░] 80% — 安装 npm 包中...

5.3 版本检测

点击工具卡片的「🔄 刷新」按钮，可以重新检测该工具的本地版本和 npm 最新版本。

判断逻辑：

localVersion === npmVersion → 🟢 已是最新版

localVersion < npmVersion → 🟠 可升级

localVersion === null → 🔴 未安装

获取 npm 版本失败 → 🟡 检测失败

5.4 一键升级

在工具列表中点击「全部升级」按钮，CodexHub CN 会自动将所有已安装但有可用更新的工具升级到最新版本。

5.5 诊断冲突

点击「🔎 一键检测」按钮，CodexHub CN 会扫描系统 PATH 和 npm 全局目录，检测以下问题：

同一工具多处安装（PATH 重复）

安装路径异常

版本不一致

命令无法直接运行

诊断结果以弹窗展示，显示每个工具的安装位置、版本和可运行状态。

5.6 卸载工具

在工具卡片上悬停，点击出现的「🗑️ 卸载」按钮。

> ⚠️ 注意：卸载操作只移除 npm 全局包，不影响本地项目中的安装。

6. Provider 与模型配置

6.1 什么是 Provider

Provider（服务商） 是 API 的来源。每个 Provider 包含：

名称（如「火山引擎」「Eake API」）

API 地址（Base URL）

API Key

可用模型列表

6.2 添加新 Provider

点击顶部「🌐 Provider」按钮 → 「➕ 添加 Provider」：

名称：填入服务商名称（如「我的火山引擎」）

Base URL：API 接口地址（需包含 /v1 路径，如 https://ark.cn-beijing.volcengineapi.com/v1）

API Key：粘贴对应的 Key

图标：选择代表该 Provider 的 emoji 或图标

分类：Domestic（国内）/ International（国际）

点击「保存」。

6.3 模型选择

切换 Provider 后，点击模型下拉菜单可以看到该 Provider 支持的所有模型。

模型旁的标记含义：

标记	含义
✅ 绿色	支持 Function Calling（工具调用）
🟇 黄色	支持聊天，但不支持工具调用
❌ 红色	不支持聊天（嵌入/视觉/音频等专用模型）

能力标签：

代码 — 擅长代码生成

推理 — 深度推理能力

轻量 — 快速响应

多模态 — 支持图文

长上下文 — 超长上下文窗口

6.4 一键配置

对于常用的 Provider（如 Eake API、火山引擎等），CodexHub CN 提供了「一键配置」功能。

点击「🌐 Provider」→「⚡ 一键配置」，选择目标 Provider，填入 API Key，即可快速完成配置。

6.5 API Key 安全提示

API Key 不出本机：CodexHub CN 内置本地代理网关，所有 API 请求通过本地转发，Key 不明文暴露

Provider 隔离：不同 Provider 的 Key 独立存储，互不干扰

Key 隐藏：API Key 在界面上默认以 •••••••• 显示，点击眼睛图标可查看

7. 聊天界面

7.1 聊天模式

CodexHub CN 内置流式聊天，由 Rust 后端直接调用 API，将响应实时流式返回前端显示。

特点：

实时流式输出，无需等待完整响应

Markdown 代码高亮

支持表格、GFM 任务列表

深色/浅色主题自适应

7.2 对话管理

新建对话：点击输入框旁的「➕」或发送任意消息

对话历史：左侧列表，按工具分组

搜索历史：输入框上方搜索框搜索历史记录

清除对话：输入 /clear 或点击工具栏清除按钮

7.3 会话持久化

CodexHub CN 自动保存对话历史到本地 SQLite 数据库。下次打开同一工具时，自动加载上次会话。

8. 斜杠命令

8.1 通用命令

以下斜杠命令在各工具中通用：

命令	功能	适用工具
`/model`	切换模型	全部
`/help`	查看帮助	全部
`/clear`	清除对话	全部
`/cost`	Token 用量统计	全部
`/status`	查看当前状态	全部

8.2 Claude Code 专属命令

命令	功能
`/skills`	查看/安装技能
`/memory`	管理项目记忆（CLAUDE.md）
`/schedule`	设置定时任务
`/plan`	生成执行计划
`/compact`	压缩上下文，节省 Token
`/init`	初始化项目配置
`/review`	请求代码审查

8.3 Codex CLI 专属命令

命令	功能
`/goal`	设定长期目标
`/skills`	技能市场
`/init`	初始化项目
`/plan`	生成执行计划

8.4 Gemini CLI 专属命令

命令	功能
`/skills`	扩展/Skills
`/init`	初始化 GEMINI.md

8.5 OpenCode 专属命令

命令	功能
`/connect`	配置 API 提供商
`/docs`	搜索文档
`/skills`	Code Skills

8.6 OpenClaw / Hermes Agent 专属命令

命令	功能
`/model`	切换模型
`/terminal`	打开终端
`/skills`	技能市场
`/memory`	记忆管理
`/schedule`	定时任务
`/agent`	子 Agent

9. MCP 管理

9.1 什么是 MCP

MCP（Model Context Protocol） 是 Claude 官方推出的工具扩展协议，允许 AI 通过标准化接口调用外部工具（如数据库查询、Git 操作、API 调用等）。

9.2 MCP 预设市场

CodexHub CN 内置了常用 MCP 预设，点击「🔌 MCP」→「预设市场」，可以快速添加：

MCP 服务	说明
GitHub	GitHub API 操作（Issue、PR、文件）
PostgreSQL	数据库查询
Puppeteer	浏览器自动化
Filesystem	本地文件读写
搜索	搜索集成

9.3 添加自定义 MCP

点击「🔌 MCP」→「自定义」：

填写 MCP 服务名称

粘贴 MCP 服务器启动命令（通常是 npx @xxx/server-xxx）

点击「添加」

9.4 启动与停止

每个 MCP 服务器可独立启动/停止：

绿色 🟢 — 运行中

灰色 ⚪ — 已停止

红色 🔴 — 启动失败

10. 技能系统

10.1 什么是技能

技能（Skill） 是预置的 Markdown 指南文件，告诉 AI 如何处理特定任务。技能以自然语言触发，AI 会自动识别并应用。

示例技能：

code-review — 代码审查技能

firecrawl — 网页爬取技能

terminal-orchestration — 终端编排技能

10.2 技能市场

点击顶部「🧩 技能」按钮，进入技能市场：

分类筛选：全部 / 工具 / 效率 / 开发 / DevOps

安装技能：

在技能市场找到目标技能

点击「安装到 CodexHub CN」

等待安装完成（App 自动唤起并处理）

10.3 技能安装方式

方式	说明
npm 安装	安装为全局 npm 包，技能文件存储在 npm 包目录
ZIP 安装	下载技能 ZIP 包，解压到本地技能目录
纯展示	仅浏览，不安装

10.4 管理已安装技能

点击「🧩 技能」→「已安装」，可查看所有已安装技能。

11. 截图工具

11.1 功能概览

CodexHub CN 内置截图工具，提供三个核心功能：

功能	说明	快捷操作
截图	截取屏幕任意区域	点击顶部「🖼️」按钮
保存	双击选区保存截图	选中区域后双击
复制	复制到剪贴板	Ctrl+C 或点击复制按钮

11.2 使用方法

第一步：启动截图

点击顶部工具栏的「🖼️ 截图」按钮，屏幕变暗，出现十字光标。

第二步：绘制选区

鼠标拖拽：绘制矩形选区

8 个把手：选区四角和四边中点，可单独拖动调整大小

整框拖动：在选区内部按住拖动，可整体移动位置

最小尺寸：10×10 像素

第三步：保存

双击选区：自动裁剪并保存到本地图片目录

Ctrl+C：复制截图到剪贴板

Esc：取消截图

11.3 缩放与拖动技巧

操作	方法
调整宽度	拖动左右两侧中点把手
调整高度	拖动上下两侧中点把手
调整大小	拖动四角把手
移动选区	在选区内部拖动
等比缩放	拖动角把手时按住 Shift

12. 定时任务

12.1 功能说明

CodexHub CN 支持设置定时任务，在指定时间自动执行 AI 对话任务。

12.2 创建定时任务

在聊天界面输入框输入 /schedule

或点击顶部「📅」定时任务按钮

设置任务内容、触发时间和重复规则

保存

12.3 支持的触发规则

类型	说明
一次性	在指定时间执行一次
每天	每天固定时间执行
每周	每周指定星期几执行
Cron 表达式	自定义复杂触发规则

12.4 任务管理

在定时任务管理界面可以：

查看 — 查看所有已创建的任务

编辑 — 修改任务内容或触发时间

暂停 — 临时停止某个任务

删除 — 删除不再需要的任务

13. 账本功能

13.1 功能说明

账本记录每次 API 调用的详细费用，帮助追踪和控制使用成本。

13.2 访问账本

点击顶部「📊 账本」按钮。

13.3 账本内容

字段	说明
日期	调用发生的日期和时间
工具	使用的是哪款 CLI 工具
模型	调用的具体模型
输入 Token	发送给 API 的 Token 数
输出 Token	API 返回的 Token 数
费用	本次调用消耗的金额（按 Provider 单价计算）
Provider	API 来源

13.4 成本统计

账本顶部显示汇总数据：

今日消费：当天累计费用

本月消费：当月累计费用

总消费：所有记录累计费用

支持按 Provider、按工具、按时间段筛选。

14. Token 用量统计

14.1 实时统计

底部状态栏实时显示当前会话的 Token 消耗。点击展开详情：

指标	说明
输入 Token	Input Tokens
输出 Token	Output Tokens
缓存命中	Cache Hits（节省的费用）
当前费用	按 Provider 单价计算
会话时长	本次会话持续时间

14.2 历史统计

在「📊 账本」页面查看历史 Token 用量趋势图，支持按天/周/月聚合展示。

15. 设置与偏好

15.1 主题切换

点击「⚙️ 设置」→「🎨 主题」，在以下主题间切换：

主题	说明
🌙 深色（默认）	赛博朋克风格，cyan #00f0ff + purple #a855f7
☀️ 浅色	明亮主题，适合白天或高亮环境

15.2 清除缓存

点击「⚙️ 设置」→「🗑️ 清除缓存」，可清除：

WebView 缓存（解决界面显示异常）

临时文件

历史对话缓存

> 💡 提示：清除 WebView 缓存后，部分页面需要重新加载，请耐心等待。

15.3 诊断工具冲突

点击「⚙️ 设置」→「🔎 诊断工具冲突」，执行完整的环境诊断（等同于工具页的「一键检测」）。

15.4 关于 CodexHub CN

点击「⚙️ 设置」→「ℹ️ 关于」，查看：

当前版本号

更新日志

项目简介

开源许可

16. 反馈与捐赠

16.1 提交反馈

点击顶部「💬 反馈」按钮，填写：

反馈类型：Bug 问题 / 功能建议 / 其他

联系方式（选填）：邮箱或微信

详细描述：请尽量描述清楚问题现象、期望行为和复现步骤

16.2 捐赠支持

点击顶部「☕ 捐赠」按钮，支持项目发展。目前支持的捐赠方式：

💚 微信支付

💙 支付宝

17. 版本更新

17.1 检查更新

CodexHub CN 会在启动时自动检查更新。也可以手动检查：

点击「⚙️ 设置」→「🔄 检查更新」

17.2 更新弹窗

发现新版本时，会弹出更新提示：

显示当前版本和新版本号

显示更新日志

提供「立即下载」和「稍后」按钮

17.3 下载安装

点击「立即下载」后，CodexHub CN 会：

从官网下载最新安装包

显示下载进度条

下载完成后自动启动安装程序

覆盖安装当前版本（用户数据不丢失）

18. 常见问题

Q1：启动后显示白屏怎么办？

原因：WebView 缓存损坏

解决：

点击「⚙️ 设置」→「🗑️ 清除缓存」→「清除 WebView 缓存」

重启 CodexHub CN

如果仍有问题，手动删除 %LOCALAPPDATA%com.codexhubcn.appEBWebView 目录

Q2：工具显示红色"未安装"但已通过 npm 安装？

原因：npm 全局目录未加入系统 PATH

解决：

点击工具列表的「🔎 一键检测」

查看诊断结果中的安装路径

将 npm 全局路径（如 C:Users你的用户名AppDataRoamingnpm）加入系统 PATH

重启 CodexHub CN

Q3：聊天发送消息后没有响应？

排查步骤：

检查底部状态栏 Provider 是否配置了正确的 API Key

检查网络连接（部分 Provider 需要访问国际网络）

查看底部 Token 统计是否有报错信息

点击「⚙️ 设置」→「🔎 诊断工具冲突」检查环境

Q4：API Key 填了但模型下拉是空的？

原因：Provider 的 Base URL 格式不正确或 Key 无效

解决：

确认 Base URL 包含完整路径（必须以 /v1 结尾）

确认 API Key 格式正确（UUID / sk-xxx 等）

尝试重新保存 Provider

Q5：MCP 服务器启动失败？

常见原因：

npm 包未安装：运行 npm install -g @modelcontextprotocol/server-xxx

网络问题：部分 MCP 服务器需要从 npm 安装

权限不足：尝试以管理员身份启动 CodexHub CN

Q6：截图工具无法使用？

排查：

确保已安装 Tauri WebView2 运行时

检查是否被安全软件拦截

尝试重启 CodexHub CN

Q7：如何查看详细的 Token 用量和费用？

点击底部状态栏的 Token 数字，或点击顶部「📊 账本」，可以查看完整的调用明细和费用汇总。

Q8：想同时使用多个工具的多个 API Key？

CodexHub CN 支持添加多个 Provider，每个 Provider 独立存储 API Key。在工具配置中选择对应的 Provider 即可。

Q9：技能无法安装？

排查：

检查网络连接

确认 npm 可用（部分技能通过 npm 安装）

尝试 ZIP 方式安装（下载技能包后点击「从 ZIP 安装」）

Q10：卸载 CodexHub CN 后想重装，以前的设置会保留吗？

不会。卸载会清除所有用户数据（Provider 配置、对话历史、Token 统计等）。

如需备份，可手动导出：

对话历史存储在 %APPDATA%com.codexhubcn.app 目录下的 SQLite 数据库

Provider 配置存储在 providers.db

附录

A. 快捷键参考

快捷键	功能
`Ctrl + Shift + P`	打开命令面板
`Ctrl + L`	新建对话
`Ctrl + K`	搜索历史
`Esc`	取消截图 / 关闭弹窗
`Ctrl + C`	复制选区截图

B. 目录结构

%APPDATA%com.codexhubcn.app ├── providers.db # Provider 和 API Key 配置 ├── token_usage.db # Token 使用记录 ├── mcp_servers.json # MCP 服务器配置 ├── conversations # 对话历史 ├── skills # 已安装技能

└── logs # 日志文件

C. 联系与支持

官网：https://agent.eake.cn/codexhub-cn/

反馈：通过 App 内「💬 反馈」提交

技能提交：发送到 support@eake.cn

本手册最后更新于 2026-07-18，对应 CodexHub CN v0.1.2

← Firecraw… CodexHub… →

欢迎回来

创建账号

CodexHub CN 使用手册

CodexHub CN 使用手册

目录

1. 产品简介

1.1 什么是 CodexHub CN

1.2 核心能力

1.3 支持的 CLI 工具

1.4 系统要求

2. 下载与安装

2.1 下载地址

2.2 安装步骤

3. 首次启动

3.1 启动流程

3.2 首次环境配置

4. 界面概览

4.1 主界面结构

4.2 顶部工具栏

4.3 底部状态栏

5. 工具管理

5.1 工具列表

5.2 一键安装

5.3 版本检测

5.4 一键升级

5.5 诊断冲突

5.6 卸载工具

6. Provider 与模型配置

6.1 什么是 Provider

6.2 添加新 Provider

6.3 模型选择

6.4 一键配置

6.5 API Key 安全提示

7. 聊天界面

7.1 聊天模式

7.2 对话管理

7.3 会话持久化

8. 斜杠命令

8.1 通用命令

8.2 Claude Code 专属命令

8.3 Codex CLI 专属命令

8.4 Gemini CLI 专属命令

8.5 OpenCode 专属命令

8.6 OpenClaw / Hermes Agent 专属命令

9. MCP 管理

9.1 什么是 MCP

9.2 MCP 预设市场

9.3 添加自定义 MCP

9.4 启动与停止

10. 技能系统

10.1 什么是技能

10.2 技能市场

10.3 技能安装方式

10.4 管理已安装技能

11. 截图工具

11.1 功能概览

11.2 使用方法

11.3 缩放与拖动技巧

12. 定时任务

12.1 功能说明

12.2 创建定时任务

12.3 支持的触发规则

12.4 任务管理

13. 账本功能

13.1 功能说明

13.2 访问账本

13.3 账本内容

13.4 成本统计

14. Token 用量统计

14.1 实时统计

14.2 历史统计

15. 设置与偏好

15.1 主题切换

15.2 清除缓存

15.3 诊断工具冲突

15.4 关于 CodexHub CN

16. 反馈与捐赠

16.1 提交反馈

16.2 捐赠支持

17. 版本更新

发表评论取消回复