ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Centos7 快速安装配置 Qwen Code CLI:TaoToken 统一 Key 接入与 settings.json 骨架

Centos7 快速安装配置 Qwen Code CLI:TaoToken 统一 Key 接入与 settings.json 骨架 1. Centos7 上跑 Qwen Code CLI 到底卡在哪Qwen Code CLI 是通义千问团队开源的命令行编程助手能在终端里直接读项目、改代码、解释报错适合习惯 SSH 连服务器写代码的人。但把它装到 Centos7 上很多人第一步就卡住了Centos7 自带的 glibc 是 2.17而官方 Node.js 20 的二进制包要求更高版本的 glibc直接wget官方包解压后运行node -v会报GLIBC_2.28 not found。这不是你操作错了是系统太老和新版 Node 之间的兼容问题。第二个坑是证书。Centos7 默认的 ca-certificates 版本偏旧wget https://...经常提示证书验证失败尤其是访问一些新证书链的站点时。第三个坑是 npm 源国内服务器直连 registry.npmjs.org 下载qwen-code/qwen-code这种带依赖树的包慢到超时是常态。这篇就按 Centos7 的真实环境从 Node.js 依赖准备一路走到 Qwen Code CLI 装好、接上 TaoToken 统一 Key、跑通第一次对话。核心交付物是一份可复制的settings.json骨架和几条连通性验证命令你照着敲就能在 Centos7 上把 Qwen Code CLI 跑起来。适合手里有台 Centos7 服务器、想用命令行 AI 辅助写代码的运维和后台开发。2. 装 Qwen Code CLI 前先把 TaoToken 的 Key 和通道准备好Qwen Code CLI 本身是个客户端它需要一个能对话的模型通道。你可以直接用它默认的授权方式也可以把它指向一个统一的 API 入口这样 Qwen Code CLI、其他 CLI 工具、脚本都共用一套 Key管理起来省事。我这边用的是 TaoToken 的统一 Key 方案一个 Key 走多个模型通道配置写进settings.json就行。先去官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建 API Key。创建完记得立刻复制页面刷新后就看不到完整 Key 了。拿到 Key 之后Qwen Code CLI 要填的其实是两个东西一个是 API 地址Base URL一个是 Key。TaoToken 的 API 入口是 https://taotoken.net/api 注意这个地址后面不加任何 UTM 参数直接写进配置。Key 的格式一般是一串以sk-开头的字符串具体以你控制台里生成的为准。注意Key 属于敏感凭证别直接提交到 Git 仓库。建议放在环境变量或者单独的配置文件里.gitignore里把配置文件排除掉。如果你后面还想在别的机器或者别的 CLI 工具里复用这套通道可以到接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 看下不同工具的填法思路都一样Base URL 填https://taotoken.net/apiKey 填你生成的那串。3. Centos7 安装 Node.js 与 Qwen Code CLI 的完整命令3.1 修复证书并下载兼容 glibc-2.17 的 Node.js 20Centos7 的 glibc 版本决定了你不能用官方通用二进制包得用专门为 glibc-2.17 编译的版本。先更新证书库再下载。# 更新系统根证书库减少后续 wget 证书报错 yum update ca-certificates -y # 进入 /usr/local 准备安装 cd /usr/local/ # 下载兼容 glibc-2.17 的 Node.js 20 构建包 wget --no-check-certificate https://unofficial-builds.nodejs.org/download/release/v20.12.2/node-v20.12.2-linux-x64-glibc-217.tar.gz # 解压 tar -zxvf node-v20.12.2-linux-x64-glibc-217.tar.gz # 清理压缩包 rm -f node-v20.12.2-linux-x64-glibc-217.tar.gz--no-check-certificate是兜底手段如果前面证书更新后 wget 不报错可以去掉这个参数。解压出来的目录名是node-v20.12.2-linux-x64-glibc-217记住它下一步配环境变量要用。3.2 配置环境变量让 node 和 npm 可用# 把 Node.js 的 bin 目录写进 PATH echo export PATH/usr/local/node-v20.12.2-linux-x64-glibc-217/bin:$PATH ~/.bashrc # 立即生效 source ~/.bashrc # 验证应输出 v20.12.2 node -v npm -v如果node -v报GLIBC_2.28 not found说明你下错包了回去确认文件名里带glibc-217。如果报command not found检查~/.bashrc里的路径有没有写错或者当前 shell 是不是没重新 source。3.3 换 npm 镜像源并全局安装 Qwen Code CLI# 换成国内镜像源加速下载 npm config set registry https://registry.npmmirror.com # 全局安装 Qwen Code CLI npm install -g qwen-code/qwen-codelatest # 验证命令是否可用 qwen --versionnpm install -g会把包装到 Node 的全局目录因为 Node 装在/usr/local下全局 bin 也在 PATH 里所以qwen命令能直接调用。如果qwen --version报权限错误检查一下当前用户对/usr/local/node-v20.12.2-linux-x64-glibc-217/lib/node_modules有没有写权限必要时用sudo或者把目录 owner 改成当前用户。4. settings.json 骨架与 TaoToken 通道接入Qwen Code CLI 的配置一般放在用户目录下的配置文件夹里常见路径是~/.qwen/settings.json或者项目根目录的.qwen/settings.json。下面这份骨架把 TaoToken 的 Base URL 和 Key 接进去你可以直接复制改。{ apiBaseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: qwen-max, timeout: 60000, maxTokens: 4096, temperature: 0.7 }字段说明用表格对照一下更清楚字段作用建议值apiBaseUrl模型 API 入口地址https://taotoken.net/apiapiKey身份凭证控制台生成的 sk- 开头 Keymodel默认调用的模型按你通道支持的模型名填timeout单次请求超时毫秒60000maxTokens单次回复最大 token4096temperature随机性0.7如果你不想把 Key 明文写在文件里可以用环境变量替代把apiKey那行改成读取环境变量的写法然后在~/.bashrc里export TAOTOKEN_API_KEYsk-xxx。这样配置文件可以安全地放进版本控制。提示model字段填什么取决于你在 TaoToken 控制台里开通的通道支持哪些模型。填错模型名会返回 404 或 model not found遇到就去控制台核对一下可用模型列表。配置写好后启动 Qwen Code CLIqwen首次启动如果它提示你/auth授权说明它还在走默认授权流程。这时候检查一下settings.json的路径对不对Qwen Code CLI 读的是用户级配置还是项目级配置不同版本可能略有差异。确认配置生效后它就会用你填的 Base URL 和 Key 去请求。5. 连通性验证与常见报错排查5.1 用 curl 先验证通道通不通在启动 CLI 之前先用 curl 直接打一下 API排除网络和 Key 的问题curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: qwen-max, messages: [{role: user, content: 你好}] }如果返回一段 JSON 且里面有choices字段说明 Key 和通道都没问题。如果返回 401是 Key 错了或者没带上返回 404多半是路径或模型名不对返回超时检查服务器出网和 DNS。5.2 常见报错对照GLIBC_2.28 not foundNode.js 包下错了必须用glibc-217版本。npm ERR! network timeout镜像源没换成功重新执行npm config set registry https://registry.npmmirror.com再npm config get registry确认。qwen: command not foundPATH 没配好source ~/.bashrc后重试或者echo $PATH看有没有 Node 的 bin 目录。401 UnauthorizedKey 填错、过期或者Authorization头格式不对注意是Bearer加空格再加 Key。model not foundsettings.json里的model字段和你通道支持的模型对不上去控制台核对。settings.json不生效确认文件路径用户级和项目级配置优先级不同项目级一般覆盖用户级。可以用qwen --help看它有没有打印配置加载路径的参数。5.3 验证成功后跑一次真实对话通道通了之后在 Qwen Code CLI 里让它解释一段代码或者查个报错比如qwen 解释一下这段 shell 脚本的作用$(cat deploy.sh)能正常返回内容就说明 Centos7 上的 Qwen Code CLI 已经完整跑通了。后面你可以把它接进日常的代码 review、日志分析流程里。6. 后续怎么把这套配置用顺Centos7 上装 Qwen Code CLI 的难点其实就两个Node.js 的 glibc 兼容包和 npm 源。把这两步过了剩下的就是配置和验证。TaoToken 统一 Key 的好处是你后面如果还想在别的工具里用同一个通道不用重新申请直接复用 Base URL 和 Key 就行。如果你主要用它做长期编码和 Agent 任务可以看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 按用量规划更划算。想先在网页里试试模型对话效果可以到模型对话 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 直接聊。Key 管理和新建都在 API Keys https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 页面接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。配置骨架先存一份换机器的时候直接改 Key 就能用。
返回列表