deepseek-ai/awesome-deepseek-agent

Fork 0

mirror of https://github.com/deepseek-ai/awesome-deepseek-agent.git synced 2026-11-05 01:07:37 +00:00

[GH-ISSUE #124] Claude 桌面端 Model Discovery 404 #43

New issue

Open

opened 2026-10-26 09:44:13 +00:00 by bsakaguchi · 7 comments

bsakaguchi commented

2026-10-26 09:44:13 +00:00

Owner

Originally created by @nephelo-xyz on GitHub (May 20, 2026).
Original GitHub issue: https://github.com/deepseek-ai/awesome-deepseek-agent/issues/124

这个问题有修复吗？使用倒是可以，只是一直会弹窗 Gateway returned an error

Originally created by @nephelo-xyz on GitHub (May 20, 2026). Original GitHub issue: https://github.com/deepseek-ai/awesome-deepseek-agent/issues/124 <img width="900" height="688" alt="Image" src="https://github.com/user-attachments/assets/30e01fbc-ae68-4d0a-a66d-8f125f374838" /> 这个问题有修复吗？使用倒是可以，只是一直会弹窗 Gateway returned an error

bsakaguchi commented

2026-10-26 09:44:14 +00:00

Author

Owner

@jiqi136 commented on GitHub (May 20, 2026):

不选择 Bearer ，试试 x-api-key

@jiqi136 commented on GitHub (May 20, 2026): 不选择 Bearer ，试试 x-api-key

bsakaguchi commented

2026-10-26 09:44:14 +00:00

Author

Owner

@sicaboy commented on GitHub (May 21, 2026):

@sicaboy commented on GitHub (May 21, 2026): +1

bsakaguchi commented

2026-10-26 09:44:15 +00:00

Author

Owner

@sicaboy commented on GitHub (May 21, 2026):

不选择 Bearer ，试试 x-api-key

也不行，一样的。Claude Desktop他写死了要读这个endpoints：
404 https://api.deepseek.com/anthropic/v1/models

@sicaboy commented on GitHub (May 21, 2026): > 不选择 Bearer ，试试 x-api-key 也不行，一样的。Claude Desktop他写死了要读这个endpoints： 404 https://api.deepseek.com/anthropic/v1/models

bsakaguchi commented

2026-10-26 09:44:15 +00:00

Author

Owner

@BenedictKing commented on GitHub (May 29, 2026):

这个问题的根因是 Claude Desktop 启动时会调用 /v1/models 端点做模型发现，而 DeepSeek 的 /anthropic 端点不支持这个路由，返回 404 导致持续弹窗。

CCX可以解决这个问题。它作为本地代理，会正确响应 /v1/models 请求 —— 返回你在 CCX 渠道中配置的模型列表，不会出现 404。

配置方式：

# 1. 启动 CCX（详见 https://github.com/BenedictKing/ccx）
# 2. 在 CCX Web UI 中添加 Messages 渠道，指向 DeepSeek Anthropic 端点
# 3. Claude Desktop settings.json 中指向 CCX：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:3000",
    "ANTHROPIC_API_KEY": "your-ccx-proxy-key"
  }
}

验证模型列表是否正常返回：

curl http://localhost:3000/v1/models \
  -H "Authorization: Bearer your-ccx-proxy-key"

返回 deepseek-v4-pro 和 deepseek-v4-flash 即说明渠道健康，Claude Desktop 不会再弹 404。

集成指南：docs/ccx.md

@BenedictKing commented on GitHub (May 29, 2026): 这个问题的根因是 Claude Desktop 启动时会调用 `/v1/models` 端点做模型发现，而 DeepSeek 的 `/anthropic` 端点不支持这个路由，返回 404 导致持续弹窗。 [**CCX**](https://github.com/BenedictKing/ccx)可以解决这个问题。它作为本地代理，会正确响应 `/v1/models` 请求 —— 返回你在 CCX 渠道中配置的模型列表，不会出现 404。配置方式： ```bash # 1. 启动 CCX（详见 https://github.com/BenedictKing/ccx） # 2. 在 CCX Web UI 中添加 Messages 渠道，指向 DeepSeek Anthropic 端点 # 3. Claude Desktop settings.json 中指向 CCX： { "env": { "ANTHROPIC_BASE_URL": "http://localhost:3000", "ANTHROPIC_API_KEY": "your-ccx-proxy-key" } } ``` 验证模型列表是否正常返回： ```bash curl http://localhost:3000/v1/models \ -H "Authorization: Bearer your-ccx-proxy-key" ``` 返回 `deepseek-v4-pro` 和 `deepseek-v4-flash` 即说明渠道健康，Claude Desktop 不会再弹 404。集成指南：[docs/ccx.md](https://github.com/deepseek-ai/awesome-deepseek-agent/blob/main/docs/ccx.md)

bsakaguchi commented

2026-10-26 09:44:15 +00:00

Author

Owner

@FlyFFFlowers commented on GitHub (Jun 3, 2026):

不选择 Bearer ，试试 x-api-key

也不行，一样的。Claude Desktop他写死了要读这个endpoints： 404 https://api.deepseek.com/anthropic/v1/models

模型名直接填claude的opus和sonnet官方模型名，会自动映射成deepseek的pro和flash

@FlyFFFlowers commented on GitHub (Jun 3, 2026): > > 不选择 Bearer ，试试 x-api-key > > 也不行，一样的。Claude Desktop他写死了要读这个endpoints： 404 https://api.deepseek.com/anthropic/v1/models 模型名直接填claude的opus和sonnet官方模型名，会自动映射成deepseek的pro和flash

bsakaguchi commented

2026-10-26 09:44:15 +00:00

Author

Owner

@HWBobKit commented on GitHub (Jun 16, 2026):

使用CCX之后还是不行，感觉配置没有生效

@HWBobKit commented on GitHub (Jun 16, 2026): 使用CCX之后还是不行，感觉配置没有生效

bsakaguchi commented

2026-10-26 09:44:16 +00:00

Author

Owner

@tianhao8687 commented on GitHub (Aug 17, 2026):

这个 404 属于“模型发现接口不兼容”，不是鉴权失败，所以在 Bearer 与 x-api-key 之间切换不会解决。

Claude Desktop 启动时会探测 .../v1/models，而 DeepSeek 的 Anthropic 兼容端点主要实现的是 /v1/messages，目前并未提供 https://api.deepseek.com/anthropic/v1/models。因此会出现“聊天可用，但模型发现持续弹 404”的现象。

当前官方 Anthropic 接入文档给出的模型映射是：

claude-opus* → deepseek-v4-pro
claude-sonnet* / claude-haiku* → deepseek-v4-flash

所以可先保持 Base URL 为 https://api.deepseek.com/anthropic，在客户端里选择/填写 Claude 的映射名称；如果消息调用正常，这个弹窗本身不代表推理请求失败。

要彻底消除弹窗，需要 DeepSeek 补齐 /v1/models，或在本地网关中实现该路由并返回模型列表。若网关仍弹 404，先直接 curl <网关地址>/v1/models 验证请求是否真的经过网关，再检查 Claude Desktop 是否完全重启并加载了新配置。

@tianhao8687 commented on GitHub (Aug 17, 2026): 这个 404 属于“模型发现接口不兼容”，不是鉴权失败，所以在 Bearer 与 `x-api-key` 之间切换不会解决。 Claude Desktop 启动时会探测 `.../v1/models`，而 DeepSeek 的 Anthropic 兼容端点主要实现的是 `/v1/messages`，目前并未提供 `https://api.deepseek.com/anthropic/v1/models`。因此会出现“聊天可用，但模型发现持续弹 404”的现象。当前[官方 Anthropic 接入文档](https://api-docs.deepseek.com/zh-cn/guides/anthropic_api)给出的模型映射是： - `claude-opus*` → `deepseek-v4-pro` - `claude-sonnet*` / `claude-haiku*` → `deepseek-v4-flash` 所以可先保持 Base URL 为 `https://api.deepseek.com/anthropic`，在客户端里选择/填写 Claude 的映射名称；如果消息调用正常，这个弹窗本身不代表推理请求失败。要彻底消除弹窗，需要 DeepSeek 补齐 `/v1/models`，或在本地网关中实现该路由并返回模型列表。若网关仍弹 404，先直接 `curl <网关地址>/v1/models` 验证请求是否真的经过网关，再检查 Claude Desktop 是否完全重启并加载了新配置。

bsakaguchi referenced this issue

2026-10-26 09:46:23 +00:00

[PR #43] Add English Cline CLI DeepSeek guide #163