工具下載

整理了主流 AI 程式設計命令列工具、IDE、編輯器擴充套件和桌面客戶端,都能接到 3306.AI 上用,實際設定見各自卡片。

如何在這些工具中使用 3306.AI API
大多數工具支援自訂 Base URL 與 API Key。將下面兩項填入工具的設定/環境變數即可:
OPENAI BASE URL · https://3306.ai/v1
CLAUDE BASE URL · https://3306.ai/anthropic
API KEY · sk_live_xxxxxxxxxxxxxxxx
  1. 1
    安裝工具
    在下面挑一個,依你的系統複製那行指令,貼到終端機裡執行。
  2. 2
    取得金鑰
    到「API 金鑰」頁新建一把,明文只出現這一次,先複製好。
  3. 3
    接上 3306.AI
    用下方的一鍵接入,或把 Base URL 和金鑰填進工具設定裡。
  4. 4
    問一句驗證
    隨便問句話,能正常回答就算通了;報錯就看卡片裡的排查清單。

用戶端一鍵接入

選一把金鑰和一個模型,點一下就喚起用戶端並把 Base URL 和金鑰填好。沒有可查證喚起連結的用戶端,給一鍵複製設定。

這會把你的 API 金鑰交給該用戶端。 連結在你點擊的那一刻才在瀏覽器裡組出來,自訂協定由作業系統接管,全程不經過我們的伺服器。但用戶端拿到金鑰後就能消耗你的餘額,所以只在自己信得過的電腦上這麼做。

貼上你保存的那把 key。明文只在建立時顯示一次,伺服器只存雜湊、取不回來 —— 找不到就新建一把。

預設模型
正在讀取你可呼叫的模型…

這裡只列你帳號真正呼叫得通的模型。它會成為用戶端的預設模型,進用戶端後還能自己換。

一鍵喚起

點一下會在本機開啟用戶端並預先填好供應商設定。這裡每一條連結格式都對著用戶端自己的原始碼或官方文件查證過。

  • Cherry Studio
    —
  • ChatBox
    —
  • DeepChat
    —
  • Claude Code經 CC Switch
    —
  • Codex CLI經 CC Switch
    —
  • opencode經 CC Switch
    —
  • AionUi
    —
複製設定

這幾個用戶端沒有我們能查證的喚起連結 —— 與其給一個點了沒反應的按鈕,不如直接複製設定,貼到用戶端的設定裡。

  • NextChat
    —
  • LobeChat
    —
  • OpenCat
    —
  • Cline
    —
  • Roo Code
    —
  • Continue
    —
  • Cursor
    —
你的系統
你的網路

命令列工具

· 8

Claude Code

新手推薦相容 3306.AI
Anthropic · 命令列工具

Anthropic 官方终端编程代理,支持子代理、Hooks、MCP。

curl -fsSL https://claude.ai/install.sh | bash
升級claude update
Base URLhttps://3306.ai/anthropic
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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.AI
OpenAI · 命令列工具

OpenAI 官方开源终端代理,支持本地代码沙箱执行。

curl -fsSL https://chatgpt.com/codex/install.sh | sh
升級codex update
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
Alibaba · 命令列工具

阿里通义官方终端编程代理,Gemini CLI 同源架构,中文生态完善。

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
升級qwen update
裝完要重開一個終端機視窗,qwen 指令才認得到。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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.AI
Google · 命令列工具

Google 官方 Gemini 终端代理,免费层 1M token 上下文。

需要先安裝 Node.js 20 以上
npm install -g @google/gemini-cli
升級npm install -g @google/gemini-cli@latest
安裝過程若出現編譯錯誤(提示 node-gyp),表示機器上缺編譯工具:Windows 裝 VS Build Tools,macOS 裝 Xcode 命令列工具,裝完再試一次。另外 Gemini 官方介面在中國大陸連不上,接到 3306.AI 即可。

DeepSeek Harness

相容 3306.AI
DeepSeek · 命令列工具

DeepSeek 官方开源 agent 框架(dsh),模型/工具/沙箱全部插件化。

需要先安裝 Node.js 22 以上
npx @deepseek-ai/dsh@0.1.7-alpha.1 web
指令裡的版本號是必要的:上游最新版標籤相依了一個並不存在的套件,照官方文件那條不帶版本號的指令會直接失敗。等上游修好後這裡會拿掉版本號。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
Moonshot AI · 命令列工具

月之暗面官方终端代理(原 Kimi CLI 继任版),单文件安装,支持 MCP。

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
升級kimi upgrade
舊版 Kimi CLI 官方已停止維護,裝過的請用上面這條指令換成新版。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
anomalyco · 命令列工具

开源的终端 AI 编程代理,模型与提供商完全可插拔。

curl -fsSL https://opencode.ai/install | bash
Windows 上裝過 scoop 的,也可以用 scoop install opencode。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
paul-gauthier · 命令列工具

经典终端 AI 配对编程工具,Git 友好,supports 任意 OpenAI 兼容模型。

curl -LsSf https://aider.chat/install.sh | sh
aider 要求 Python 在 3.10 到 3.12 之間。機器上沒有這個範圍的 Python 時,uv 會自己去 GitHub 下載一個,那一步會很慢。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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 呼叫資格。

實用工具

· 4

NextChat

相容 3306.AI
ChatGPTNextWeb · 實用工具

开源 Web / 桌面聊天客户端(原 ChatGPT-Next-Web),一键部署,自定义接口。

Base URLhttps://3306.ai/v1
API Key 填在
設定 → 自訂介面:介面位址填 Base URL,API Key 填 sk_live_…(不帶 Bearer 前綴)。
注意
自訂模型名要用 GET /v1/models 裡的原樣字串,在 NextChat 裡以「+模型名」加入清單。請求由瀏覽器直連,Key 存在本機瀏覽器裡,別在公用電腦上填。
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
Chatbox AI · 實用工具

跨平台桌面 / 移动聊天客户端,支持自定义 OpenAI 兼容提供方与余额显示。

需要先安裝 Homebrew
brew install --cask chatbox
Base URLhttps://3306.ai/v1
API Key 填在
設定 → 模型提供方 → 新增自訂提供方(OpenAI API 相容):API 網域填 Base URL(不加 /chat/completions),API 金鑰填 sk_live_…。
注意
API 路徑保持預設 /chat/completions;模型清單點「取得」即可拉取目錄。「餘額」顯示的是美元(1★ = $0.01)。
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
CherryHQ · 實用工具

多模型桌面客户端,内置知识库、助手预设与 MCP,支持任意 OpenAI 兼容服务。

需要先安裝 Homebrew
brew install --cask cherry-studio
Base URLhttps://3306.ai/v1
API Key 填在
設定 → 模型服務 → 新增:提供商類型選 OpenAI,API 金鑰填 sk_live_…,API 位址填 Base URL(Cherry 會自動補 /chat/completions)。
注意
點「管理」拉取模型清單後再勾選要用的模型。Claude 系模型也走這條 OpenAI 協議線即可,不必另加 Anthropic 提供商。
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
farion1231 · 實用工具

在多个 Claude Code 配置(供应商、密钥、Base URL)之间一键切换。

需要先安裝 Homebrew
brew install --cask cc-switch
升級brew upgrade --cask cc-switch
它的安裝檔放在 GitHub 上,在中國大陸不論用 brew 或手動下載都可能很慢。
Base URLhttps://3306.ai/anthropic
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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

· 4

Cursor

相容 3306.AI
Anysphere · AI IDE

AI 原生 IDE,基于 VS Code,内置 Tab 补全、Agent、Composer。

Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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.AI
Codeium · AI IDE

Codeium 推出的 AI 编辑器,主打 Cascade 多步代理流。

Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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.AI
Zed Industries · AI IDE

Rust 编写的极速协作编辑器,内置 AI 助手与 ACP 协议。

Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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 呼叫資格。

Trae

ByteDance · AI IDE

字节跳动推出的 AI IDE,中文友好,内置免费模型。

編輯器擴充功能

· 3

Cline

相容 3306.AI
Cline Team · 編輯器擴充功能

VS Code 上最流行的 AI 编程扩展,支持 Plan/Act 双模式。

需要先安裝 VS Code
code --install-extension saoudrizwan.claude-dev
這是 VS Code 的通用裝法。macOS 第一次使用要先在 VS Code 按 Cmd+Shift+P 執行「Shell Command: Install 'code' command in PATH」。也可以直接在擴充套件面板搜名字安裝。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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.AI
Roo Code · 編輯器擴充功能

Cline 衍生,功能更激进,支持自定义模式与多 Agent 协同。

需要先安裝 VS Code
code --install-extension RooVeterinaryInc.roo-cline
這是 VS Code 的通用裝法。macOS 第一次使用要先在 VS Code 按 Cmd+Shift+P 執行「Shell Command: Install 'code' command in PATH」。也可以直接在擴充套件面板搜名字安裝。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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
Continue.dev · 編輯器擴充功能

开源 VS Code / JetBrains 扩展,自托管友好,可对接任意模型。

需要先安裝 VS Code
code --install-extension Continue.continue
這是 VS Code 的通用裝法。macOS 第一次使用要先在 VS Code 按 Cmd+Shift+P 執行「Shell Command: Install 'code' command in PATH」。也可以直接在擴充套件面板搜名字安裝。
Base URLhttps://3306.ai/v1
接不上?照這幾條排查
  • 填完儲存就回 404
    Base 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 慢就先執行上面那條換來源指令。若照卡片指令仍失敗,請把完整錯誤訊息交給技術支援。
所有安裝指令均取自各家官方文件,最近一次核對 2026-09-22。如需更多工具,請到「技術支援」回報,我們會持續整理。
Claude Code、Codex、Cursor 等 AI 編程工具接入 | 3306.AI