配置你的 GPT 账号

Jz Desk 本身不附带模型账号。准备一个 OpenAI API 密钥，它就直接与你的账号通信——不经过我们。

第 1 步
获取 API 密钥

在 platform.openai.com 的 API keys 页面创建。密钥需具备 Responses API 权限，账户须已开通计费。只显示一次，请立即复制——OpenAI 不会再次展示。
第 2 步
下载并打开 Jz Desk

macOS 上打开磁盘映像，将 Jz Desk 拖入「应用程序」；Windows 上运行安装程序。智能体已内置其中，无需另外安装。
第 3 步
粘贴密钥

首次启动时会打开设置向导并询问密钥。密钥写入 ~/.jz-code/auth.json，仅你本人可读。
第 4 步
选择模型

打开设置，选择账户可访问的模型，然后开始对话。

配置文件

两行就够。Jz Desk 使用 OpenAI Responses API，内置的 openai provider 已经解析到 https://api.openai.com/v1，无需填写地址。在 `model` 里写上你账号能访问的模型即可。

~/.jz-code/config.toml

model = "gpt-5.6"
model_provider = "openai"

不是直连 OpenAI，而是走网关或代理？请设置 openai_base_url。只有这个键有效——写 [model_providers.openai] 会被静默忽略，因为 openai 是内置 provider。

openai_base_url = "https://your-gateway.example.com/v1"

选择模型

只要你的密钥能访问，任何模型按名称填写即可——智能体会原样传递。gpt-5.6 是不错的默认选择；gpt-6 等更新的模型用法相同。较小或较旧的模型难以胜任跨文件改动。

桌面版的模型选择器只列出 Jz Desk 内置了元数据的模型。想列出其他模型，复制内置目录文件，修改其中的 visibility 字段，再用 model_catalog_json 指向你的副本。

验证是否可用

在 Jz Desk 中打开一个项目目录，随便问一句。能收到回复，就说明地址、密钥和模型都对上了。

如果不工作

一直等待，没有回复: 地址不可达。如果你为网关设置了 openai_base_url，请确认地址正确且可访问；否则请检查网络能否访问 api.openai.com。注意：旧版本留下的 config.toml 不会被覆盖，里面可能还写着过时的地址。
404：模型不受支持: 该模型不在你账号可用的范围内。把 model 改成你的密钥能访问的模型 id，然后新建一个会话——已有会话会沿用创建时的模型。
401 或 403: 密钥缺失、过期，或没有 Responses API 权限。请在设置中重新填写密钥，并确认账号已开通计费。