cline使用 vscode

1 安装cline扩展

2 加入API key

我是淘宝买的国外模型，客服会提供API key并给教程怎么填

3* npm install -g cline （非必要，可选）

如果还想在终端里直接运行 cline 命令

点击Run in terminal，或在终端执行npm install -g cline

验证安装

cline --version

可以使用了

报错与解决

执行npm install -g cline 报错

npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: 'mimic-function@5.0.1', npm WARN EBADENGINE required: { node: '>=18' }, npm WARN EBADENGINE current: { node: 'v12.22.9', npm: '8.5.1' } npm WARN EBADENGINE } npm ERR! code EACCES npm ERR! syscall mkdir npm ERR! path /usr/local/lib/node_modules npm ERR! errno -13 npm ERR! Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules' npm ERR! [Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules'] { npm ERR! errno: -13, npm ERR! code: 'EACCES', npm ERR! syscall: 'mkdir', npm ERR! path: '/usr/local/lib/node_modules' npm ERR! } npm ERR! npm ERR! The operation was rejected by your operating system. npm ERR! It is likely you do not have the permissions to access this file as the current user npm ERR! npm ERR! If you believe this might be a permissions issue, please double-check the npm ERR! permissions of the file and its containing directories, or try running npm ERR! the command again as root/Administrator. npm ERR! A complete log of this run can be found in: npm ERR! /home/tina/.npm/_logs/2026-05-10T00_12_51_023Z-debug-0.log

原因

1 Node.js 版本过低

这里Node.js 版本是 v12.22.9，但 cline 需要 v20.0.0 或更高版本
所有依赖包都报 EBADENGINE 错误，说明版本完全不兼容

2 权限不足

EACCES: permission denied, mkdir '/usr/local/lib/node_modules'
普通用户没有权限在 /usr/local/lib/node_modules 目录创建文件

解决

步骤 1：移除冲突的旧包

1.1 移除旧的 libnode-dev 和 nodejs
sudo apt-get remove -y libnode-dev nodejs

1.2 自动移除不再需要的依赖包
sudo apt-get autoremove -y

步骤 2：清理残留配置

2.1 清理 apt 缓存
sudo apt-get clean

2.2 更新包列表
sudo apt-get update

步骤 3：安装 Node.js 20

sudo apt-get install -y nodejs

如果没做前面的清理步骤，这步可能会报错

准备解压 .../nodejs_20.20.2-1nodesource1_amd64.deb ... 正在解压 nodejs (20.20.2-1nodesource1) 并覆盖 (12.22.9~dfsg-1ubuntu3.6) ... dpkg: 处理归档 /var/cache/apt/archives/nodejs_20.20.2-1nodesource1_amd64.deb (--unpack)时出错： 正试图覆盖 /usr/include/node/common.gypi，它同时被包含于软件包 libnode-dev 12.22.9~dfsg-1ubuntu3.6 dpkg-deb: 错误: 粘贴 子进程被信号(断开的管道) 终止了 在处理时有错误发生： /var/cache/apt/archives/nodejs_20.20.2-1nodesource1_amd64.deb E: Sub-process /usr/bin/dpkg returned an error code (1)

步骤 4：验证安装

4.1 检查版本
node --version # 应该显示 v20.20.2
npm --version # 应该显示对应的 npm 版本

步骤 5：解决 npm 权限问题

5.1 创建用户级别的 npm 全局目录
mkdir -p ~/.npm-global

5.2 配置 npm 使用这个目录
npm config set prefix '~/.npm-global'

5.3 添加到 PATH（永久生效）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

5.4 重新加载配置
source ~/.bashrc

步骤 6：安装 cline

6.1 现在可以安装 cline 了
npm install -g cline

6.2 验证安装
cline --version