AingDesk × AI Code With
AingDesk 接入第三方 API/ 中转站配置
本页说明如何在 AingDesk 开源桌面助手里接入第三方接口，用自定义供应商在本地使用模型和知识库。
先下载并安装 AingDesk，再在客户端添加自定义供应商。密钥只在客户端填写，不在本页输入真实 Key。
- 供应商名称
- AI Code With
- 接口地址
- https://api.aicodewith.ai/v1
- API Key
- sk-xxxxxxxx
- Model ID
- claude-sonnet-4-6
快速配置
在 AingDesk 里添加模型服务商：填供应商名称、接口地址和密钥，再选择模型，全程约 3 分钟。
AingDesk 是桌面客户端。从欢迎页或侧栏「第三方模型API」添加模型服务商，填供应商名称、接口地址和密钥，再同步模型并发送测试。
使用第三方模型
首次打开 AingDesk 会出现欢迎页。点红色框里的「使用第三方模型」，应进入「第三方API配置」。若欢迎页已经关掉，改走侧栏「第三方模型API」。进不去见下方排错。下一步是「添加模型服务商」。
首次打开 AingDesk，点欢迎页「使用第三方模型」。侧栏也可走「第三方模型API」。 添加模型服务商
在「第三方API配置」窗口底部点「添加模型服务商」，不要点内置硅基流动。应弹出「添加模型服务商」表单。看不到按钮就关窗再开第三方 API。下一步：填写三项并点「确认」。
底部点「添加模型服务商」。右侧内置硅基流动不是本页路径。 填写供应商名称、接口地址和密钥
在「添加模型服务商」弹窗填写供应商名称（可填 AI Code With）、接口地址 https://api.aicodewith.ai/v1（助手文案：需要兼容openAI格式的接口）、密钥，点「确认」。成功后应进入已保存供应商并开始拉 /models。若确认卡住或列表为空，见下方排错。下一步：核对模型列表或手动「添加模型」。
填写供应商名称、接口地址 https://api.aicodewith.ai/v1、密钥，点「确认」。密钥字段粘贴 AI Code With Key。 同步或手动添加模型
保存后列表会按「默认从/models获取所有模型」自动填充。截图里的 chatgpt-4o-latest 等是中转站目录，不是本页 Model ID。打开要用的开关；没有本页 ID 就点「添加模型」，粘贴 Model ID，模型别名自定，模型功能选 LLM。列表空或找不到 ID，见下方排错。下一步：回对话发测试消息。
复制 Model ID
保存后会按「默认从/models获取所有模型」填列表。先复制下面的 Model ID；没有就点「添加模型」粘贴，功能选 LLM。
先选模型类型，再复制 Model ID。接口地址不随模型变化。
当前选中
- 提供商
- Claude
- Model ID
- claude-sonnet-4-6
完整模型列表以 AI Code With 文档与定价页为准。截图里的 chatgpt-4o-latest 等只说明自动同步位置，请用本页提供的 ID。
查看完整模型列表列表里的 chatgpt-4o-latest 等是中转站目录，不是本页 Model ID。启用或「添加模型」时请粘贴本页复制的 ID。 选择模型并发送测试消息
回到对话，顶栏点「请选择模型」，选出刚加的模型，发一条测试。截图停在未选模型、还没有回复。成功就是真实回复，再去用量记录按时间和模型核对。不要把「检查」当成接入成功。没回复见下方排错。
回到对话，顶栏仍是「请选择模型」（截图未发消息）。点「请选择模型」选出刚加的模型，发一条测试。成功 = 真实回复 + 用量记录。不要把「检查」当成功。
AingDesk 如何接入 AI Code With？
AingDesk 用自定义供应商走 OpenAI 兼容接口。接入 AI Code With 只需添加模型服务商、填接口地址和密钥，再选用模型：
- 使用第三方模型
- 首次打开 AingDesk 会出现欢迎页。点「使用第三方模型」，应进入「第三方API配置」。若欢迎页已经关掉，改走侧栏「第三方模型API」。
- 添加模型服务商
- 在「第三方API配置」窗口底部点「添加模型服务商」（不要点内置的硅基流动等磁贴）。应弹出「添加模型服务商」表单。
- 填写供应商名称、接口地址和密钥
- 供应商名称可填 AI Code With，接口地址填 https://api.aicodewith.ai/v1（助手文案：需要兼容openAI格式的接口），密钥粘贴 AI Code With Key，点「确认」。不要再拼 /chat/completions。
- 同步或手动添加模型
- 保存后列表会按「默认从/models获取所有模型」自动填充。截图里的 chatgpt-4o-latest 等是中转站目录，不是本页 Model ID。没有本页 ID 就点「添加模型」粘贴，模型功能选 LLM。
- 选择模型并发送测试消息
- 回到对话，顶栏点「请选择模型」，选出刚加的模型，发一条测试消息。成功 = 真实回复，再到用量记录核对。不要把「检查」当接入成功。
整体关系：AingDesk → 自定义供应商（供应商名称 + 接口地址 /v1 + 密钥）→ AI Code With API。全部在 GUI 完成，不改文件。
常见问题
还没安装 AingDesk？
AingDesk 是开源桌面 AI 助手，支持 Windows 和 macOS。
Intel Mac 已不再支持；Docker :7071 是服务端，不是本页默认路径。完整安装说明以 AingDesk 官网为准，本站不托管安装包或镜像。
常见错误排查
配置过程中最常见的问题集中在 4 类。
保存后模型列表为空 / 确认卡住
现象： 点「确认」很久没有结果，或保存后「默认从/models获取所有模型」仍是空列表。
原因： AingDesk 把填写的接口地址原样当作 baseURL，直接 GET {baseUrl}/models，不会自动补 /v1。漏写 /v1、再拼 /chat/completions、密钥无效、或上游目录为空都会空。确认会阻塞拉全量模型（#105）。
- 接口地址只填 https://api.aicodewith.ai/v1，不要再加 /chat/completions
- 列表为空就点「添加模型」，粘贴本页复制的 Model ID
- 模型功能选 LLM
聊天左上角选不到刚加的模型 / 只有 Ollama
现象： 加完供应商后，对话顶栏「请选择模型」下拉没有它，或只能看到 Ollama。
原因： 该供应商开关未启用；加模型后列表不刷新，需要关窗重开（#50）；自动导入且 title==="" 的模型会被前端滤掉；其它供应商没关，列表被刷屏（#92）。
- 启用本页这个供应商，关掉其它供应商
- 关掉再打开「第三方模型API」让列表刷新
- 必要时手动填写模型ID和模型别名
发消息失败 / 密钥无效，但「检查」显示成功
现象： 已保存供应商面板上「检查」提示配置正确，发消息却 401、没有回复，或提示意外中断。
原因： 「检查」和「保存API」只出现在已保存供应商面板。「检查」是桩，不打网络，恒返回成功。真实验证只能靠对话回复和 AI Code With 用量记录。
- 重新粘贴 AI Code With 密钥，不要把「检查成功」当成接入成功
- 确认接口地址带 /v1
- 发一条测试消息，再到用量记录按时间与模型核对
中转站部分模型找不到 / 模型不存在
现象： 保存后有一长串模型，但本页复制的 ID 没有；或发消息提示模型不存在。
原因： /models 返回的是上游目录，不是当前密钥可用的 ID。只开开关不会让模型从聊天下拉消失，必须删除（#92）。第 4 张截图里的 chatgpt-4o-latest 等就是这种中转站目录。
- 点「添加模型」粘贴本页复制的 Model ID
- 不要把接口地址改成 /chat/completions
- 确认当前密钥有权访问该模型