qoder离线安装需经四步：一、外网中转机下载或构建offline/bundle包；二、校验sha256后解压至/opt/qoder/cli；三、配置path并赋权；四、执行init --offline、设本地模型路径、启动webui并验证功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在无网络连接的环境中部署Qoder，但无法从官网直接下载安装包，则必须通过外网中转机预先获取完整离线安装资源。以下是完成Qoder离线安装包获取与核心组件部署的具体操作路径：
一、在外网环境预下载Qoder离线安装包
该步骤旨在从官方渠道一次性拉取全部必需文件，避免内网部署时因缺失依赖导致失败。需使用一台可联网的中转设备执行下载，并确保所选版本与目标离线环境的操作系统及架构严格匹配。
1、访问Qoder中文官网下载页面：https://qoder.com/zh
2、定位“Qoder CLI”或“Qoder Desktop”对应平台的离线安装包，优先选择带有offline或bundle标识的发布版本（如qoder-cli-v0.2.7-linux-amd64-offline.tar.gz）
3、若官网未提供显式离线包，则手动构建：在联网机器上运行npm install -g @qoder-ai/qodercli --no-audit --no-fund，随后使用npx offline-pack @qoder-ai/qodercli生成本地依赖归档
4、将生成的.tar.gz或.zip压缩包完整复制至U盘或离线传输介质
二、校验并解压离线安装包至目标主机
该步骤确保安装包完整性与结构可用性，防止因传输损坏或解压异常引发后续初始化失败。解压路径应为非系统临时目录，且具备执行权限。
1、将U盘插入离线服务器，挂载后确认文件存在：ls -l /mnt/usb/qoder-cli-v0.2.7-linux-amd64-offline.tar.gz
2、计算SHA256校验值并与官网发布的checksums.txt比对：sha256sum /mnt/usb/qoder-cli-v0.2.7-linux-amd64-offline.tar.gz
3、创建标准部署目录：mkdir -p /opt/qoder/cli
4、解压至指定位置：tar -zxvf /mnt/usb/qoder-cli-v0.2.7-linux-amd64-offline.tar.gz -C /opt/qoder/cli/
5、验证解压后关键文件存在：ls /opt/qoder/cli/bin/qodercli /opt/qoder/cli/lib/
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、配置本地运行环境与PATH变量
该步骤使系统识别Qoder CLI为全局可执行命令，绕过网络依赖的动态链接与远程配置加载机制，确保基础功能立即可用。
1、赋予二进制文件执行权限：chmod +x /opt/qoder/cli/bin/qodercli
2、将CLI路径写入系统级环境变量：echo 'export PATH="/opt/qoder/cli/bin:$PATH"' >> /etc/profile.d/qoder.sh
3、重载环境配置：source /etc/profile.d/qoder.sh
4、验证命令是否生效：qodercli --version，预期输出0.2.7
5、检查内置模型与配置文件是否就位：ls /opt/qoder/cli/config/ /opt/qoder/cli/models/
四、启动离线模式并验证核心组件连通性
该步骤跳过云端鉴权与在线模型拉取流程，强制启用本地推理引擎与嵌入式服务模块，确保无网络条件下仍可执行代码分析、补全等基础AI任务。
1、初始化离线配置文件：/opt/qoder/cli/bin/qodercli init --offline
2、指定本地模型路径（若含Qwen2.5-Coder-1.5B）：qodercli config set model.path /opt/qoder/cli/models/qwen2.5-coder-1.5b
3、启动轻量WebUI服务（绑定本地回环）：qodercli webui --host 127.0.0.1 --port 8080 --no-browser
4、在离线主机浏览器中访问http://127.0.0.1:8080，确认界面加载成功且无网络请求报错
5、执行本地代码测试：qodercli ask "修复Python中list index out of range错误"
