1. vim/tmux 里突然冒出 E349 到底卡在哪
如果你在 tmux 里开 vim，切个分屏、跳个窗口，底部突然蹦出一行E349: No identifier Under Cursor，然后光标卡住、补全弹不出来、:wq都像被冻住——这不是你键盘坏了，也不是 vim 装错了。这个报错的意思是：vim 在光标位置想读一个「标识符」（变量名、函数名、tag 名），但当前 buffer 里那个位置什么都没有，或者它依赖的补全/索引通道没把数据送回来。
我最早遇到它是在一个远程开发机上：本地 tmux 分三个 pane，一个跑 vim 写 Python，一个跑日志，一个跑测试。只要我在 vim 里用Ctrl-w切到别的 pane 再切回来，补全就报 E349。当时以为是 vim 插件冲突，把 coc、YouCompleteMe 卸了重装，没用。后来才想明白，E349 本身是 vim 的「症状」，不是「病因」。真正的问题分两层：一层是终端复用器（tmux）和 vim 的终端能力协商没对齐，另一层是补全/索引后端（比如 LSP、tagbar、coc.nvim）在切屏后拿不到正确的上下文，甚至请求根本没发出去。
这篇文章适合三类人：一是在 tmux/screen 里长期用 vim 的终端党；二是用 Cursor、VS Code Remote 但底层还是走终端补全的开发者；三是把模型补全接进编辑器、结果 endpoint 配错导致「看起来像 vim 报错」的人。核心检索词就一个：E349: No identifier Under Cursor 排查。我会从 vim/tmux 环境一路查到 Cursor Base URL 和本地代理失败，最后给一条 curl 验证请求链路，帮你判断到底是编辑器索引问题，还是鉴权通道问题。
先说结论方向，省得你乱试：如果 E349 只在 tmux 切屏后出现、单独开 vim 不报，八成是终端能力或补全后端上下文丢失；如果 E349 伴随local proxy failed、401、reading choices这类字样，那基本是请求链路断了，跟 vim 本身没关系。下面按这个顺序拆。
2. 先分清是 vim 索引问题还是鉴权通道问题
排查 E349 最忌讳一上来就改配置。你得先做一次「二分」：把 tmux 因素和补全后端因素分开。
第一步，脱离 tmux 验证。直接开一个干净终端，vim -u NONE启动，不加载任何插件，然后手动触发一次补全（插入模式按Ctrl-n或Ctrl-x Ctrl-o）。如果这时候不报 E349，说明 vim 本体和终端没问题，问题在 tmux 或插件。如果裸 vim 也报，那可能是 vim 版本或completeopt设置的问题，先:set completeopt?看一眼。
第二步，在 tmux 里复现。tmux -2 new -s a起一个 256 色会话，在里面开同样的 vim，切屏Ctrl-b o或Ctrl-b ;，再触发补全。如果这时报 E349，基本锁定 tmux 的终端类型协商。常见原因是 tmux 把TERM设成了screen或screen-256color，而 vim 的补全插件依赖termcap里的某些能力（比如t_Co、Tc、RGB），协商失败后插件拿不到光标位置，就报「光标下没有标识符」。
第三步，看补全后端。如果你用的是 coc.nvim、nvim-cmp、YouCompleteMe 这类，它们背后要么是本地 LSP，要么是远程模型补全。E349 有时是后端返回了空结果，vim 把它翻译成了「没有标识符」。这时候你要看的是后端的日志，而不是 vim 的报错。比如 coc 的日志在:CocCommand workspace.showOutput，里面如果出现request failed、timeout、401，那就跟 vim 无关了。
这里有个关键判断点：E349 出现时，你的补全请求到底发出去了没有。如果后端日志里根本没有这次请求，说明请求在编辑器侧就被拦了（索引没建好、文件没保存、buffer 没 attach）；如果日志里有请求但返回错误，那就是鉴权或 endpoint 问题。这一步分清楚，后面才不会白折腾。
我自己的经验是，tmux 环境下 E349 有相当一部分是「假报错」：补全后端其实正常，只是 vim 在切屏瞬间光标位置没同步，插件读到了一个空 token。这种情况你按Esc再进插入模式往往就好了。但如果每次切屏都报、且后端日志有 401，那就是真问题，得去查 Key 和 Base URL。
3. 可复制配置：settings 片段与 auth.json 字段对照
到了这一步，假设你已经确认是「鉴权通道」问题——也就是补全后端请求发出去了，但被拒。这时候要动的是两处配置：编辑器的 settings（Cursor / VS Code 系）和 CLI 工具的 auth.json（Codex 系）。两者字段名不一样，但本质是同一件事：Base URL + Key + Model ID。
先看 Cursor / VS Code 的 settings.json。如果你把模型补全的 endpoint 指向统一网关，配置大概长这样（路径按你实际安装位置，macOS 是~/Library/Application Support/Cursor/User/settings.json，Linux 是~/.config/Cursor/User/settings.json）：
{ "openai.baseUrl": "https://taotoken.net/api", "openai.apiKey": "sk-你的统一Key", "openai.model": "claude-sonnet-4-20250514", "editor.inlineSuggest.enabled": true, "cursor.cpp.enablePartialAccepts": true }注意openai.baseUrl这里填的是https://taotoken.net/api，不要带多余的/v1后缀，也不要带 UTM 参数——UTM 是给网页链接用的，API 调用带上反而可能被网关当成非法路径。Key 从控制台的 API Keys 页面拿，模型 ID 要跟你实际开通的模型对上，写错了会返回model not found，在 vim 里表现就是补全一直空、偶尔 E349。
再看 Codex 系的auth.json。这个文件通常在~/.codex/auth.json，字段对照如下：
{ "OPENAI_API_KEY": "sk-你的统一Key", "OPENAI_BASE_URL": "https://taotoken.net/api", "OPENAI_MODEL": "claude-sonnet-4-20250514" }三件套必须齐全：Base URL、Key、Model ID。少任何一个，请求都会在网关侧被拒。我见过有人只改了 Key 没改 Base URL，结果请求还是打到默认地址，报 401；也见过 Base URL 末尾多了斜杠，网关匹配不到路由，返回 404，编辑器翻译成「补全失败」，vim 里就是 E349。
如果你用的是 Claude Code 这类 CLI，配置思路一样，只是入口不同。可以在项目里放一个.claude/settings.json，或者用环境变量：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-你的统一Key" export ANTHROPIC_MODEL="claude-sonnet-4-20250514"这里要提醒一句：环境变量和配置文件同时存在时，优先级可能不一样，改完记得source一下或者重开终端。tmux 里的 pane 是独立 shell，你在外面改了环境变量，已经开着的 pane 不会自动继承，得tmux kill-server重来，或者在新 pane 里重新 export。这一点很容易被忽略，导致「我明明改了怎么还报错」。
配置改完，别急着回 vim 试。先在终端里用 curl 验证链路，见下一节。
4. 一条 curl 验证请求链路是否恢复
配置对不对，curl 说了算。在 tmux 的任意 pane 里执行下面这条（把 Key 和模型换成你自己的）：
curl -sS -X POST "https://taotoken.net/api/v1/messages" \ -H "Content-Type: application/json" \ -H "x-api-key: sk-你的统一Key" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [ {"role": "user", "content": "只回复两个字：通了"} ] }'如果你用的是 OpenAI 兼容格式，换成：
curl -sS -X POST "https://taotoken.net/api/v1/chat/completions" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的统一Key" \ -d '{ "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "只回复两个字：通了"}], "max_tokens": 64 }'成功的话，你会看到一段 JSON，里面有content或choices字段，内容是「通了」。这时候再回 vim 触发补全，E349 应该消失。如果 curl 返回 401，说明 Key 不对或没带上；返回 404，说明 Base URL 路径写错（多写或少写/v1）；返回model not found，说明模型 ID 跟开通的不一致；如果卡住不动最后超时，那可能是本地网络到网关的链路问题，跟 vim 无关。
这里有个细节：reading choices这个报错，通常出现在 OpenAI 兼容格式的响应解析里。如果你 curl 返回的 JSON 结构跟编辑器预期的不一样（比如网关返回的是 Anthropic 格式，但编辑器按 OpenAI 格式解析），就会报reading choices，然后在 vim 里表现为 E349。解决办法是确认你的编辑器/插件用的是哪种协议，然后选对应的 endpoint。Anthropic 格式走/v1/messages，OpenAI 格式走/v1/chat/completions，别混。
验证通过后，回到 tmux 里的 vim，建议先:e!重载文件，再触发补全。如果还报 E349，但 curl 是通的，那问题就回到 vim/tmux 侧了，去看第 5 节的排查表。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
把 E349 相关的报错归归类，对照着查最快。
401 Unauthorized：Key 没带、带错、或者带了但格式不对。检查x-api-key或Authorization: Bearer有没有写全，Key 有没有多余空格。tmux 里如果用了环境变量，echo $ANTHROPIC_API_KEY看一眼是不是空的。还有一种情况是 Key 过期或被禁用，去控制台重新生成一个。
local proxy failed：这个报错说明你的请求先发到了本地代理（比如某些插件自带的 proxy、或者系统代理），代理再转发到网关，但代理这一跳失败了。排查顺序：先确认本地代理进程还在不在，再看代理配置里的上游地址是不是https://taotoken.net/api。如果代理配置里写的是别的地址，改过来。另外，tmux 环境下的 shell 可能没继承系统的代理环境变量，env | grep -i proxy查一下，有的话unset掉再试，避免请求被错误地导到本地代理。
reading choices：前面说过，这是响应格式解析失败。常见于 OpenAI 兼容客户端收到了非 OpenAI 格式的响应。确认 endpoint 和协议匹配，或者检查网关返回的 JSON 里有没有choices字段。如果用的是 Anthropic 格式的客户端，就别指望它读choices。
OAuth 相关报错：有些 CLI 工具（比如 Codex 系）默认走 OAuth 登录，而不是 API Key。如果你已经配了 Key，但工具还在尝试 OAuth，就会报鉴权失败。这时候要显式指定用 API Key 模式，或者在auth.json里把 OAuth 相关字段清掉，只留OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL三件套。Claude Code 类似，确认它读的是ANTHROPIC_API_KEY而不是登录态。
再补一个 tmux 特有的坑：TERM变量。在 tmux 里执行echo $TERM，如果是screen而不是screen-256color或tmux-256color，某些补全插件的终端能力检测会失败，间接导致 E349。可以在~/.tmux.conf里加一行set -g default-terminal "tmux-256color"，然后tmux kill-server重启。这个改动对 vim 的补全稳定性有实际帮助，尤其是用真彩色主题的时候。
排查顺序建议：先 curl 验证链路 → 再看编辑器/CLI 配置三件套 → 再看 tmux 的 TERM 和代理环境变量 → 最后才怀疑 vim 插件。按这个顺序，大部分 E349 十分钟内能定位。
6. 把 endpoint 固定下来，别再让 E349 反复出现
E349 最烦的地方不是它难修，而是它反复出现。今天修好了，明天换个项目、换个终端、换个 tmux 会话，又冒出来。根因往往是配置散落在多处：编辑器 settings 一份、CLI 的 auth.json 一份、shell 环境变量一份，改了一处忘了另一处。
我的做法是把 endpoint 和 Key 收敛到统一入口，所有工具都指向同一个 Base URL 和同一套 Key。这样排查时只需要验证一个链路，不用挨个猜。统一 Key 的好处是：curl 通了，基本就代表所有走这个网关的工具都通；curl 不通，问题一定在网关侧或网络侧，跟 vim、tmux 无关。
具体操作上，编辑器侧改 settings.json 的openai.baseUrl，CLI 侧改auth.json的OPENAI_BASE_URL，环境变量侧 exportANTHROPIC_BASE_URL，三处都指向https://taotoken.net/api。Key 从控制台的 API Keys 页面统一生成，模型 ID 按实际开通的填。改完用第 4 节的 curl 验一遍，通了再回 vim。
如果你长期在终端里写代码、跑 Agent，可以考虑把常用模型和 Key 固化到 Coding Plan 里，省得每次新项目都重新配。模型对话页面可以用来快速验证某个模型 ID 是否可用，接入文档里有各客户端的详细字段说明，遇到字段对不上的时候翻一下比瞎试快。
最后留一个实用习惯：每次改完配置，先在 tmux 新 pane 里curl一次，再开 vim。这个顺序能帮你把「配置问题」和「编辑器问题」彻底分开，E349 再出现时，你至少知道该往哪个方向查。
