huigen. 慧根 API

第一次用，也能轻松接好

选好 AI，
接下来的交给助手。

不用找配置文件，也不用手填接口地址。下载慧根配置助手，在自己的电脑粘贴一次 API 令牌，即可连接 Codex 或 Claude Code。

开始一键配置

适用于官方命令行客户端（CLI）。配置助手会为慧根建立独立配置。

  1. 登录，准备余额

    登录慧根，在钱包充值。已有可用余额可以直接下一步。

    登录并打开钱包

  2. 创建一枚令牌

    在「API 令牌」新建令牌：Codex 选 Codex 分组，Claude Code 选 Claude 分组。创建后复制令牌。

    创建 API 令牌

  3. 下载，打开，粘贴

    选择下面的客户端和电脑系统。打开助手后，在本机按提示粘贴令牌，助手完成连接配置。

    选择配置助手

一键接入

你准备使用哪个 AI？

令牌只在你的电脑输入

Codex 分组 · gpt-6.1-sol

Windows 下载后双击 .cmd 文件即可打开配置助手。

打开助手后，跟着做就好

  1. 选择项目文件夹

    第一次直接按回车，使用助手准备的默认文件夹；也可以填写你已有项目的文件夹路径。

  2. 确认安装客户端

    缺少客户端时，经你确认后安装官方软件。尚缺 Node.js 等运行依赖时，按助手的中文提示处理，再次打开即可。

  3. 粘贴令牌，开始使用

    粘贴 Codex 分组的 API 令牌。隐藏输入时屏幕不会出现字符，粘贴后按回车即可。

    地址和模型由助手填好；以后可复用已保存的令牌。

令牌会保存在本机慧根配置目录，并限制为当前用户访问。本页面没有令牌输入框；不要把令牌发到聊天或截图中。

配置助手保留客户端原有的操作确认与权限设置。桌面 App、编辑器插件需要按各自的方式配置。

第一次接入，你可能想问

几件小事，先说明白。

为什么显示美元？怎么换算人民币？

慧根 API 当前使用 USD 作为站内额度显示单位。根据当前系统设置，1 美元额度按 ¥7.3 折算，例如 10 美元额度对应 ¥73。这里是站内额度换算口径，不代表实时外汇报价；实际充值金额和到账额度以充值订单显示为准。模型调用按价格页所列规则扣减额度。

API 令牌是什么？在哪里创建？

API 令牌是客户端使用你账户余额的凭证。登录后打开「API 令牌」，新建并复制令牌。它与网站登录密码不同；配置助手需要的是令牌。

给令牌设置你能接受的额度上限即可。使用 Codex 和 Claude Code 时，建议分别创建、分别命名。

Codex 和 Claude 为什么要选不同分组？

两个客户端使用各自的模型与接入协议。Codex 助手使用 Codex 分组令牌；Claude Code 助手使用 Claude 分组令牌。分组不匹配时，可能出现模型不可用或渠道错误。

电脑什么都没装，也能用吗？

助手会检查官方客户端；缺少时，经你确认后尝试安装。客户端安装需要网络与合适的 Node.js 环境。若助手提示缺少依赖，按提示完成安装后重新打开助手。

Node.js 官方下载 ↗ · Codex 官方说明 ↗ · Claude Code 官方说明 ↗

以后怎么启动？怎么更换令牌？

保留下载的助手文件，以后打开它即可复用慧根配置。需要换令牌时，按助手里的更换提示重新输入。Windows 可以把助手文件放到方便找到的文件夹，再为它创建桌面快捷方式。

如果更换了项目文件夹，在助手提示时选择新项目；macOS／Linux 也可以先在项目目录打开终端，再运行助手。

会覆盖我原来的配置吗？怎么取消接入？

助手把慧根连接信息放在单独的用户配置目录中，保留原客户端配置。直接按你原来的方式启动客户端，可继续使用原配置。

需要彻底移除时，先退出通过助手启动的客户端，再只移除慧根自己的配置目录。Windows 位于 %LOCALAPPDATA%\Huigen\Codex 或 %LOCALAPPDATA%\Huigen\Claude；macOS／Linux 位于 ~/.local/share/huigen/codex 或 ~/.local/share/huigen/claude。不要删除其他客户端目录。怀疑令牌泄露时，在令牌管理中撤销它。

已经启动了，还是报错怎么办？

401：核对令牌是否完整、已启用且未过期。余额不足：同时检查钱包余额和令牌额度。模型不可用：优先核对令牌分组。

Claude Code 可运行 /status 查看连接状态。如果助手发现项目配置冲突，请按它显示的文件位置处理，再重开助手。

到「使用日志」查看请求记录；仍需帮助时，向 QQ 客服 3685583021 提供时间、状态码与脱敏截图。

已有使用经验？查看连接参数、脚本和临时启动方式

以下内容随上方客户端和系统选择同步更新。首次接入使用上方配置助手即可。

连接参数

Codex 使用 Responses 协议，地址为 https://huigen.xyz/v1。

查看配置助手内容

这里展示下载助手中的配置脚本，不包含真实令牌。

展开配置脚本

仅本次会话使用

临时启动器不会保存令牌，每次运行都需要重新输入。它与上方会保存本机配置的助手是两种方式。

展开临时启动脚本