跳转到主要内容

​
安装 Chatbox

Chatbox 支持以下平台，安装包在 Chatbox 官网下载：
  • Windows 10 及以上（64 位）
  • macOS 11 及以上，Apple Silicon 和 Intel 分别有安装包
  • Linux（AppImage 或 deb）
  • iOS、Android
  • 网页版：web.chatboxai.app
首次启动会出现欢迎页，有「我是新手」和「跳过引导」两个选项。使用自己的老张API密钥时选 跳过引导。

​
添加老张API

1

创建令牌

在令牌管理新建令牌，分组选 default，计费模式选 按量优先，复制密钥。
2

新建自定义提供商

打开 Chatbox 的 设置 → 模型提供方，点击列表底部的 添加，在弹出的提供商列表最底部选择 添加自定义提供商。移动端先点左上角的 ☰ 打开菜单，再进入设置。弹窗中填写：
  • 名称：老张API
  • API 模式：OpenAI API 兼容
Chatbox 添加模型提供方弹窗，名称为老张API，API 模式为 OpenAI API 兼容

添加模型提供方：名称填老张API，API 模式选 OpenAI API 兼容（Chatbox 1.23.5）

3

填写密钥和地址

  • API 密钥：粘贴老张API密钥
  • API 主机：https://api.laozhang.ai/v1
  • API 路径：留空
下方的「预览」显示 https://api.laozhang.ai/v1/chat/completions 即正确。「改善网络兼容性」保持关闭，只在连接失败时再试，见下文常见问题。
Chatbox 中老张API提供商的配置页，API 主机为 https://api.laozhang.ai/v1，预览为 https://api.laozhang.ai/v1/chat/completions，改善网络兼容性关闭

API 主机填 https://api.laozhang.ai/v1、API 路径留空，预览显示完整请求地址

4

添加模型

在模型区点击 获取，从老张API的模型列表中添加需要的模型；也可以点击 新建，手动输入模型 ID，例如 claude-sonnet-5-5。模型 ID 要与模型与价格总表完全一致。编辑模型时可以设置：
  • 模型类型：对话模型选「聊天」，生图模型选「图片」
  • 能力：视觉、推理、工具使用。「检查」时会自动识别视觉和工具使用，推理需要手动勾选
  • 上下文窗口、最大输出Token数：不确定时保持默认
Chatbox 编辑模型弹窗，模型ID 为 claude-sonnet-5-5，勾选视觉和工具使用

新建模型 claude-sonnet-5-5，模型类型为聊天，勾选视觉和工具使用

5

检查连接

点击 API 密钥旁的 检查。提供商下至少要有一个模型才能检查。也可以在编辑模型弹窗里点 测试模型，单独测试一个模型。
6

开始对话

新建对话，在模型选择中选老张API下的模型，发一句话。收到回复说明配置完成，调用记录和扣费可以在使用日志查看。

​
按 API 模式填写 API 主机

自定义提供商有四种 API 模式，日常对话用「OpenAI API 兼容」即可。想用 Claude 或 Gemini 的原生格式时，另外添加一个提供商并选对应模式。Gemini 原生格式可以沿用同一个老张API密钥，Claude API 兼容模式要填 Claude Code 分组的令牌。 各模式的 API 主机写法不同： 填写时注意：
  • OpenAI API 兼容：API 路径留空即可。API 主机不带 /v1 又在 API 路径里填 /chat/completions 时，请求地址会少一段 /v1，导致报错。
  • OpenAI Responses API 兼容：API 路径默认是 /responses，不用改。
  • Claude API 兼容：Chatbox 在 API 主机后面直接拼接 /messages，所以 API 主机必须带 /v1。
  • Google Gemini API 兼容：Chatbox 会自动加上 /v1beta，所以 API 主机不带 /v1。
四种模式下点击 获取 都能拉取老张API的模型列表。Claude 兼容模式可用 Claude 模型、glm-5.2、deepseek-v4-pro、deepseek-v4-flash，请求格式见 Claude 协议；Gemini 兼容模式的请求格式见 Gemini 协议。

​
选择模型

各模型价格见模型与价格总表。

​
开启思考控制

Chatbox 的思考控制只在 API 模式与模型系列匹配时可用，不匹配时会被禁用： 模式选对后，还要在编辑模型时手动勾选 推理 能力。

​
使用 MCP 工具

1

添加 MCP 服务器

打开 设置 → MCP，添加服务器：
  • 远程服务器（http、sse）：桌面端、移动端和网页版都能添加
  • 本地服务器（stdio）：只能在桌面端添加
填好后先点 测试，通过后再保存。
2

给模型勾选工具使用

在老张API提供商中编辑模型，勾选 工具使用 能力。以下模型可以通过 OpenAI API 兼容模式连续调用工具：
  • gpt-6.1-sol、gpt-6-sol、gpt-5.6-sol
  • glm-5.2、gemini-3.8-flash、kimi-k3
用 Claude 调用工具时，在「Claude API 兼容」模式的提供商里添加模型，这个提供商填 Claude Code 分组的令牌，见上文按 API 模式填写 API 主机。Claude、DeepSeek 在 OpenAI API 兼容模式下连续调用工具时可能返回 400。
3

在工作模式中对话

MCP 工具只在桌面端的 工作模式 中生效。切换到工作模式，选择上一步的模型，再提出需要用到工具的问题。

​
生成图片

在老张API提供商中新建一个模型，填入图像模型的 ID，把 模型类型 设为「图片」，选这个模型对话即可生图。
  • Chatbox 会自动请求 https://api.laozhang.ai/v1/images/generations，不要为生图修改 API 路径。
  • 可用的图像模型和单价见图像生成 API 选型，选通过 POST /v1/images/generations 生成的模型。

​
常见问题

​
检查连接提示 404？

请求地址里的 /v1 重复或缺失。对照按 API 模式填写 API 主机的表格检查 API 主机，再看「预览」显示的地址是否只有一个 /v1。

​
「检查」按钮无法点击？

提供商下至少要有一个模型才能检查。先点 获取 或 新建 添加一个模型。

​
提示 401？

密钥错误或没有复制完整。在令牌管理重新复制，并确认令牌已启用。更多排查见 API Key 无效与 Base URL。

​
提示 503 no available channels？

令牌分组不包含这个模型，或模型 ID 写错。确认令牌分组：Claude API 兼容模式用 Claude Code，其他模式用 default。再确认模型 ID 与模型与价格总表一致，详见如何确认模型是否可用。

​
提示温度或 Top P 不受支持？

o 系列和部分 Claude 模型不接受温度、Top P 参数。在对话设置中把温度和 Top P 设为「未设置」再试。

​
开启 MCP 后 GPT-6 提示 reasoning_effort 报错？

2026 年 11 月 4 日之前，GPT-6、GPT-5.6 系列在 Chat Completions 中边推理边调用工具会报 Function tools with reasoning_effort are not supported。老张API现在已兼容这类请求，gpt-6.1-sol、gpt-6-sol 可以直接用于 MCP 工具。

​
检查连接失败时要开「改善网络兼容性」吗？

先按上文核对 API 主机和密钥。确认无误仍连接失败时，再开启「改善网络兼容性」试一次。网页版和鸿蒙版开启后，请求会经过 Chatbox 的服务器中转，不需要时保持关闭。

​
提示余额不足？

查看账户余额和令牌额度，余额充足仍报错时按余额不足排查逐项检查。

​
相关文档