1. IntelliJ IDEA 2023.3 的 AI Assistant 到底卡在哪IntelliJ IDEA 2023.3 是 JetBrains 在 2023 年底推的一个大版本除了对 Java 21 的完整支持虚拟线程、记录模式、switch 模式匹配、序列化集合还正式把 AI Assistant 插件推到了台前。它能做什么简单说就是在编辑器里直接对话、解释代码、生成注释、写单元测试、重构建议甚至根据自然语言描述补全一段方法。适合谁日常写 Java/Kotlin/Scala 的后端、Android、大数据开发者尤其是已经在 IDEA 里泡了一整天、不想再切浏览器查文档的人。但问题也很直接AI Assistant 默认走的是 JetBrains 自己的 AI 服务底层模型调用对地区有限制国内网络环境下经常出现插件装上了、登录也过了但一发请求就转圈或者报连接失败。更尴尬的是它和 IDE 全家桶的授权体系并不完全是一套很多人发现自己有 IDEA Ultimate 授权AI Assistant 却依然提示需要单独开通。我试过几种绕法最后稳定下来的方案是不跟 IDE 内置的 AI 服务死磕而是把模型请求统一收敛到一个兼容 OpenAI 协议的中转层用一套 Key 管住所有模型调用。这样 IDEA 里不管是 AI Assistant 还是第三方插件比如 Continue、CodeGPT都指向同一个地址和 Key换模型只改一个配置项。下面就把这套配置骨架和踩坑过程完整写出来。2. 前置准备TaoToken 统一 Key 与 IDEA 侧要改什么TaoToken 在这里扮演的角色是「统一入口」你不需要在 IDEA 里分别填 OpenAI、Claude、Gemini 各自的 Key也不需要为每个插件单独配一遍。它对外暴露的是 OpenAI 兼容的/v1/chat/completions接口所以任何支持自定义 Base URL 的客户端都能接。先做两件事第一拿到统一 Key。访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。这个 Key 就是后面所有配置里填的那一串。第二确认 API 根地址。接口地址是 https://taotoken.net/api 注意这里不带任何查询参数配置时不要画蛇添足加斜杠或路径。IDEA 侧要动的地方有两块一是 AI Assistant 插件本身的自定义模型入口2023.3 版本里藏在 Settings 的 Tools 下二是如果你用 Continue 这类开源插件它有自己的config.json。本文重点给 AI Assistant 的配置骨架同时附一份 Continue 的settings.json对照因为很多人是两个一起用。注意IDEA 2023.3 的 AI Assistant 对自定义 Endpoint 的支持是逐步放开的如果你的版本里找不到 Custom Model 选项先升级到 2023.3.2 以上小版本或者直接用 Continue 插件走同一套 Key。3. 可复制配置settings.json 骨架与 Key 填写位置先给 Continue 插件的配置因为它的结构最清晰能直接看到 Base URL、Key、Model 三个关键字段的对应关系。在项目根目录或用户目录下建.continue/config.json{ models: [ { title: TaoToken Unified, provider: openai, model: gpt-4o-mini, apiKey: sk-你的TaoToken统一Key, apiBase: https://taotoken.net/api/v1 } ], tabAutocompleteModel: { title: TaoToken Autocomplete, provider: openai, model: gpt-4o-mini, apiKey: sk-你的TaoToken统一Key, apiBase: https://taotoken.net/api/v1 } }这里有几个容易填错的点。apiBase要写到/v1因为 OpenAI 兼容客户端会自动拼/chat/completions如果你只写到https://taotoken.net/api请求会变成/api/chat/completions直接 404。model字段填你想用的模型名TaoToken 侧支持多种模型换模型只改这一行Key 和地址不动。再给 IDEA AI Assistant 的自定义模型配置。2023.3 里路径是Settings → Tools → AI Assistant → Custom Models如果界面里没有可视化表单就手动编辑 IDE 配置目录下的ai-assistant.xml不同系统路径不同macOS 在~/Library/Application Support/JetBrains/IntelliJIdea2023.3/options/application component nameAIAssistantSettings option namecustomEndpoint valuehttps://taotoken.net/api/v1 / option namecustomApiKey valuesk-你的TaoToken统一Key / option namecustomModel valuegpt-4o-mini / option nameuseCustomModel valuetrue / /component /application改完重启 IDEA。如果你用的是 Continue改完config.json后在插件面板点 Reload 即可不用重启整个 IDE。配置项填写值说明Base URLhttps://taotoken.net/api/v1必须带 /v1API Keysk-开头的一串控制台创建勿泄露Modelgpt-4o-mini 等按需切换协议OpenAI Compatible不要选 Anthropic 原生4. 验证请求确认 IDEA 里真的通了配置写完别急着写代码先做一次最小验证。最直接的办法是在终端用 curl 打一发确认 Key 和地址本身没问题curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken统一Key \ -d { model: gpt-4o-mini, messages: [{role: user, content: 只回复两个字通了}] }正常返回里会有choices[0].message.content内容是「通了」。如果这一步就失败别去 IDEA 里折腾先解决 Key 或地址问题。curl 通了之后回到 IDEA。打开 Continue 面板输入「解释当前选中的方法」看是否流式返回。AI Assistant 那边把光标放到一个方法上右键选 AI Actions → Explain Code观察右下角是否有进度条和结果。实测下来第一次请求会慢一点因为要建立连接后续就正常了。如果 IDEA 里一直转圈但 curl 是通的八成是 IDE 的代理设置或 SSL 证书问题。检查Settings → Appearance Behavior → System Settings → HTTP Proxy选 No proxy 或 Auto-detect别手动填了失效的代理。5. 本篇常见报错排查报错一401 Unauthorized。九成是 Key 填错或复制时带了空格。检查apiKey字段确保是sk-开头且没有换行。另外确认 Key 没有在控制台被禁用或额度耗尽。报错二404 Not Found。地址写错了。最常见的是apiBase只写到https://taotoken.net/api少了/v1。改成https://taotoken.net/api/v1即可。报错三Connection timed out。网络层没通。先 curl 测如果 curl 也超时检查本机 DNS 和防火墙如果 curl 通而 IDE 不通检查 IDE 的代理设置关掉手动代理。报错四Model not found。model字段填了一个 TaoToken 侧不支持的模型名。换成文档里列出的可用模型或者先用gpt-4o-mini验证链路。报错五AI Assistant 里找不到 Custom Model 选项。版本太旧。升级 IDEA 到 2023.3.2 以上或者直接用 Continue 插件配置方式见第 3 节。报错六流式返回中断。通常是网络抖动或超时设置太短。Continue 的config.json里可以加requestOptions: {timeout: 60000}把超时放宽到 60 秒。6. 后续怎么用把统一 Key 铺到更多入口链路通了之后这套 Key 和地址可以复用到很多地方。比如你在 IDEA 里跑 Claude Code 做长任务编码或者用 Coding Plan 管理多个 Agent 的模型调用都可以指向同一个https://taotoken.net/api/v1。需要新建或轮换 Key 时去控制台操作https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先试试模型对话效果不写代码直接聊https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档里有各语言 SDK 的示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算长期在 IDE 里做编码 AgentCoding Plan 的入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后说个实际经验IDEA 的 AI 插件配置改完后有时候缓存不会立刻刷新表现为改了 Key 但请求还用旧的。这时候别反复改配置直接File → Invalidate Caches → Invalidate and Restart一次就好。另外把config.json和ai-assistant.xml纳入版本控制时记得把 Key 抽成环境变量别把sk-开头的字符串提交到仓库里。
1. IntelliJ IDEA 2023.3 的 AI Assistant 到底卡在哪IntelliJ IDEA 2023.3 是 JetBrains 在 2023 年底推的一个大版本除了对 Java 21 的完整支持虚拟线程、记录模式、switch 模式匹配、序列化集合还正式把 AI Assistant 插件推到了台前。它能做什么简单说就是在编辑器里直接对话、解释代码、生成注释、写单元测试、重构建议甚至根据自然语言描述补全一段方法。适合谁日常写 Java/Kotlin/Scala 的后端、Android、大数据开发者尤其是已经在 IDEA 里泡了一整天、不想再切浏览器查文档的人。但问题也很直接AI Assistant 默认走的是 JetBrains 自己的 AI 服务底层模型调用对地区有限制国内网络环境下经常出现插件装上了、登录也过了但一发请求就转圈或者报连接失败。更尴尬的是它和 IDE 全家桶的授权体系并不完全是一套很多人发现自己有 IDEA Ultimate 授权AI Assistant 却依然提示需要单独开通。我试过几种绕法最后稳定下来的方案是不跟 IDE 内置的 AI 服务死磕而是把模型请求统一收敛到一个兼容 OpenAI 协议的中转层用一套 Key 管住所有模型调用。这样 IDEA 里不管是 AI Assistant 还是第三方插件比如 Continue、CodeGPT都指向同一个地址和 Key换模型只改一个配置项。下面就把这套配置骨架和踩坑过程完整写出来。2. 前置准备TaoToken 统一 Key 与 IDEA 侧要改什么TaoToken 在这里扮演的角色是「统一入口」你不需要在 IDEA 里分别填 OpenAI、Claude、Gemini 各自的 Key也不需要为每个插件单独配一遍。它对外暴露的是 OpenAI 兼容的/v1/chat/completions接口所以任何支持自定义 Base URL 的客户端都能接。先做两件事第一拿到统一 Key。访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台创建 API Key。这个 Key 就是后面所有配置里填的那一串。第二确认 API 根地址。接口地址是 https://taotoken.net/api 注意这里不带任何查询参数配置时不要画蛇添足加斜杠或路径。IDEA 侧要动的地方有两块一是 AI Assistant 插件本身的自定义模型入口2023.3 版本里藏在 Settings 的 Tools 下二是如果你用 Continue 这类开源插件它有自己的config.json。本文重点给 AI Assistant 的配置骨架同时附一份 Continue 的settings.json对照因为很多人是两个一起用。注意IDEA 2023.3 的 AI Assistant 对自定义 Endpoint 的支持是逐步放开的如果你的版本里找不到 Custom Model 选项先升级到 2023.3.2 以上小版本或者直接用 Continue 插件走同一套 Key。3. 可复制配置settings.json 骨架与 Key 填写位置先给 Continue 插件的配置因为它的结构最清晰能直接看到 Base URL、Key、Model 三个关键字段的对应关系。在项目根目录或用户目录下建.continue/config.json{ models: [ { title: TaoToken Unified, provider: openai, model: gpt-4o-mini, apiKey: sk-你的TaoToken统一Key, apiBase: https://taotoken.net/api/v1 } ], tabAutocompleteModel: { title: TaoToken Autocomplete, provider: openai, model: gpt-4o-mini, apiKey: sk-你的TaoToken统一Key, apiBase: https://taotoken.net/api/v1 } }这里有几个容易填错的点。apiBase要写到/v1因为 OpenAI 兼容客户端会自动拼/chat/completions如果你只写到https://taotoken.net/api请求会变成/api/chat/completions直接 404。model字段填你想用的模型名TaoToken 侧支持多种模型换模型只改这一行Key 和地址不动。再给 IDEA AI Assistant 的自定义模型配置。2023.3 里路径是Settings → Tools → AI Assistant → Custom Models如果界面里没有可视化表单就手动编辑 IDE 配置目录下的ai-assistant.xml不同系统路径不同macOS 在~/Library/Application Support/JetBrains/IntelliJIdea2023.3/options/application component nameAIAssistantSettings option namecustomEndpoint valuehttps://taotoken.net/api/v1 / option namecustomApiKey valuesk-你的TaoToken统一Key / option namecustomModel valuegpt-4o-mini / option nameuseCustomModel valuetrue / /component /application改完重启 IDEA。如果你用的是 Continue改完config.json后在插件面板点 Reload 即可不用重启整个 IDE。配置项填写值说明Base URLhttps://taotoken.net/api/v1必须带 /v1API Keysk-开头的一串控制台创建勿泄露Modelgpt-4o-mini 等按需切换协议OpenAI Compatible不要选 Anthropic 原生4. 验证请求确认 IDEA 里真的通了配置写完别急着写代码先做一次最小验证。最直接的办法是在终端用 curl 打一发确认 Key 和地址本身没问题curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken统一Key \ -d { model: gpt-4o-mini, messages: [{role: user, content: 只回复两个字通了}] }正常返回里会有choices[0].message.content内容是「通了」。如果这一步就失败别去 IDEA 里折腾先解决 Key 或地址问题。curl 通了之后回到 IDEA。打开 Continue 面板输入「解释当前选中的方法」看是否流式返回。AI Assistant 那边把光标放到一个方法上右键选 AI Actions → Explain Code观察右下角是否有进度条和结果。实测下来第一次请求会慢一点因为要建立连接后续就正常了。如果 IDEA 里一直转圈但 curl 是通的八成是 IDE 的代理设置或 SSL 证书问题。检查Settings → Appearance Behavior → System Settings → HTTP Proxy选 No proxy 或 Auto-detect别手动填了失效的代理。5. 本篇常见报错排查报错一401 Unauthorized。九成是 Key 填错或复制时带了空格。检查apiKey字段确保是sk-开头且没有换行。另外确认 Key 没有在控制台被禁用或额度耗尽。报错二404 Not Found。地址写错了。最常见的是apiBase只写到https://taotoken.net/api少了/v1。改成https://taotoken.net/api/v1即可。报错三Connection timed out。网络层没通。先 curl 测如果 curl 也超时检查本机 DNS 和防火墙如果 curl 通而 IDE 不通检查 IDE 的代理设置关掉手动代理。报错四Model not found。model字段填了一个 TaoToken 侧不支持的模型名。换成文档里列出的可用模型或者先用gpt-4o-mini验证链路。报错五AI Assistant 里找不到 Custom Model 选项。版本太旧。升级 IDEA 到 2023.3.2 以上或者直接用 Continue 插件配置方式见第 3 节。报错六流式返回中断。通常是网络抖动或超时设置太短。Continue 的config.json里可以加requestOptions: {timeout: 60000}把超时放宽到 60 秒。6. 后续怎么用把统一 Key 铺到更多入口链路通了之后这套 Key 和地址可以复用到很多地方。比如你在 IDEA 里跑 Claude Code 做长任务编码或者用 Coding Plan 管理多个 Agent 的模型调用都可以指向同一个https://taotoken.net/api/v1。需要新建或轮换 Key 时去控制台操作https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先试试模型对话效果不写代码直接聊https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档里有各语言 SDK 的示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算长期在 IDE 里做编码 AgentCoding Plan 的入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后说个实际经验IDEA 的 AI 插件配置改完后有时候缓存不会立刻刷新表现为改了 Key 但请求还用旧的。这时候别反复改配置直接File → Invalidate Caches → Invalidate and Restart一次就好。另外把config.json和ai-assistant.xml纳入版本控制时记得把 Key 抽成环境变量别把sk-开头的字符串提交到仓库里。
