mac版codex linear插件关联失败主因是linear访问令牌过期或权限失效;需通过curl验证token状态,重新生成并配置具备读取权限的新token,清除缓存后重启验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Mac版Codex Linear插件关联失败,通常不是插件本身损坏,而是本地存储的Linear访问令牌(token)已过期或权限失效,导致Codex无法调用Linear API获取项目、任务等数据。
确认Linear Token是否已失效
打开终端,执行:
curl -I -H "Authorization: Bearer 【你的Linear token】" https://api.linear.app/graphql
若返回 HTTP/2 401 或 403,说明token已过期或权限不足;返回 200 则说明token仍有效,问题不在认证层。
注意:Linear token在创建后默认永不过期,但一旦你在Linear账户中主动撤销、重置或修改了应用权限,旧token会立即失效。不要尝试复用半年前生成的token。
重新生成Linear Personal API Token
登录 Linear 官网 → 点击右上角头像 → Settings → Developer settings → Personal API tokens → Generate new token。
勾选以下必要权限:
• Read tasks
• Read projects
• Read teams
• Read users
【务必取消勾选“Delete”类权限,Codex插件无需写删权限,开启反而触发Linear安全拦截】
复制生成的完整token(以“lin_”开头的长字符串),立即保存——页面关闭后无法再次查看明文。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
在Codex中注入新Token
第一步:关闭所有Codex进程
在活动监视器中搜索并强制退出 Codex、Electron、node 进程,确保无残留服务在后台读取旧配置。
第二步:定位并替换token配置文件
打开访达,前往:
~/Library/Application Support/codex/plugins/linear/config.json
用文本编辑器打开该文件,将其中 "token": "旧值" 替换为新复制的 "token": "lin_xxx..."。
第三步:清除Linear缓存目录
执行命令:
rm -rf ~/Library/Caches/codex/linear
这一步不可跳过——Codex Linear插件会缓存schema和project列表,若缓存未清,即使token更新,仍可能沿用旧schema报错“Field not found”。
验证Linear连接是否生效
方法一:终端手动触发同步
cd ~/.codex && codex linear sync --verbose
观察输出中是否出现 Fetched 12 projects, 87 tasks 类成功日志;若卡在 Fetching schema... 超过10秒,说明token未被接受或网络策略拦截GraphQL请求。
方法二:VS Code内实时检测
打开任意代码文件 → 按 Cmd+Shift+P → 输入 “Codex: Show Linear Tasks” → 若弹出任务列表即成功;若提示 “No Linear projects found”,请检查Linear团队是否已邀请当前邮箱账户加入。










