工具下載
整理了主流 AI 程式設計命令列工具、IDE、編輯器擴充套件和桌面客戶端,都能接到 3306.AI 上用,實際設定見各自卡片。
- 1安裝工具在下面挑一個,依你的系統複製那行指令,貼到終端機裡執行。
- 2取得金鑰到「API 金鑰」頁新建一把,明文只出現這一次,先複製好。
- 3接上 3306.AI用下方的一鍵接入,或把 Base URL 和金鑰填進工具設定裡。
- 4問一句驗證隨便問句話,能正常回答就算通了;報錯就看卡片裡的排查清單。
用戶端一鍵接入
選一把金鑰和一個模型,點一下就喚起用戶端並把 Base URL 和金鑰填好。沒有可查證喚起連結的用戶端,給一鍵複製設定。
貼上你保存的那把 key。明文只在建立時顯示一次,伺服器只存雜湊、取不回來 —— 找不到就新建一把。
這裡只列你帳號真正呼叫得通的模型。它會成為用戶端的預設模型,進用戶端後還能自己換。
點一下會在本機開啟用戶端並預先填好供應商設定。這裡每一條連結格式都對著用戶端自己的原始碼或官方文件查證過。
- Cherry Studio
— - ChatBox
— - DeepChat
— - Claude Code經 CC Switch
— - Codex CLI經 CC Switch
— - opencode經 CC Switch
— - AionUi
—
命令列工具
· 8Claude Code
新手推薦相容 3306.AIAnthropic 官方终端编程代理,支持子代理、Hooks、MCP。
curl -fsSL https://claude.ai/install.sh | bashclaude updatehttps://3306.ai/anthropic接不上?照這幾條排查
- 填完儲存就回 404Base URL 請填 https://3306.ai/anthropic,用戶端會自己往後接 /v1/messages。另外只實作了 Messages 介面,Anthropic 早年的 /v1/complete 文字補全端點並未提供。
- 偶發 5xx:一般問答正常,開長脈絡或功能旗標就掛用戶端送出的 anthropic-version 與 anthropic-beta 兩個標頭會原樣轉送到上游。若你中間架了自建代理,務必把這兩個標頭一起放行 —— 少了 anthropic-beta,帶功能旗標的請求會被上游拒收。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Codex CLI
新手推薦相容 3306.AIOpenAI 官方开源终端代理,支持本地代码沙箱执行。
curl -fsSL https://chatgpt.com/codex/install.sh | shcodex updatehttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Qwen Code
新手推薦相容 3306.AI阿里通义官方终端编程代理,Gemini CLI 同源架构,中文生态完善。
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bashqwen updatehttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Gemini CLI
相容 3306.AIGoogle 官方 Gemini 终端代理,免费层 1M token 上下文。
npm install -g @google/gemini-clinpm install -g @google/gemini-cli@latestDeepSeek Harness
相容 3306.AIDeepSeek 官方开源 agent 框架(dsh),模型/工具/沙箱全部插件化。
npx @deepseek-ai/dsh@0.1.7-alpha.1 webhttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Kimi Code CLI
相容 3306.AI月之暗面官方终端代理(原 Kimi CLI 继任版),单文件安装,支持 MCP。
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bashkimi upgradehttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
opencode
相容 3306.AI开源的终端 AI 编程代理,模型与提供商完全可插拔。
curl -fsSL https://opencode.ai/install | bashhttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Aider
相容 3306.AI经典终端 AI 配对编程工具,Git 友好,supports 任意 OpenAI 兼容模型。
curl -LsSf https://aider.chat/install.sh | shhttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
實用工具
· 4NextChat
相容 3306.AI开源 Web / 桌面聊天客户端(原 ChatGPT-Next-Web),一键部署,自定义接口。
https://3306.ai/v1- API Key 填在
- 設定 → 自訂介面:介面位址填 Base URL,API Key 填 sk_live_…(不帶 Bearer 前綴)。
- 注意
- 自訂模型名要用 GET /v1/models 裡的原樣字串,在 NextChat 裡以「+模型名」加入清單。請求由瀏覽器直連,Key 存在本機瀏覽器裡,別在公用電腦上填。
接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
ChatBox
相容 3306.AI跨平台桌面 / 移动聊天客户端,支持自定义 OpenAI 兼容提供方与余额显示。
brew install --cask chatboxhttps://3306.ai/v1- API Key 填在
- 設定 → 模型提供方 → 新增自訂提供方(OpenAI API 相容):API 網域填 Base URL(不加 /chat/completions),API 金鑰填 sk_live_…。
- 注意
- API 路徑保持預設 /chat/completions;模型清單點「取得」即可拉取目錄。「餘額」顯示的是美元(1★ = $0.01)。
接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Cherry Studio
相容 3306.AI多模型桌面客户端,内置知识库、助手预设与 MCP,支持任意 OpenAI 兼容服务。
brew install --cask cherry-studiohttps://3306.ai/v1- API Key 填在
- 設定 → 模型服務 → 新增:提供商類型選 OpenAI,API 金鑰填 sk_live_…,API 位址填 Base URL(Cherry 會自動補 /chat/completions)。
- 注意
- 點「管理」拉取模型清單後再勾選要用的模型。Claude 系模型也走這條 OpenAI 協議線即可,不必另加 Anthropic 提供商。
接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
CC Switch
相容 3306.AI在多个 Claude Code 配置(供应商、密钥、Base URL)之间一键切换。
brew install --cask cc-switchbrew upgrade --cask cc-switchhttps://3306.ai/anthropic接不上?照這幾條排查
- 填完儲存就回 404Base URL 請填 https://3306.ai/anthropic,用戶端會自己往後接 /v1/messages。另外只實作了 Messages 介面,Anthropic 早年的 /v1/complete 文字補全端點並未提供。
- 偶發 5xx:一般問答正常,開長脈絡或功能旗標就掛用戶端送出的 anthropic-version 與 anthropic-beta 兩個標頭會原樣轉送到上游。若你中間架了自建代理,務必把這兩個標頭一起放行 —— 少了 anthropic-beta,帶功能旗標的請求會被上游拒收。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
AI IDE
· 4Cursor
相容 3306.AIAI 原生 IDE,基于 VS Code,内置 Tab 补全、Agent、Composer。
https://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Windsurf
相容 3306.AICodeium 推出的 AI 编辑器,主打 Cascade 多步代理流。
https://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Zed
相容 3306.AIRust 编写的极速协作编辑器,内置 AI 助手与 ACP 协议。
https://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
編輯器擴充功能
· 3Cline
相容 3306.AIVS Code 上最流行的 AI 编程扩展,支持 Plan/Act 双模式。
code --install-extension saoudrizwan.claude-devhttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Roo Code
相容 3306.AICline 衍生,功能更激进,支持自定义模式与多 Agent 协同。
code --install-extension RooVeterinaryInc.roo-clinehttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
Continue
相容 3306.AI开源 VS Code / JetBrains 扩展,自托管友好,可对接任意模型。
code --install-extension Continue.continuehttps://3306.ai/v1接不上?照這幾條排查
- 填完儲存就回 404Base URL 必須剛好是 https://3306.ai/v1,用戶端會自己往後接 /chat/completions。少寫 /v1,或把完整端點路徑當成 Base URL 填進去,都會 404。
- 自己寫的串流解析器讀到一半就出錯SSE 串流中會夾帶以冒號開頭的保活註解行(例如 : ping),解析時直接略過,別當成資料框。使用官方 SDK 則不必處理,SDK 已代為處理。
- 送圖片被 400 拒絕目標模型不支援讀圖。帶圖請求在送往上游之前會先過一道閘,寧可明確報錯,也不會把圖丟掉、改用純文字模型編一個答案。請改用文件「能力矩陣」中讀圖那一欄打勾的模型。
- 401 invalid_api_key只接受 Authorization: Bearer sk_live_… 或 x-api-key: sk_live_… 兩種寫法。貼上時別把引號與前後空白一起帶進設定檔。
- 403 insufficient_scope回應中會寫明缺少哪個權限,例如 This API key does not have permission for chat。這把 Key 建立時沒有勾選對話權限,請到主控台重新建立一把含 chat 權限的 Key。
- 404 model_not_found用戶端內建的預設模型名稱(gpt-4o、claude-3-5-sonnet 之類)不在我們的目錄中。請先呼叫 GET /v1/models 取得清單,再把用戶端的模型名稱換成清單中的原樣字串。
- 429 被限流回應標頭帶有 Retry-After(秒),等滿再重試,別立刻重送造成雪崩。若需要持續更高的並行量請開單洽詢。
- 402 餘額不足或無使用資格對外 API 只對付費帳號開放:需要有生效中的訂閱,或帳戶中有儲值而來的餘額。註冊贈送的星星在站內照常可用,但不構成 API 呼叫資格。
裝不上?按這幾條排查
- 提示 command not found: npm / node表示這台電腦還沒裝 Node.js。到 nodejs.org 下載安裝(選 LTS 版),裝完重開終端機再試。只有標示「需要先安裝 Node.js」的工具才需要這一步。
- 出現 EACCES / permission denied不要在前面加 sudo —— Anthropic 官方也明確不建議 sudo npm install -g:裝出來的檔案歸 root,日後更新會再出問題。建議用 nvm 之類的工具裝一份自己的 Node,或改用卡片上不需要 Node 的安裝方式。
- Windows 出現「無法載入檔案 npm.ps1,因為這個系統上已停用指令碼執行」這是 PowerShell 執行原則擋下來的,與工具本身無關。把指令裡的 npm 換成 npm.cmd(npx 換成 npx.cmd)再執行一次即可。
- 裝完了,但指令還是找不到多半是終端機沒重新載入環境變數:關掉視窗重開一個再試。Qwen Code 在 Windows 上一定要這麼做。若仍不行,檢查安裝輸出提示的目錄有沒有加進 PATH。
- 下載卡住不動,或久久沒反應先確認上面的「你的網路」選對了 —— 選「中國大陸」給的是我們在國內測試機上裝得起來的指令。卡片上的紅字說的是官網原本那條為什麼不能用,不是說這個工具裝不了。npm 慢就先執行上面那條換來源指令。若照卡片指令仍失敗,請把完整錯誤訊息交給技術支援。