工具下载

整理了主流 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
    —
你的系统
你的网络
可选:把 npm 源换成国内镜像
下面的 npm 命令已经自带了国内镜像参数,不做这一步也能装。执行一次这条,以后所有 npm 安装都走国内源,会快不少。
npm config set registry https://registry.npmmirror.com

命令行工具

· 8

Claude Code

新手推荐兼容 3306.AI
Anthropic · 命令行工具

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

官网那条 curl 命令在国内用不了:我们实测时它返回的是一个「本地区不可用」的网页,不是安装脚本,照着执行只会报一串看不懂的错。下面这条装的是官方发布在 npm 上的同一个程序。装好后按本页说明接到 3306.AI —— 在国内直连官方接口会被拒绝。
需要先装 Node.js 22 以上
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
升级npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com
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
    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 官方开源终端代理,支持本地代码沙箱执行。

官网那条命令的域名在国内解析不到正确地址,连不上。下面这条装的是官方发布在 npm 上的同一个程序。装好后同样要接到 3306.AI,直连 OpenAI 在国内也走不通。
需要先装 Node.js
npm install -g @openai/codex --registry=https://registry.npmmirror.com
升级npm install -g @openai/codex@latest --registry=https://registry.npmmirror.com
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
    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
    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 --registry=https://registry.npmmirror.com
升级npm install -g @google/gemini-cli@latest --registry=https://registry.npmmirror.com
装的过程中如果报编译错误(提示 node-gyp),说明机器上缺编译工具:Windows 装 VS Build Tools,macOS 装 Xcode 命令行工具,装完再试一次。另外 Gemini 官方接口在国内连不上,接到 3306.AI 就行。

DeepSeek Harness

兼容 3306.AI
DeepSeek · 命令行工具

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

需要先装 Node.js 22 以上
npx --registry=https://registry.npmmirror.com @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
    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
    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 编程代理,模型与提供商完全可插拔。

官方脚本最后要去 GitHub 取文件,国内时快时断 —— 我们同一天测,有一次一两秒就好,也有一次一直超时。下面这条走 npm,我们测的几次都稳。
需要先装 Node.js
npm install -g opencode-ai --registry=https://registry.npmmirror.com
升级npm install -g opencode-ai@latest --registry=https://registry.npmmirror.com
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
    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 兼容模型。

官方那条命令本身能下载下来,但它接着要去 GitHub 取文件,国内那一步慢到基本下不完。下面这条改用国内镜像源。
需要先装 Python 3.10~3.12(自带 pip)
pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple && UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple uv tool install aider-chat
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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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」的才需要这一步,其余是单文件安装,不用 Node。
  • 报 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