企业官网建设流程全解析

ZCode 接入 DeepSeek 的三种姿势：模型自由切换到底香不香

【免费下载链接】ZCodeZCode 是 AI 编程工作台，提供桌面应用、浏览器界面和终端 Agent。本仓库包含客户端、后端服务、共享 UI，以及 Agent CLI 与运行时源码。项目地址: https://gitcode.com/zai-org/ZCode

当一个以 GLM 为默认模型的国产开源编程智能体，被社区讨论最多的问题却是"能不能换成 DeepSeek"时，这件事本身就值得拆开看看。ZCode 从 3.0 全面切换到自研 Agent 内核、用户突破百万之后，围绕它的讨论逐渐从"GLM 好不好用"转移到"模型到底能不能自由换、换了之后香不香"。这个问题的答案，一半在社区实测里，一半在仓库源码里。本文从zai-org/ZCode的真实代码出发，拆解 ZCode 的多模型架构，给出接入 DeepSeek 的三种可落地方案，并基于社区情报讨论 GLM 与 DeepSeek 在同一任务下的选择逻辑。

模型中立不是口号：三层配置与三大协议

ZCode 常被社区评价为"协议兼容、模型中立"，这句话在源码里是能找到落点的。整个模型接入体系建立在 packages/provider/src/resolver.ts 的分层解析逻辑之上：ProviderConfigResolver.resolve()把三类来源叠在一起——内置模板（zcode-builtin）、账号权益（account providers）和个人配置（personal providers），个人层优先覆盖内置层，模板再兜底。这意味着"官方预置什么"和"用户最终用什么"是两回事，模型自由切换不是产品宣传，而是配置系统的天然结果。

协议层是更关键的设计。在 packages/provider/src/config/provider-data-schema.ts 中，providerApiTypeDataSchema明确枚举了三种 API 协议：

• anthropic-messages（Anthropic Messages 兼容协议）
• openai-chat-completions（OpenAI 兼容协议）
• openai-responses（OpenAI Responses 协议）

任何模型，只要能用这三种协议之一暴露端点，就能被 ZCode 接进来。当前主流的国产模型服务基本都提供了 OpenAI 兼容或 Anthropic 兼容端点，这正是"模型中立"的技术基础。配合 packages/provider/src/config/model-config.ts 中ModelConfigRules.resolve()的规则匹配——它同时支持模板规则、精确模型规则和基于modelMatch正则的批量规则，并允许按apiType与baseUrl做匹配——每个 provider 的模型能力（上下文窗口、输出上限、是否支持工具调用）都能被精确建模。

一个直接证据是内置模板里就躺着 DeepSeek。在 config/provider/zcode-builtin.json 中，deepseek模板的核心配置是：

{ "templateId": "deepseek", "config": { "access": { "type": "api-key", "apiKeyManagementUrl": "https://platform.deepseek.com/api_keys" }, "api": { "type": "anthropic-messages", "baseUrl": "https://api.deepseek.com/anthropic" }, "builtinModelIds": ["deepseek-flash", "deepseek-v4-pro"] } }

注意这里用的是anthropic-messages协议——DeepSeek 官方提供 Anthropic 兼容端点，ZCode 把它作为一等公民预置，而不是当作"第三方凑合接入"。内置模型列表中还列出了deepseek-flash与deepseek-v4-pro两个模型 ID，说明模型中立不是留了个后门，而是把 DeepSeek 当作与 GLM 平级的正式 provider。

切换动作本身也被做成了第一等交互。CLI 的/model命令实现在 apps/zcode-cli/packages/cli/src/command-center/handlers/model.ts：/model list列出当前可用模型，/model <provider>/<model>完成切换，切换后还会通过rememberCurrentModelSelection（见 apps/zcode-cli/packages/cli/src/command-center/model-selection.ts）把选择持久化为新会话的默认值，并联动/effort调整推理强度。这个设计保证了"切模型"不是一次性的临时动作，而是会沉淀到个人配置里的长期偏好。

三种接入姿势实操

基于上面的架构，接入 DeepSeek 实际有三条路径，它们的区别在于"API Key 交给谁、请求打到哪"。

姿势一：直连官方 API

最直接的做法是使用 DeepSeek 官方端点。在 DeepSeek 开放平台创建 API Key 后，通过/login相关命令或设置面板完成密钥配置（ZCode 的登录体系在 apps/zcode-cli/packages/cli/src/command-center/login-flow.ts 中支持 OAuth 与手动 Key 两种模式），然后执行：

/model deepseek/deepseek-v4-pro

由于内置模板已经定义好了baseUrl、协议类型和模型 ID，用户无需手写任何配置。这种姿势的优点是零配置、请求路径最短、数据只经过官方通道；缺点也很明显——密钥和代码都直达外部 API，适合对成本与数据流向都心里有数的个人开发者。

姿势二：网关代理接入

第二种是经由聚合网关中转，典型代表是内置的openrouter模板。在 config/provider/zcode-builtin.json 中，OpenRouter 模板使用anthropic-messages协议指向https://openrouter.ai/api，并且内置了deepseek/deepseek-v4-pro、deepseek/deepseek-v4-flash等一批跨厂商模型 ID。这意味着通过一个 OpenRouter Key，就能在同一套配置里访问 DeepSeek、GLM、Kimi、Qwen 等多个模型，实现真正意义上的"一个 Key 全家桶"。

这种姿势适合多模型重度用户：网关层统一了计费、限流与模型路由，团队可以把模型策略收敛到网关一侧，而不是在每个开发者机器上各自维护密钥。代价是多一跳网络、引入第三方转发，密钥与代码路径上多了一个信任节点。

姿势三：本地/私有化转发

第三条路径面向敏感项目与合规场景。ZCode 的 provider 配置支持完全自定义的baseUrl与headers（见 packages/provider/src/config/provider-config.ts 中ProviderApiConfig的字段定义），个人配置文件（默认位于~/.zcode/v2/provider_config.json）可以声明自定义 provider，把端点指向企业内网的模型网关，甚至本地 Ollama 一类的推理服务。社区实测文章中也多次提到"Ollama + 本地模型替代方案"的玩法。

这条路径的形态是"本地转发"：代码不出内网，由企业或本地的模型服务完成推理。对发生过"代码上传争议"讨论的 ZCode 生态而言，这是社区给出最多的安全建议之一——敏感项目通过本地推理与配置审查，把数据流控制在可控边界内。代价是模型能力通常弱于云端旗舰，且需要自行维护推理基础设施。

三种姿势并非互斥。日常开发用官方 API，跨厂商对比用网关，涉密项目走本地转发——配置文件体系支持它们共存，/model命令随时在之间切换。

GLM 与 DeepSeek 的取舍：同一任务，两种逻辑

那么"自由切换到底香不香"？社区实测给出的答案不是非黑即白，而是"切换本身很香，收益取决于任务"。

从社区多篇实测文章看，ZCode 作为智谱系工具，与 GLM 的组合在中文场景、长上下文理解和 Coding Plan 订阅模式下有明显的主场优势——开箱即用、零成本起步（智谱一度提供免费 token 活动）、团队套餐逻辑清晰。而 DeepSeek 的价值在于模型多样性与成本弹性：按 token 计费的 API 模式适合用量起伏大的场景，且在推理成本敏感的批量任务上具备更强的定价竞争力。CSDN 多篇对比文章都指向同一个结论：ZCode 适合"有模型自主权、合规要求或企业级技术栈"的团队，而 DeepSeek 接入正是这种自主权的具体体现。

需要提醒的是，模型切换不是免费的"品质升级"。同一任务下，GLM 与 DeepSeek 的代码质量差异高度依赖任务类型：涉及复杂多文件重构时，模型的中文指令理解与工具调用稳定性更关键；涉及简单脚本、模板生成时，成本与响应速度的权重会上升。社区的实操建议普遍是"按任务选模型"——重活交给开箱即用的默认模型，批量轻活切到 DeepSeek 这类高性价比模型，而不是追求单模型通吃。

从工程视角看，"香不香"其实取决于 ZCode 把切换成本压得多低。从源码可以看到，这个成本已经被压到了很低的水平：内置模板免去了手写配置，/model一条命令完成切换，选择还会持久化为默认值，个人配置使用带 schemaVersion 的版本化文件与原子写（见 packages/provider-node/src/provider-config-file-codec.ts），切换过程稳定可复现。当切换成本趋近于零时，模型中立就从"卖点"变成了真正的生产力工具：开发者不再被绑定在单一模型上，而是让 GLM 与 DeepSeek 各司其职。

小结

ZCode 接入 DeepSeek 的三种姿势——官方直连、网关代理、本地转发——分别对应个人开发者、多模型重度用户和合规敏感项目三类场景。它们共同建立在三层配置体系与三大协议之上，这也是 ZCode"模型中立"最硬核的底气。至于切换到底香不香：香，因为架构让切换几乎零成本；但要用得香，需要想清楚任务类型与成本基线，让 GLM 和 DeepSeek 各自待在最适合的位置上。

【免费下载链接】ZCodeZCode 是 AI 编程工作台，提供桌面应用、浏览器界面和终端 Agent。本仓库包含客户端、后端服务、共享 UI，以及 Agent CLI 与运行时源码。项目地址: https://gitcode.com/zai-org/ZCode