【全网唯一教程】如何将Poe接入Claude Code？看完此篇你就知道原来如此简单！

1. 为什么要把 Poe 接进 Claude CodePoe 这个平台很多人第一次接触是因为它把 ChatGPT、Claude、Gemini 这些模型聚在一个订阅里一个月能换着用。但用久了会发现一个问题网页端聊天适合问零散问题真正写代码、改项目、跑 Agent 的时候还是得在终端里有个能读文件、能执行命令的助手。Claude Code 正好补上这块它是 Anthropic 官方出的命令行编码工具能直接在你的项目目录里读写文件、跑测试、做重构。那能不能让 Claude Code 走 Poe 的通道可以。Poe 提供了兼容 Anthropic 接口格式的 API只要把 Claude Code 的请求地址和密钥指过去它就能把 Poe 当成后端模型来用。整条链路的核心是三样东西Node.js 环境、Anthropic SDK、以及一个负责切换配置的 CC Switch。我实测下来这套组合对新手最友好因为不用手动改一堆环境变量配置写进 settings.json 就能生效。这篇面向的是刚上手大模型、手里有 Poe 订阅、想在终端里用 Claude Code 写代码的人。你会看到完整的安装命令、可复制的 settings.json 骨架、CC Switch 的配置片段以及一次真实请求的验证过程。跟着做大概十分钟能跑通。需要提前说清楚一点Poe 的 API 走的是它自己的网关和 Anthropic 官方直连不是一回事。所以配置里最关键的是 base_url 要指向 Poe 的接口地址而不是默认的 api.anthropic.com。这个点搞错后面会一直报 401 或连接超时。2. 前置准备Node.js、Claude Code 与 Anthropic SDK2.1 装 Node.jsClaude Code 是 npm 包所以第一步得有 Node.js。去 nodejs.org 下载 LTS 版本Windows 选 .msimacOS 选 .pkg一路下一步就行。装完打开终端验证node -v npm -v两条命令都能打印版本号说明环境没问题。如果提示 command not found多半是安装时没勾选加入 PATH重装一次注意勾上。2.2 全局安装 Claude Codenpm install -g anthropic-ai/claude-code装完输入claude能进交互界面就对了。第一次进会提示你登录或配置密钥先别急着登录官方账号因为我们后面要用 Poe 的密钥覆盖掉。2.3 安装 Anthropic SDK这一步很多人会跳过觉得 Claude Code 自己会处理。但实际配置 Poe 的时候SDK 负责把请求按 Anthropic 的格式发出去缺了它容易出兼容问题。两条命令都跑一下npm install anthropic-ai/sdk pip install anthropicnpm 那条是给 Node 环境用的pip 那条是给 Python 脚本调试用的。如果你只用 Claude Codenpm 那条是必须的pip 可选但建议装上后面写验证脚本会用到。2.4 拿到 Poe 的 API Key登录 Poe 网页版进设置里的 API 页面生成一个 key。这个 key 通常以sk-开头复制下来存好。注意 Poe 的 API 是按点数计费的和订阅额度是两套体系用之前确认账户里有余额。3. 用 CC Switch 管理配置避免手改环境变量3.1 为什么用 CC Switch如果你只用 Poe 一个后端其实手动写 settings.json 也行。但现实是很多人同时有 GLM、Qwen、DeepSeek 的 key甚至还有官方 Anthropic 的。每换一个模型就改一次配置文件很容易改乱。CC Switch 是个开源的小工具专门管这类多后端切换点一下就能换配置互不干扰。下载地址在 GitHub 上搜 cc-switch 就能找到作者是 farion1231。Windows 下是个 exemacOS 是 dmg装完打开是个简洁的界面。3.2 添加 Poe 配置打开 CC Switch点右上角的加号填这几项字段填写内容名称Poe-Claude随便起自己认得就行Base URLPoe 的 Anthropic 兼容接口地址API Key你刚才生成的 Poe key模型claude-sonnet-4-5 或 Poe 支持的 Claude 模型名Base URL 这块要特别注意Poe 的接口路径和官方不一样填错会直接 404。具体地址以 Poe 官方 API 文档为准别照抄网上的旧教程。填完点保存然后点启用。CC Switch 会自动把配置写进 Claude Code 读取的位置你不用手动碰环境变量。3.3 settings.json 配置骨架如果你想手动管理或者想搞清楚 CC Switch 到底改了什么可以看这个骨架。Claude Code 的配置文件在用户目录下的.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://api.poe.com/anthropic, ANTHROPIC_API_KEY: sk-你的Poe密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 } }三个字段的含义BASE_URL 决定请求发到哪API_KEY 是身份凭证MODEL 指定默认用哪个模型。CC Switch 做的事就是帮你切换这三行的值省得每次手改。注意settings.json 里的 key 是明文存储的别把这个文件提交到 Git 仓库。建议在项目根目录的 .gitignore 里加上.claude/。4. 验证接入是否生效4.1 用 /status 和 /model 快速检查进 Claude Code 界面后输入/status它会打印当前的后端地址、模型名、认证状态。如果 BASE_URL 显示的是 Poe 的地址说明配置读到了。再输入/model确认当前模型是你在 CC Switch 里选的那个。如果这里显示的还是官方默认模型说明配置没生效回去检查 CC Switch 有没有点启用。4.2 发一次真实请求光看状态不够得实际发个请求。在 Claude Code 里输入一句让它读文件的话比如帮我看一下当前目录下有哪些文件并总结 package.json 里的依赖如果它正确列出了文件、读出了依赖说明整条链路通了。请求从 Claude Code 发出经过 Anthropic SDK 格式化打到 Poe 的接口Poe 转发给 Claude 模型结果再原路返回。4.3 用 Node.js 脚本单独验证想更确定一点可以写个小脚本直接调 SDKimport Anthropic from anthropic-ai/sdk; const client new Anthropic({ baseURL: https://api.poe.com/anthropic, apiKey: process.env.ANTHROPIC_API_KEY, }); const msg await client.messages.create({ model: claude-sonnet-4-5, max_tokens: 256, messages: [{ role: user, content: 用一句话说明你是什么模型 }], }); console.log(msg.content[0].text);跑之前先把 key 设进环境变量export ANTHROPIC_API_KEYsk-你的Poe密钥 node test.js能打印出模型回复就说明 Poe 的接口和 SDK 完全兼容Claude Code 那边也不会有问题。5. 常见报错与排查5.1 401 Unauthorized最常见的原因就三个key 复制时带了空格、key 已经失效、或者 BASE_URL 填成了官方地址导致 key 对不上。先检查 key 前后有没有多余字符再去 Poe 后台确认 key 还在有效期内。如果都没问题把 BASE_URL 换成 Poe 文档里给的最新地址再试。5.2 404 Not Found基本可以断定是 BASE_URL 路径写错了。Poe 的接口路径和 Anthropic 官方不同不能直接套https://api.anthropic.com。去 Poe 的 API 文档页复制准确的 base URL注意结尾有没有斜杠、路径里有没有/v1这类前缀。5.3 模型名不识别Poe 支持的模型名和 Anthropic 官方不完全一致。如果你填了claude-3-5-sonnet-20241022这种带日期的完整名Poe 可能不认。换成 Poe 文档里列出的简写名比如claude-sonnet-4-5。CC Switch 里改完记得重新启用一次。5.4 CC Switch 改了但 Claude Code 没反应这种情况通常是 Claude Code 已经在运行配置是启动时读的。退出 Claude Code 再重新进一次。如果还不行检查 CC Switch 写入的路径和 Claude Code 实际读取的路径是不是同一个有些版本会读项目级的.claude/settings.json而不是用户级的。5.5 请求超时Poe 的网关在境外网络波动会导致超时。先确认本地网络能正常访问 Poe 网页版如果网页都打不开那 API 肯定也不通。另外把 max_tokens 调小一点测试大请求更容易超时。6. 多模型切换与长期使用建议跑通 Poe 之后你可能会想再挂几个国内模型做对比。CC Switch 的价值这时候就体现出来了GLM 一个配置、Qwen 一个配置、DeepSeek 一个配置点一下切换Claude Code 重启后就是新后端。不用改代码不用动环境变量。如果你长期在终端里做编码和 Agent 任务建议把常用的几个后端都配好按任务类型分写复杂重构用 Claude跑批量脚本用便宜的快模型做中文理解用国内模型。切换成本几乎为零。密钥管理上别把 key 硬编码在脚本里。用环境变量或者系统的密钥管理工具settings.json 里只放引用。CC Switch 本身也是明文存 key 的所以那个配置文件别同步到云盘或公开仓库。最后提一句Poe 的 API 计费和订阅是分开的用之前确认余额。如果只是偶尔用按量付费比订阅划算如果天天跑 Agent再考虑包月。这套配置搭好之后Claude Code 就能稳定走 Poe 的通道终端里的编码体验和官方直连基本没差别。