工具接入
ZCode
在智谱 Z.ai 的 ZCode 桌面编程环境中把 LynShen 添加为自定义提供商。
ZCode 是 Z.ai（智谱）推出的桌面编程环境，内置 ZCode Agent，支持 macOS、Windows、Linux。2026-09-21 起以 Apache-2.0 开源，仓库为 zai-org/ZCode。本页按 v3.14.3（2026-09-24 发布）和 2026-10-11 的官方文档编写。
ZCode 支持第三方提供商。官方文档有“Custom Providers (Anthropic / OpenAI Compatible)”一节。
接入方式
自定义提供商可以填写 Anthropic 端点、OpenAI 端点，或两者都填。
| 协议 | 填写 | 说明 |
|---|---|---|
| Anthropic Messages | https://api.lynshen.org | ZCode 在结尾不是 /v1 时会自动补上，带不带 /v1 都可以。这种格式同时发送 x-api-key 和 Authorization: Bearer。 |
| Chat Completions、Responses | https://api.lynshen.org/v1 | ZCode 直接在后面拼接 /chat/completions 或 /responses，不做补全。必须带 /v1。 |
配置步骤
ZCode 在图形界面中配置提供商。
- 点击聊天框中的模型名，再点击“管理模型”，进入设置 → 模型设置（Model Settings）。
- 点击提供商列表底部的添加提供商（Add Provider）。
- 名称填
LynShen。 - 填写端点：
- Anthropic 端点：
https://api.lynshen.org - OpenAI 端点：
https://api.lynshen.org/v1
- Anthropic 端点：
- API Key 填你的
sk-...密钥。 - 点击添加模型（Add Model），手动输入模型 ID，例如
claude-sonnet-5、glm-5.3。ZCode 不会自动从/v1/models获取列表。 - 打开启用开关。
配置保存在 ~/.zcode/v2/config.json。手动编辑时，提供商的 options 只识别 apiKey、baseURL、apiKeyRequired、headers，其他键会被忽略。Windows 上的路径应为 %USERPROFILE%\.zcode\v2\config.json，这是按源码的主目录规则推断的，官方文档没有写明。
选择模型
在聊天框中点击模型名，选择 LynShen 提供商下的模型。
自定义模型的上下文窗口默认为 200,000。在设置 → 模型提供商中打开模型，展开高级（Advanced），可以修改上下文窗口和最大输出 Token。请按模型官方上限填写。
显示推理
- ZCode 按模型显示思考强度档位。OpenAI 兼容端点发送
reasoning_effort，Anthropic 兼容端点发送thinking和effort。 - ZCode 不认识的第三方模型只有一个开关，或没有档位。
- ZCode 不支持为第三方模型添加自定义请求参数。
- ZCode 的 Chat completions 格式使用 AI SDK
@ai-sdk/openai-compatible，读取reasoning_content和reasoning字段。LynShen 在reasoning_content中返回推理，所以这种格式能显示思考过程。见推理显示的兼容性。 - 调用 Claude 时使用 Anthropic 格式，可以看到思考过程。
常见问题
| 现象 | 原因和处理 |
|---|---|
| OpenAI 格式返回 404 | OpenAI 端点没有带 /v1。 |
| 最高档位返回 400 | 部分模型的上游只接受较低的档位。改用 high。 |
| 代理设置不生效 | ZCode 不读取系统的 HTTP_PROXY。在 ZCode 设置中配置代理。 |
| 模型不能看图 | ZCode 按协议和模型判断图片能力。通过 Chat 端点调用时，部分模型会被当作不支持图片。改用 Anthropic 端点试试。 |
来源
2026-10-11 查阅：
- ZCode 文档：Configuration
- ZCode 文档：Q&A
- zai-org/ZCode 仓库：
apps/zcode-cli/packages/adapters/src/model/model-execution.ts、packages/ui/src/settings/model-provider-section/ProviderApiFormatSelect.tsx - AI SDK：@ai-sdk/openai-compatible