报错「exceeded the 64000 output token maximum 」怎么解决

Claude Code 帮你写一个大文件、整文件重构、或生成一篇长文档，跑了十几秒，眼看快好了，却突然停下，蹦出这样一段：

大模型说话是按 token 计量的（粗略地说，1 个 token ≈ 0.5～1 个汉字，或几个英文字符）。模型每一次回复能吐多少 token，是有硬性上限的——这个参数在 API 里叫 max_tokens。

Claude Code 出于「防止失控生成、控制成本」的考虑，默认把这个上限设成 64000，并没有直接用满模型的能力。于是：当某一次回复的内容超过 64000 token（写超长文件、一次性重构一大片代码、生成长报告时很容易发生），就会被这道阀门拦下，中断并报出你看到的那行字。

动起来看：64000 这道阀门是怎么被撞上的

它就是把那道阀门调大的旋钮。报错里那句「set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable」，意思就是：去设一个叫这个名字的「环境变量」，把单次回复上限从默认的 64000 提上去。

设成 128000，就把上限提到了 Opus / Sonnet 模型的天花板，单次能写的内容差不多翻一倍：

各模型的输出天花板（设之前先看你用的是哪个）

别被「环境变量」这种词吓到——永久解决从头到尾就一件事：打开你已经有的配置文件，往里加一行，存盘重启。跟着下面三步走完就行，不用挑、不用把别的办法挨个试一遍。

第 1 步：打开配置文件 settings.json

你配置中转时其实已经生成过这个文件，它在用户目录的 .claude 文件夹里。不用一层层翻，直接「跳」过去：

进到文件夹后，用记事本（Windows）或「文本编辑」（Mac，右键它 →「打开方式」）打开里面的 settings.json。

第 2 步：往里加一行（关键，照着抄）

打开后你会看到里面已经有内容——那是你配中转时填的地址和密钥，一个字都别删。通常长这样，里面有一个 env：

改之前 —— 你现在的文件（别清空）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.vibeapi.cn",
    "ANTHROPIC_AUTH_TOKEN": "你的密钥"
  }
}

改之后 —— 只动了 2 个地方（已高亮）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.vibeapi.cn",
    "ANTHROPIC_AUTH_TOKEN": "你的密钥",          ← ① 上一行结尾，补一个英文逗号
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "128000"   ← ② 新增这一整行
  }
}

万一你的文件里通篇没有 env——那基本说明你还没怎么配过，直接看下面「套用完整配置」更省事。

或者：直接套用一份推荐的完整配置（新装 / 想一步到位）

如果你是刚装好、文件基本是空的，或者干脆想把常用设置一次配齐，可以直接用下面这份推荐的完整 settings.json——整份复制、覆盖进去即可。它已经帮你把本文的输出上限、默认模型等都设好了：

{
  "theme": "dark",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-123",
    "ANTHROPIC_BASE_URL": "https://www.vibeapi.cn",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_MODEL": "claude-opus-4-8[1m]",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "ENABLE_TOOL_SEARCH": "true",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "128000"
  },
  "model": "opus[1m]",
  "attribution": {
    "commit": "",
    "pr": ""
  }
}

第 3 步：存盘，彻底重启 Claude Code

保存文件，然后完全退出 Claude Code 再重新打开（它不会热更新，不重启不生效）。重启后再跑刚才的活儿，64000 那个报错就不会再出现了。值记得带引号写成 "128000"。

# macOS / Linux
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=128000
# Windows · PowerShell
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "128000"

settings.json 是 JSON 格式，规矩很死：多一个逗号、用错引号都会让整个文件失效，Claude Code 就当没看见你的设置。记住四条铁律：

• 所有的「名字」和「文字值」都要用英文双引号 "，不能用中文引号「」，也不能用单引号 '。
• 键值对之间用逗号隔开，但最后一项后面不能有逗号。
• JSON 不支持注释（不能写 // 或 #）。
• 大括号 { } 要成对闭合。

{
  "env": {
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "128000"
  }
}

{
  'env': {                ← 用了单引号
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 128000,  ← 末尾多逗号
  } // 设置上限          ← JSON 不能写注释
}

用 Claude Code 还可能撞上这些，对照「一句话怎么修」即可：