在 DeepSeek Harness 中使用 Claude:自訂模型 API 設定

把 AI in IDE 以自訂模型 API 的方式加入 DeepSeek Harness(dsh),就能在 Web UI 或 headless 模式中使用 Claude Opus 5.5、Sonnet 5.5 或 Haiku 4.5。

已於 2026-11-06 以 @deepseek-ai/dsh 0.2.2-rc.1 測試:依下方兩種設定,dsh --profile headless 透過 claude-sonnet-5-5 與 claude-haiku-4-5-20251001 都有回覆。

快速設定

  1. 建立 API Key。 打開 API Keys 建立金鑰,渠道選 AWSQ 或 CCMAX。
  2. 打開 provider 表單。 用 npx @deepseek-ai/dsh web 啟動 Web UI,進入 Settings → Models → Add model provider,再把卡片切換到 Custom model API。
  3. 填寫欄位。
    • Provider ID: aiinide(小寫;之後無法改名)
    • API protocol: Anthropic Messages
    • Base URL: https://api.aiinide.com
    • API key: 你的控制台金鑰
    • Models: claude-sonnet-5-5、claude-opus-5-5、claude-haiku-4-5-20251001,或點 Fetch available models
  4. 驗證。 在模型選擇器中選 aiinide provider 底下的 claude-sonnet-5-5,送出一段簡短的提示。這筆請求會出現在 Usage。

在 cordis.patch.yml 中設定

表單會寫入 $DSH_HOME/profiles/<profile>/cordis.patch.yml;dsh web 使用的 profile 是 web。若要手動設定,或用於 headless 執行,請把下面內容加入該 profile 的 patch 檔,並匯出 AIINIDE_API_KEY:

1
- id: llm-pi-ai
2
  config:
3
    providers:
4
      aiinide:
5
        apiKeyEnv: AIINIDE_API_KEY
6
        api: anthropic-messages
7
        baseURL: https://api.aiinide.com
8
        models:
9
          - id: claude-sonnet-5-5
10
          - id: claude-opus-5-5
11
          - id: claude-haiku-4-5-20251001
12
- id: agent-default-model
13
  config:
14
    provider: aiinide
15
    model: claude-sonnet-5-5

接著執行 dsh --profile headless "Reply with exactly: OK",會印出 OK。設定會在下一次請求時重新讀取,不需要重新啟動。

哪個 Base URL 搭配哪個協定

API protocolBase URL填錯時的結果
Anthropic Messages(anthropic-messages)https://api.aiinide.com加上 /v1 → PI_AI_ERROR: 404
OpenAI Chat Completions(openai-completions)https://api.aiinide.com/v1只填主機位址 → 400 This endpoint requires a CODEX API key

兩種協定都接受 AWSQ 與 CCMAX 金鑰。建議使用 Anthropic Messages:它保留 Fast mode 與託管工具等 Claude 擴充功能,相容 OpenAI 的端點不支援這些功能。一個 provider 只使用一種協定,兩種都要的話請再加一個 provider。

常見問題

DeepSeek Harness 接 AI in IDE 要用哪個 Base URL?

Anthropic Messages 協定用 https://api.aiinide.com,OpenAI Chat Completions 協定用 https://api.aiinide.com/v1。

為什麼新的工作階段還是使用 deepseek-flash?

預設模型是 deepseek-official / deepseek-flash。在模型選擇器中選 AI in IDE 的模型,它也會成為新工作階段的預設模型;或者像上方範例那樣,在 cordis.patch.yml 中設定 agent-default-model。

金鑰存在哪裡?

在表單中輸入的金鑰會存到 $DSH_HOME/.credentials.yaml,設定中只保留一個引用。使用 apiKeyEnv 時,金鑰只留在你的環境變數中,不會寫進任何檔案。

dsh 需要哪個 Node.js 版本?

@deepseek-ai/dsh 套件宣告需要 Node.js 24.9.0 或更新版本。

相關頁面

在 DeepSeek Harness 中使用 Claude:自訂模型 API 設定|AI in IDE