迁移清单 · 截至 2026-11-20

Claude 订阅停用后,Claude Code 怎么迁到 API key

截至 2026-11-20,这件事分四步:先在网页应用或 Claude Desktop 的 Settings > Privacy 导出数据(含对话数据与账号用户数据,不含你上传的原始文件),再把 ~/.claude 与项目 CLAUDE.md 备份到仓库外,然后把 ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_BASE_URL 写进 ~/.claude/settings.json 的 env、用 /status 确认凭据,最后按需把 promptCacheTtl 设成 1h——API key 路线的主对话缓存默认只有五分钟,这是迁移后账单变化最大的一处。

更新于 2026-11-20

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#数据导出范围#本地配置不随账号#ANTHROPIC_AUTH_TOKEN#缓存 5 分钟对 1 小时

四个先记住的事实

设置 > 隐私

导出入口:网页端或桌面端,手机端不行

官方写明个人用户(Free、Pro、Max、Ultra)可在网页应用或 Claude Desktop 的 Settings > Privacy 导出,iOS 与 Android 上无法发起导出;Team 与 Enterprise 要组织 Owner 先打开成员导出开关。

~/.claude

本地配置跟着机器走,不跟账号走

~/.claude/settings.json 只影响你这台机器上的所有项目,~/.claude/CLAUDE.md 是你自己的指令文件,项目里的 .claude/settings.json 属于仓库——换凭据不会删除这些文件。

AUTH_TOKEN

网关凭据按 Bearer 头发送

官方认证顺序里 ANTHROPIC_AUTH_TOKEN 排在 ANTHROPIC_API_KEY 之前,写明它按 Authorization: Bearer 头发送,用于经由 LLM 网关或代理接入;挑哪一个变量不确定时,官方建议先用它。

5 分钟

API key 路线的主对话缓存默认五分钟

同一份对话,订阅在计划内用量下请求一小时缓存,换用 API key 或云厂商后主对话默认五分钟;v2.1.242 起可以用 promptCacheTtl 设回 1h。

这一步到底在迁什么

Claude 订阅停用后 Claude Code 怎么迁到 API key,关键是分清三样东西各自在哪。

  1. 1数据在 Anthropic 账号里:导出给你的是对话数据与账号的用户数据,以及你分享给 Anthropic 的语音记录,不含你上传的原始文件。
  2. 2本地配置在你机器或仓库里:~/.claude/settings.json、~/.claude/CLAUDE.md、项目里的 .claude/settings.json 与 CLAUDE.md、.claude/settings.local.json 都是本机文件,账号状态变化不会动它们。
  3. 3凭据在环境变量或设置文件里:官方写明 Claude Code 优先使用环境变量里的 API key,并按 API 的按量费率计费,即使你同时登录着订阅账号。所以迁移的实质不是搬数据,而是换凭据、并确认账单口径从配额制变成按 token 结算。

最近的变化:按量路线从备选变成主选项

截至 2026-11-20,三件事让这条路清楚了。

  1. 1计费口径写明:Anthropic 帮助中心 2026-05-05 更新的文章直接写明 Claude Code 优先使用环境变量 API key、设置后按 API 按量费率计费,即使同时登录订阅账号。
  2. 2缓存可控:官方文档写明 promptCacheTtl 与 CLAUDE_CODE_PROMPT_CACHE_TTL 需要 v2.1.242 或更新版本,取值只有 5m 与 1h。
  3. 3社区诉求换了方向:2026-11-15 至 2026-11-20 的中文讨论里,有用户反映导出的压缩包里只有 users.json、没有对话历史,也有人写道愿意为「一键迁移 Claude Code 配置」付费;这些是社区反映,不是官方说明。

三个时间点:计费口径、社区第二波、核对日

2026-05-05

Anthropic 帮助中心更新《在 Claude Code 中管理 API key 环境变量》:写明 Claude Code 优先使用环境变量 API key、设置后按 API 按量费率计费,即使同时登录订阅或另一个 Console 账号,并建议定期用 /status 确认当前生效的认证方式。

2026-11-18

中文社区出现关于导出内容的讨论帖:有用户写道导出的压缩包里只有 users.json、没有对话历史。这是社区反映;官方导出说明写的是导出包含对话数据与账号用户数据,不含你上传的原始文件,两边对不上时以官方说明和你手上那份导出包为准。

2026-11-20

截至 2026-11-20,官方仍未公布 Claude Code 配置的一键迁移功能,本地配置与导出包之间也没有自动搬运的通道。可做的仍是这三件事——按官方入口导出数据、把本机配置文件备份到仓库外、把那把按量 key 写进 ~/.claude/settings.json 的 env。

官方已核实 vs 社区说法与未公布事项

已核实(Anthropic 帮助中心与 Claude Code 官方文档原文)

截至 2026-11-20 可逐条核对

  1. 1导出范围:官方原文是 Data exports include conversation data and the user data for your account, along with any voice recordings you've shared with Anthropic.——含对话数据、账号用户数据与你分享过的语音记录,不含你上传的原始文件,也还不含已保存的 Personal Finance 面板。
  2. 2导出入口与有效期:网页应用或 Claude Desktop 的 Settings > Privacy,iOS 与 Android 不能发起导出;处理完成后下载链接通过邮件发到账号邮箱,24 小时后过期、可能只能用一次,下载时必须登录账号。
  3. 3导出不能搬账号:官方写明导出数据无法导入另一个个人 Claude 账号,也不支持在个人账号之间迁移数据。
  4. 4被封后的权利:因违反 Usage Policy 被封的 Free、Pro、Max、Ultra 账号仍可登录 claude.ai 导出数据或删除账号,可访问与导出的数据可能视违规类型受限;申诉表必须登录被封账号才能打开。
  5. 5本地文件作用域:~/.claude/settings.json 作用于这台机器上的每个项目,.claude/settings.json 是提交进仓库的共享文件,.claude/settings.local.json 只作用于本项目,~/.claude/CLAUDE.md 是用户级指令,项目级是 ./CLAUDE.md 或 ./.claude/CLAUDE.md。
  6. 6凭据位置与优先级:帮助中心原句是 Claude Code prioritizes environment variable API keys over authenticated subscriptions.——环境变量里的 API key 优先于已登录的订阅;网关凭据写进设置文件的 env 块,官方警告不要把凭据放进项目的 .claude/settings.json。
  7. 7缓存:订阅计划内用量主对话一小时,API key 或云厂商五分钟,promptCacheTtl 设 1h 需要 v2.1.242 或更新版本。

社区说法与官方未公布的事项

以下都不是官方结论。

  1. 1「导出包里只有 users.json、没有对话历史」:2026-11-15 至 2026-11-20 的中文社区里有用户这样反映,但官方导出说明写的是含对话数据与账号用户数据;以官方说明和你那份导出包的实际内容为准。
  2. 2「会有一键迁移 Claude Code 配置的功能」:社区有人写道,若有人做出能保留八成效果的一键迁移,付费也愿意排队;官方未公布任何此类功能或时间表,别等它。
  3. 3「换按量一定更省」:官方没有给出任何跨方案比价结论;按 token 计费下账单取决于你的用量与缓存命中,先跑一天看统计比听结论可靠。
  4. 4导出链接的例外情形:官方只写了 24 小时过期、可能只能用一次、账号数据被删除后无法再发一次;其余情形未公布。
  5. 5选型购物单:社区把 DeepSeek、GPT、Qwen 几家放在同一张单子上比较,这属于个人选型;官方未对跨厂商方案给出任何推荐或比价结论。

继续用订阅登录 vs 换成按量 API key

A:留在订阅里,等账号侧结果

订阅是配额制:计划内用量下主对话请求一小时缓存,用量算在计划额度里,不单独出按 token 的账单。代价是账号被停用期间这条路线上的请求会失败,账号恢复后 Pro 与 Max 的五小时会话限制、各档的每周限制照旧生效;申诉、退款与数据导出都在 Anthropic 官方流程里,个人无法加速。

B:换一把按量 API key,按 token 结算

同一台机器、同一份 CLAUDE.md 与同一套技能,只换凭据:把 ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_BASE_URL 写进 ~/.claude/settings.json 的 env,主对话缓存默认变成五分钟,需要一小时就设 promptCacheTtl 为 1h(v2.1.242 或更新版本)。账单按 token 计费,做多少算多少,没有计划内用量这层保护,长任务前先看一次 /usage 再决定充多少。

照做的六步:导出、备份、换凭据、对账

  1. 1先导出数据:在网页应用或 Claude Desktop 打开 Settings > Privacy,点 Export data;处理完成后邮件会发来下载链接,链接 24 小时后过期且可能只能用一次,收到就下载;Team 与 Enterprise 需要组织 Owner 先打开成员导出开关。
  2. 2备份本地配置:把 ~/.claude/CLAUDE.md、~/.claude/settings.json 与项目里的 CLAUDE.md、.claude/settings.json、.claude/settings.local.json 复制到仓库外的一份目录;技能、MCP 配置与 hooks 都落在这些文件与目录里。
  3. 3旧登录可选退出:如不再使用订阅登录,可执行 /logout 完全退出当前会话;认证优先级里 ANTHROPIC_AUTH_TOKEN 本来就排在订阅登录之前,env 里写了它就会盖过订阅登录。
  4. 4写两个变量:在 ~/.claude/settings.json 的 env 块里写 ANTHROPIC_BASE_URL=https://api.qcode.cc/api 与 ANTHROPIC_AUTH_TOKEN=你的 cr_ key,不要写进项目的 .claude/settings.json,那个文件会随仓库提交。
  5. 5确认凭据:运行 /status,看 Anthropic base URL 一行与 Auth token 一行是否指向你刚写的值,再看 /usage 里的缓存统计。
  6. 6按需调缓存并试跑:promptCacheTtl 设 1h 可以给主对话一小时缓存,先跑一个小任务看 token 用量,再决定充多少额度。

换到 QCode:两个变量,本地配置原样保留

QCode 是独立的 API 接入服务,接入按协议分开。

  1. 1Claude 全系型号(claude-sonnet-5-5、claude-opus-5-5、claude-fable-5-2 等)走 Anthropic Messages 端点:把 ANTHROPIC_BASE_URL 设为 https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN 设为你的 cr_ key,写进 ~/.claude/settings.json 的 env 即可;本地的 CLAUDE.md、技能、MCP 与 hooks 原样保留,不用重建。
  2. 2同一把 cr_ key 在 Claude Code 里调 Claude 型号,在 Codex CLI 里调 gpt-6.2-sol、gpt-6.1-sol 等 GPT 型号:后者把 base_url 改成 https://api.qcode.cc/openai、wire_api 设为 responses,两条是不同端点,各按各的协议发请求。
  3. 3OpenAI 兼容客户端(OpenCode 等)填 https://api.qcode.cc/openai/v1。按 token 计费,各模型单价见 /models。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。要说清楚:QCode 不影响也不能解除 Anthropic 对你 claude.ai 账号的处置,申诉、退款与数据导出仍走 Anthropic 官方流程。

常见问题

导出包里到底有什么,对话历史在里面吗?

按官方说明,对话历史在里面:导出包含对话数据、账号的用户数据,以及你分享给 Anthropic 的语音记录;不含你上传的原始文件,也还不含已保存的 Personal Finance 面板。社区在 2026-11-18 与 2026-11-20 有用户反映压缩包里只有 users.json,遇到这种情况先按同一入口重导一次并核对压缩包内文件清单,仍对不上就走官方支持渠道。

CLAUDE.md、技能和 MCP 配置会丢吗?

不会,这些都不是账号里的数据。~/.claude/CLAUDE.md 是用户级指令文件,项目级是 ./CLAUDE.md 或 ./.claude/CLAUDE.md 并由版本控制带给团队,.claude/settings.local.json 是你本项目的本地覆盖;技能、MCP 与 hooks 的配置同样落在这些文件与目录里。账号状态或凭据变化改的是 Claude Code 用哪把 key 发请求,不会删除本机文件;唯一要自己做的是把 ~/.claude/ 与项目的 .claude/ 复制到仓库外备份一份。

换用 API key 会影响我的申诉结果吗?

申诉要登录被封账号才能打开并提交表单,导出数据与自助删号也在登录后的同一屏;帮助中心没有写使用其他 API key 会影响申诉。申诉结果以 Anthropic 的审核为准,退款与导出全部走官方流程。QCode 不影响也不能解除 Anthropic 对 claude.ai 账号的处置。

按量会不会比订阅贵?

没有统一答案,取决于 token 用量与缓存命中这两件事。同一份对话,订阅在计划内用量下请求一小时缓存,换用 API key 后主对话默认只有五分钟——闲置超过五分钟再回来,下一轮要重新计算整段前缀,这是账单最容易变高的一处。把 promptCacheTtl 设成 1h(需要 v2.1.242 或更新版本)能让主对话缓存回到一小时,但一小时档的缓存写入价格高于五分钟档,连续短任务反而更贵;稳妥做法是先按默认跑一天,看 /usage 的缓存统计再决定。

团队一起迁要注意什么?

分两层:能提交的放项目 .claude/settings.json,凭据放个人文件。官方警告不要把凭据写进项目的 .claude/settings.json,因为那个文件会提交并被所有克隆仓库的人看到;团队共享的权限、hooks、插件与环境变量放这一份,个人的凭据写在自己机器上的 ~/.claude/settings.json 的 env 块,或写进只对本项目生效的 .claude/settings.local.json。导出侧则要组织 Owner 先打开成员导出开关,成员才能各自导出自己的对话。

Codex 和 OpenCode 能用同一把 key 吗?

能,但要换端点,不是换 key。同一把 cr_ key 在 Claude Code 里配 ANTHROPIC_BASE_URL=https://api.qcode.cc/api;在 Codex CLI 的 ~/.codex/config.toml 里配 base_url = "https://api.qcode.cc/openai" 与 wire_api = "responses",不要加 /v1 尾缀;OpenAI 兼容的客户端(OpenCode 等)填 https://api.qcode.cc/openai/v1。两条端点分开用:Claude Code 这条(https://api.qcode.cc/api)调 Claude 型号,Codex CLI 这条(https://api.qcode.cc/openai)调 gpt-6.2-sol、gpt-6.1-sol 等 GPT 型号,各自按各自的协议发请求;单价看 /models。

参考来源

Anthropic 帮助中心:导出 Claude 数据的说明(support.claude.com 文章 9450526,核对于 2026-11-20)、封禁与申诉说明(文章 8241253,核对于 2026-11-20)、在 Claude Code 中管理 API key 环境变量(2026-05-05)、在 Claude Code 中使用 Pro、Max 或 Ultra 套餐(核对于 2026-11-20);Claude Code 官方文档:设置文件与作用域、记忆文件、认证、LLM 网关接入、提示词缓存(均核对于 2026-11-20);社区说法仅来自公开讨论帖(2026-11-15 至 2026-11-20),正文已逐处标注为社区反映。以上各来源的核对日均为 2026-11-20。

先把数据导出、本地配置备份好,再换一把按量 key

注册 QCode 账号生成 cr_ key,把 ANTHROPIC_BASE_URL=https://api.qcode.cc/api 与 ANTHROPIC_AUTH_TOKEN 写进 ~/.claude/settings.json 的 env,按 token 计费调用多模型;只想要一次性额度,也可以先买一笔按量包,单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79