Skip to main content
为 GLM Coding Plan 用户统一管理与配置 Claude Code 等 CLI 工具的命令行助手。
NPM 包地址: @z_ai/coding-helper
前提条件: Node.js >= v18.0.0

​
工具简介

Coding Tool Helper （一键安装小助手）是一个编码工具助手，快速将您的 GLM 编码套餐加载到您喜爱的编码工具中。安装并运行它，按照界面提示操作即可自动完成工具安装，套餐配置，MCP 服务器管理，Claude Code 插件市场等。 当前编码工具支持：
  • Claude Code
  • OpenCode
  • Crush
  • Factory Droid
当前插件市场支持:

​
功能特性

交互式向导

友好的设置引导

套餐集成

将 GLM 套餐接入喜爱的编码工具

工具管理

自动检测、安装和配置编码工具

MCP 配置

轻松管理 MCP 服务

插件市场

内置 Claude Code 插件市场

国际化支持

界面支持中文等多语言

​
快速开始

1

获取 API Key

2

安装 Node.js

如果您尚未安装 Node.js，请前往 Node.js 官网 下载并安装最新的 LTS 版本。
MacOS 用户注意：推荐使用 nvm 工具安装 Node.js，避免权限问题，进入 Node.js 官网 如下在命令行粘贴运行即可。\Description
MacOS 用户若您已使用其它方式安装 Node.js，在后续执行命令过程若遇到 Permission 权限问题，需要在命令前加 sudo 来提高权限运行，或者卸载后改用 nvm 重新安装。
3

安装启动

前提条件：您需要安装 Node.js 18+ 或更新版本
选择下面的任意一种安装启动方式
该方式适合偶尔使用 Coding Tool Helper 的用户，无需全局安装，直接通过 npx 运行即可启动工具。
## 进入命令行界面，执行如下运行 Coding Tool Helper
npx @z_ai/coding-helper
4

完成引导

进入向导界面后，通过键盘上下方向键选择，回车确认按钮，根据引导进行配置。
向导将引导您完成：
选择界面语言 —> 选择编码套餐 —> 输入 API 密钥 —> 选择要管理的工具
—> 自动安装工具（如需要） —> 进入工具管理菜单 —> 装载编码套餐到工具
—> 管理 MCP 服务（可选） —> 完整配置，启动编码工具
Description

​
其它相关

​
命令列表

除了支持交互式向导外，Coding Tool Helper 还支持通过命令行 coding-helper 或 chelper 加参数直接执行各项功能： 
# 运行初始化向导
coding-helper init

# 语言管理
coding-helper lang show              # 显示当前语言
coding-helper lang set zh_CN         # 设置为中文
coding-helper lang --help            # 查看语言命令帮助

# API 密钥管理
coding-helper auth                   # 交互式设置密钥
coding-helper auth glm_coding_plan_china <token>     # 直接选择 China 套餐并设置密钥
coding-helper auth revoke            # 删除已保存的密钥
coding-helper auth reload claude     # 将最新套餐信息加载至Claude Code工具
coding-helper auth --help            # 查看认证命令帮助

coding-helper doctor                 # 检查系统配置和工具状态
coding-helper --help                 # 显示帮助信息
coding-helper --version              # 显示版本

​
问题排查

遇到问题可以先使用 coding-helper doctor 命令进行健康检查，排查常见问题。

网络错误，请检查网络连接

问题： 保存校验 API KEY 或其它网络操作时，报错 Network Error 等网络错误解决方案：
  1. 请检查网络链接或配置代理
  2. 注意若您需使用代理才能访问外部网络，NodeJs 程序本身并不会自动使用系统代理配置，请配置环境变量 HTTP_PROXY 和 HTTPS_PROXY 来让 NodeJs 使用代理
# 参考如下
export HTTP_PROXY=http://your.proxy.server:port
export HTTPS_PROXY=http://your.proxy.server:port
问题： 运行或安装编码工具时，报错 timeout 等网络超时解决方案：
  1. 请检查网络链接或配置代理
  2. 或切换NPM源为国内源
问题： 运行安装 Factory Droid 后，执行 droid 命令报错 command not found解决方案：
  1. 请留意安装过程结束后的信息，根据环境有可能需要手动将 Factory Droid 可执行文件路径添加到系统 PATH 中
问题： 使用 Claude Code 插件市场时，发现插件状态不对，如显示未安装但实际上已安装等解决方案：
  1. 请执行 claude update 升级 Claude Code 至最新版本, 2.0.70+
问题： 运行 npm install -g 报错 EACCES: permission denied 权限不足解决方案：
  1. 使用 sudo 提升权限后重试（MacOS / Linux）
  2. 以管理员身份运行命令行（Windows）
  3. 使用 npx 方式直接启动 npx @z_ai/coding-helper
  4. 推荐使用 nvm 工具管理 Node.js 版本，避免全局权限问题
问题： 收到 API Key 无效的错误解决方案：
  1. 确认 API Key 是否正确复制
  2. 检查 API Key 对应账户是否有足够的余额
问题： 服务连接超时解决方案：
  1. 检查网络连接
  2. 确认防火墙设置
  3. 确认 Node.js 与网络环境已就绪