应启用自动token刷新机制：一、在cli配置中设置refresh_enabled: true并指定refresh_endpoint；二、部署定时守护进程每25分钟刷新token；三、在jetbrains插件中开启proactive token refresh并设阈值为180秒。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder API 过程中遭遇请求被拒绝、返回 429 或认证失效错误，且日志显示 token 已过期或刷新失败，则很可能是 Token 刷新机制未正确配置。以下是解决此问题的步骤：
一、启用自动 Token 刷新中间件
Qoder CLI 与 SDK 支持内置的 token 自动续期逻辑，需显式启用并绑定刷新端点。该机制依赖服务端颁发的 refresh_token 字段及有效期策略，在 access_token 失效前主动发起续期请求，避免调用中断。
1、确认 Qoder 服务端已开启 OAuth2.0 刷新流程，并在 /token 接口响应中包含 refresh_token 和 expires_in 字段。
2、在 Qoder CLI 配置文件 ~/.qoder/config.yaml 中添加如下字段：
3、将 refresh_enabled: true 设置为布尔真值。
4、指定 refresh_endpoint: "https://api.qoder.com/v1/auth/refresh"，确保该地址与服务端实际刷新接口一致。
5、保存配置后执行 qodercli auth reload 重新加载凭证上下文。
二、配置本地定时刷新守护进程
当无法依赖服务端自动刷新时，可部署独立守护进程定期调用刷新接口并更新本地 token 存储。该方式绕过客户端 SDK 限制，适用于 CI/CD 环境或自定义脚本集成场景。
1、创建 shell 脚本 refresh_token.sh，内容包含 curl 请求调用刷新接口，并解析响应中的 access_token 字段。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、使用 jq -r '.access_token' 提取新 token 值并写入 ~/.qoder/token.cache 文件。
3、设置 crontab 每 25 分钟执行一次： */25 * * * * /path/to/refresh_token.sh（确保早于默认 30 分钟过期窗口）。
4、在调用 Qoder API 前，脚本读取 ~/.qoder/token.cache 并注入 Authorization 请求头。
三、在 JetBrains 插件中启用 Token 生命周期监听
JetBrains 插件提供运行时 token 状态感知能力，可在 access_token 即将过期前触发后台刷新，并无缝替换内存中凭证，用户无感知。
1、打开 IntelliJ IDEA 或 PyCharm 的 Qoder 插件设置面板。
2、勾选 Enable proactive token refresh 选项。
3、将 Refresh threshold (seconds) 设为 180（即提前 3 分钟启动刷新）。
4、点击 Apply and Restart IDE 使配置生效。
5、插件将在每次请求前检查 token 剩余有效期，低于阈值时自动调用刷新接口并缓存新凭证。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
