1. 国内 IDEA 里让 Claude Code 跑起 deepSeek agent 的真实路径如果你在国内用 IntelliJ IDEA想通过 Claude Code 插件调用 deepSeek 模型来跑 agent大概率会卡在三个地方插件装完发现连不上、命令行 claude 提示要登录、settings 文件里 Base URL 和 Key 不知道往哪填。这篇就把这条链路一次讲透从 IDEA 版本要求、插件安装、TaoToken 统一 Key 配置到最小 agent 调用验证全部给可复制的片段。先说清楚这套组合是什么IntelliJ IDEA 是 JetBrains 的 Java/Kotlin 主力 IDEClaude Code 是 Anthropic 推出的命令行 agent 工具deepSeek 是国内可直连的大模型服务。把三者串起来之后你可以在 IDEA 的终端里直接让 agent 读代码、改文件、跑命令而模型走的是 deepSeek 的通道成本和延迟都比默认方案友好很多。适合谁适合已经用 IDEA 写代码、想尝鲜 agent 工作流、又不想折腾网络环境的开发者。我试过在 2024.1 上装 Claude Code 插件结果插件市场能搜到但激活后终端里 claude 命令根本起不来后来换成 2025.x 之后的版本才顺。所以第一步不是装插件而是先确认你的 IDEA 版本够新。JetBrains 从 2025 开始把社区版和旗舰版合并下载一个 exe 装上就行不用再纠结破解。版本太老的话插件依赖的终端 API 对不上后面所有配置都是白费。整条链路的核心其实是「统一 Key 统一 Base URL」。Claude Code 默认只认 Anthropic 官方端点国内直连不通所以要用一个兼容 Anthropic 协议的中转层把请求转发到 deepSeek。TaoToken 在这里扮演的就是这个统一入口一个 Key 同时管模型对话、coding plan、API Keys 管理Base URL 固定模型 ID 可切换。你不需要为每个模型单独配一套环境变量改一个 settings 文件就能换模型。下面按顺序走先讲前置准备IDEA 版本、Node、插件再给可复制的配置片段然后是一次最小 agent 调用验证最后把常见报错对照着排一遍。每一步都有命令和结果说明照着做就行。2. TaoToken 前置准备Key、Base URL 与 IDEA 插件安装在动 settings 文件之前先把三样东西备齐TaoToken 的 API Key、Base URL、以及 IDEA 里的 Claude Code 插件。这三样缺一个后面验证都会失败。先拿 Key。打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台里找到 API Keys 页面新建一个 Key。这个 Key 是后面所有配置里唯一要填的凭证模型对话、coding plan、agent 调用都用它。拿到之后先复制到记事本页面刷新后就看不全了。Base URL 是固定的写https://taotoken.net/api注意这个地址不带任何查询参数直接原样填。很多人在这里犯错把官网首页地址填进去结果请求打到网页而不是 API 网关报 404 或者返回 HTML。记住官网是给人看的API 是给程序调的两个地址不一样。然后是 IDEA 插件。打开 IntelliJ IDEA进 Settings → Plugins → Marketplace搜索 “Claude Code”安装后重启 IDE。装完你会发现插件面板里点连接没反应这是正常的因为插件本身只是个壳真正的 agent 逻辑在命令行 claude 里。所以还要在系统里装 Claude Code CLI。CLI 依赖 Node.js 18 以上和 npm。在 PowerShell 里执行node -v npm -v两个命令都能输出版本号就说明环境 OK。如果 node 版本低于 18去 Node 官网下 LTS 版重装。然后全局安装 Claude Codenpm install -g anthropic-ai/claude-code claude --versionclaude --version能打印出版本号说明 CLI 装好了。这时候直接运行claude会提示登录或者连接失败因为默认端点在国内不通先别管继续往下配。关于模型 IDdeepSeek 在 TaoToken 上的模型标识建议用deepseek-v4-pro默认可能是deepseek-v3.2两者在 agent 场景下的工具调用稳定性有差异v4-pro 对多轮 function call 的支持更完整。这个 ID 后面要写进 settings 文件。如果你还想在 IDEA 里用图形化的模型对话做对比测试可以开 TaoToken 的模型对话页面同一个 Key 直接选模型发消息用来确认 Key 本身是有效的。这一步能帮你把「Key 问题」和「配置问题」分开排查。3. 可复制配置settings.json 与 CC Switch 三件套配置分两层一层是 Claude Code CLI 的 settings 文件一层是 CC Switch 这类切换工具。两者配合才能让 CLI 在启动时读到正确的 Base URL、Key 和模型 ID。先找 settings 文件位置。Windows 下默认在用户目录的.claude文件夹里C:\Users\你的用户名\.claude\settings.json如果这个文件不存在说明 CLI 还没初始化过配置先运行一次claude让它生成目录结构或者手动创建。文件内容按下面这个结构写{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: deepseek-v4-pro }, includeCoAuthoredBy: true }三个字段对应三件套Base URL 填 TaoToken 的 API 地址API Key 填你刚建的 KeyModel ID 填deepseek-v4-pro。includeCoAuthoredBy这个字段控制提交信息里是否带 co-authored 标记按自己习惯设 true 或 false 都行不影响连通性。如果你用 CC Switch 来管理多套配置它的作用是帮你切换不同的 Key 和模型避免手动改 settings。安装后在界面里新增一个配置项把上面三个值填进去保存。CC Switch 保存后会回写到.claude目录下的配置文件所以你要确认它写入的路径和你 CLI 读取的路径是同一个。常见坑是 CC Switch 装在了E:\Users\...\CC Switch\但 CLI 读的是C:\Users\...\.claude\两边对不上改了没生效。用 TOML 格式的场景一般是 Codex 的auth.json或类似工具的配置Claude Code 这边以 JSON 为主。如果你同时用 Codex它的auth.json里也要填同样的 Base URL 和 Key模型 ID 保持一致这样两个工具走同一个通道排查问题时变量更少。配置写完保存重启 IDEA 和终端。重启这一步别省CLI 启动时才读 settings热改不生效。重启后在 PowerShell 里执行claude --version echo $env:ANTHROPIC_BASE_URL第二条命令如果打印出https://taotoken.net/api说明环境变量已经注入成功。如果为空检查 settings 文件的 JSON 格式有没有语法错误比如多了逗号或者引号不配对JSON 解析失败会静默忽略整个 env 块。4. 最小 agent 调用验证一次请求确认通道与模型响应配置好之后别急着在 IDEA 里跑大任务先用一个最小 agent 调用确认通道通、模型响应正常。这一步能把问题范围缩到最小。打开 PowerShellcd 到一个空的测试目录运行mkdir claude-test cd claude-test claude进入交互界面后输入一句最简单的指令比如创建一个 hello.txt 文件内容写 hello deepseek agent如果通道正常你会看到 agent 先输出思考过程然后调用文件写入工具最后提示创建成功。退出后用dir或ls检查hello.txt 应该存在且内容正确。这一步验证了三件事Base URL 可达、Key 有效、模型支持工具调用。再验证一次纯对话响应确认模型 ID 生效你是什么模型正常返回里会提到 deepSeek 相关标识。如果返回的是 Anthropic 默认模型名说明ANTHROPIC_MODEL没生效回去检查 settings 里的字段名有没有拼错。在 IDEA 里验证的方式类似打开底部 Terminalcd 到你的项目目录运行claude然后让它读一个文件读一下 pom.xml告诉我用了哪些依赖agent 会调用读取工具把文件内容喂给模型再返回总结。这一步成功说明 IDEA 终端环境和系统终端环境一致插件壳和 CLI 已经打通。验证通过后你可以开始跑真实任务比如让它重构一个类、补单元测试、解释一段遗留代码。agent 模式下它会自己决定读哪些文件、改哪些行你只需要在关键改动前确认。deepSeek 在代码理解上的表现对 Java/Kotlin 项目够用长上下文场景下响应也稳定。如果验证失败先别改配置按下一节的报错对照表逐条排。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节把国内接 Claude Code deepSeek 最常撞的四个报错列出来对照着改。401 UnauthorizedKey 无效或者没带上。检查 settings 里ANTHROPIC_API_KEY的值有没有多余空格Key 是否已过期或被删。TaoToken 控制台里重新生成一个 Key 换上重启终端再试。如果 Key 是对的还报 401确认 Base URL 是不是写成了官网首页而不是https://taotoken.net/api。local proxy failed / connection refusedCLI 尝试连本地代理但没起来。这通常是因为环境里残留了旧的代理配置比如HTTP_PROXY或HTTPS_PROXY指向了一个不存在的端口。在 PowerShell 里执行echo $env:HTTP_PROXY检查如果有值且不是你需要的清掉Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue然后重启终端。TaoToken 的 API 是直连的不需要额外代理层。Error reading choices / unexpected response format请求发出去了但返回的 JSON 结构不是 CLI 预期的。常见原因是 Base URL 指向了一个不兼容 Anthropic 协议的端点或者模型 ID 写错导致网关返回了错误格式。确认 Base URL 是https://taotoken.net/api模型 ID 是deepseek-v4-pro。如果还报用模型对话页面单独测一下同一个 Key 和模型能返回正常内容说明 Key 和模型没问题问题在 CLI 配置。OAuth / login requiredCLI 提示要登录 Anthropic 账号。这是因为 settings 里的 env 没被读到CLI 回退到了默认的登录流程。检查.claude/settings.json路径是否正确JSON 是否合法。可以用Get-Content $env:USERPROFILE\.claude\settings.json | ConvertFrom-Json验证格式报错就说明 JSON 有问题。另外确认你运行claude时的工作目录不会覆盖全局 settings有些项目级配置会优先于用户级配置。排查顺序建议先确认 Key 有效用模型对话页面测再确认 Base URL 正确再确认 settings 路径和格式最后确认环境变量没被覆盖。四步走完基本都能定位。6. 把通道固定下来长期用 agent 的几个实用习惯验证通过只是开始长期用这套组合跑 agent有几个习惯能帮你少踩坑。第一Key 和 Base URL 只维护一份。不要在 IDEA 插件、CLI settings、CC Switch 里各填一遍不同的值改的时候漏改一个就出问题。统一以.claude/settings.json为准其他工具从它读或者写回它。第二模型 ID 跟着任务走。日常补全和解释用默认模型就够复杂重构和长链路 agent 任务切到deepseek-v4-pro。切换只改 settings 里一个字段重启终端生效。如果你经常切用 CC Switch 存两套配置一键切换比手改快。第三agent 任务从小往大做。先让它读文件、写单文件再让它改多文件、跑测试。每次改动前用 git 提交一次agent 改完你 diff 一下确认没问题再继续。这样即使模型判断失误回滚成本也低。第四终端环境保持干净。代理变量、旧版本 Node、冲突的全局 npm 包都会干扰 CLI 启动。定期npm update -g anthropic-ai/claude-code保持 CLI 最新新版本对协议兼容性和错误提示都有改进。如果你想把 agent 能力用在更长的编码任务上比如让它连续处理多个模块、自动跑测试循环可以了解 TaoToken 的 Coding Plan它针对长时间 agent 会话做了通道优化Key 和 Base URL 跟现在这套完全一致不用重新配。需要看接口细节的话接入文档里有完整的端点说明和示例请求API Keys 页面管理你的凭证。模型对话页面适合做单次验证和对比测试三个入口配合着用排查和日常开发都够。最后留一个我自己的习惯每次换机器或者重装系统先把.claude/settings.json备份一份新环境装完 CLI 直接覆盖回去省得重新配三件套。这个文件不大但能省你半小时排查时间。