401错误主因是密钥未被正确加载或校验失败。需依次验证：环境变量是否注入进程（重启Kernel）、密钥是否含隐藏字符、请求头Authorization格式是否合规（Bearer后必须空格）、SDK是否自动添加前缀、密钥状态/权限/端点是否匹配，以及插件是否劫持请求头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在Jupyter Notebook里填好了API密钥，执行代码却报“Unauthorized (401)”或“Invalid API Key”，说明密钥虽已写入，但未被实际加载或校验失败——这不是配置动作没做，而是密钥在传输链路中某处被截断、变形或绕过。
先确认密钥是否真被Notebook进程读到
打开一个新单元格，运行：
import os
print(os.environ.get("CODEBUDDY_OPENAI_API_KEY"))
如果输出为None或空字符串，说明环境变量根本没注入到当前Python进程里。Jupyter Notebook启动时会继承父Shell的环境变量，但如果你是在Notebook启动后才用%env或export设置的，它不会自动刷新。
必须重启Kernel：点击菜单栏【Kernel】→【Restart Kernel and Clear All Outputs】，再重试打印命令。这一步跳过，后面所有排查都白费。
检查密钥粘贴时是否带隐藏字符
方法一：用VS Code打开任意文本文件，启用「显示所有字符」（Ctrl+Shift+P → Toggle Render Whitespace），把密钥粘贴进去。重点看开头和结尾有没有灰色小点（空格）、折行符（¶）或零宽空格（U+200B）。这些字符肉眼不可见，但服务端校验时会直接拒绝。
方法二：在终端里执行echo "sk-xxx" | hexdump -C | head -n 3，观察输出末尾是否有0a（换行）、20（空格）或e2 80 8b（零宽空格）。只要出现其中任意一个，就必须重新从控制台「Copy」图标复制，不能手动拖选。
【密钥必须是纯ASCII字符串，首尾绝对不能有任何不可见符号】
验证请求头构造是否合规
第一步：在Notebook中插入以下最小化测试代码（替换为你的真实密钥）：
import requests
url = "https://api.openai.com/v1/models"
headers = {"Authorization": "Bearer sk-abc123xyz"}
r = requests.get(url, headers=headers)
print(r.status_code, r.text)
第二步：如果返回401且message含"invalid api key"，立刻检查headers字典里的键名是否拼错——必须是Authorization，不是authorization、Auth、API-Key或X-API-Key；值必须严格为"Bearer "加空格再接密钥，不能写成"Bearer: sk-xxx"或"Bearer=sk-xxx"。
第三步：若你用的是SDK（如openai Python包），确认它没自动拼接Bearer前缀。有些旧版SDK要求传入纯密钥，由它自己加Bearer；新版则可能要求你传入已带Bearer的字符串。查你所用SDK文档的Authentication章节，别凭经验猜。
核对密钥权限与端点是否匹配
登录密钥所属平台控制台（OpenAI Platform / Anthropic Console / DeepSeek Platform等），找到该密钥详情页：
① 确认Status为Active，不是Revoked或Expired；
② 展开Permissions或Scopes列表，必须包含你调用的API路径对应权限——例如调/v1/chat/completions，OpenAI需勾选models:read和assistants:read；DeepSeek V4密钥必须显式启用Allow access to DeepSeek-V4 models；
③ 检查Base URL是否与密钥所属平台一致：用OpenAI密钥请求https://api.anthropic.com/v1/messages，必然401；用Azure密钥调https://api.openai.com/v1/chat/completions，同样失败。
注意：Coding Plan套餐密钥必须绑定当前账号下的有效实例，跨账号或过期套餐的密钥会被静默拒绝，控制台不提示具体原因。
排除Notebook插件或代理干扰
如果你装了Jupyter插件（如jupyter-http-over-ws、jupyterlab-system-monitor），它们可能劫持HTTP请求并清除Authorization头。临时禁用所有非核心插件：在终端执行jupyter labextension list，记下已启用的第三方扩展名，然后逐个禁用：
jupyter labextension disable @jupyterlab/extension-name
重启Jupyter Lab，再跑一次最小化测试。若问题消失，说明某个插件破坏了请求头完整性。
