qoder部分支持离线使用：qoder cli和qoderwake轻量版完全离线；qoder desktop仅部分离线；qoderwork官网版不支持离线。需提前下载离线包、预置模型、禁用网络请求并绑定本地路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder可以离线使用，但必须提前在外网环境下载完整离线安装包、预置模型文件及所有Python依赖，并在内网机器上跳过联网校验、禁用动态模型拉取、绑定本地模型路径后才能启动基础文本推理与CLI命令功能。
确认Qoder是否支持你所需的离线场景
Qoder CLI和QoderWake轻量版明确支持完全离线运行；Qoder Desktop（IDE插件版）仅支持部分能力离线，如本地缓存补全、语法高亮、行间生成（需提前加载模型）；阿里桌面Agent QoderWork官网版【不支持离线】，其鉴权、模型加载、上下文路由全部强依赖qoderwork.aliyun.com服务，断网后自动降级为只读模式且无法恢复核心生成能力。
获取并校验离线安装包
方法一：优先从官网直接下载标注“offline”或“airgap”的安装包
访问 https://qoder.com/download → 根据操作系统选择带 offline 后缀的压缩包，例如 qoder-cli-v0.3.2-linux-amd64-offline.tar.gz → 下载完成后立即记录其 SHA256 值（后续内网必须比对）。
方法二：若官网未提供显式离线包，需手动构建
在可联网的中转机执行：conda create -n qoder-offline python=3.10 && conda activate qoder-offline → 安装指定版本 torch、transformers、gradio 等依赖 → 运行 Python 脚本下载 Qwen1.5-0.5B 模型至本地 cache_dir → 将 /opt/conda/envs/qoder-offline 和模型目录整体打包 → 生成单一 tar.gz 文件。
⚠️ 注意：模型权重文件体积大，传输前务必用 sha256sum 校验原始包与内网解压后文件一致性，否则初始化会因模型缺失直接失败。
内网部署与离线配置固化
第一步：解压至标准路径
将校验无误的离线包上传至内网服务器 → 执行 tar -zxvf qoder-cli-v0.3.2-linux-amd64-offline.tar.gz -C /opt/qoder/cli/ → 确保 bin/qodercli、lib/、models/ 目录结构完整。
第二步：配置本地模型路径与禁用网络请求
编辑 /opt/qoder/cli/config.yaml → 将 model_path: 设置为绝对路径，例如 /opt/qoder/cli/models/Qwen1.5-0.5B → 在 auth 部分添加 offline_mode: true → 删除或注释掉所有以 https:// 开头的 api_endpoint 行。
第三步：初始化并启动WebUI
运行 /opt/qoder/cli/bin/qodercli init --offline → 等待提示 “Offline initialization completed” → 执行 /opt/qoder/cli/bin/qodercli webui --host 0.0.0.0 --port 7860 → 浏览器访问 http://:7860 即可打开界面。
验证离线功能是否生效
在终端执行 qodercli --version，输出版本号且无任何 HTTP 请求日志 → 在WebUI中输入“写一个冒泡排序”，点击生成，响应来自本地模型而非网络超时错误 → 运行 qodercli review --file test.py，检查结果是否即时返回且不触发外部 API 调用。
