Qwen Code 认证配置 2 分钟速通：OAuth 设备授权与 API 密钥怎么选？
【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code
装好 Qwen Code，敲下第一条命令之前，还差一步：告诉它你是谁。这一步只做一次，配置正确后所有模型调用、工具执行都能直接跑，省掉每次手工填 Key 的麻烦。本文带你把认证配好，配完就能正常开工。
先定方向：两条认证路径怎么选
| 认证方式 | 适合谁 | 优点 | 代价 |
|---|---|---|---|
| OAuth 2.0 设备授权 | 个人用户、通义千问账号 | 不用自己保管密钥，令牌自动刷新 | 首次要在浏览器里点一次授权 |
| API 密钥 | 团队环境、脚本化部署 | 配置直接、可写进.env统一管理 | 密钥要自己保管，泄露风险自担 |
拿不准就选 OAuth，默认推荐它。
三步完成 OAuth 设备授权
- 终端里运行
qwen auth。系统侧会向认证服务器申请一个设备代码——可以理解成一次性取件码。 - 浏览器自动打开授权页，登录账号并确认。服务端确认是你本人在操作，才会放行。
- 授权页返回成功后无需任何操作。后台在持续轮询设备代码状态，拿到访问令牌后直接落盘，全程托管。
两个细节值得知道：
- 凭据写在用户主目录的
.qwen文件夹里，文件名oauth_creds.json。换机器迁移时带上这个文件即可。 - 整个流程启用了 PKCE——一种给授权码加上"防伪指纹"的机制，防止别人截获授权码冒充你换令牌。
API 密钥配置：一个 .env 文件搞定
偏好密钥的用户，在项目根目录建一个.env文件，按要用的服务商写入对应变量：
OPENAI_API_KEY=你的密钥 ANTHROPIC_API_KEY=你的密钥 GOOGLE_API_KEY=你的密钥目前支持的类型包括 OpenAI、Anthropic、Google 以及通义千问 OAuth 认证。变量名和认证方式的对应关系、以及"密钥缺失时该补哪里"的校验逻辑，都在 packages/cli/src/config/auth.ts 里，报错信息也出自这里，排障时可对照阅读。
令牌怎么保鲜
访问令牌都有过期时间，到期后 Qwen Code 会用刷新令牌自动换新，你感知不到这个动作。只有当刷新本身失败（最常见是凭据已失效或网络不通），程序才会停下来提示你重新走一遍qwen auth。平时不需要手动管理令牌。
卡住了？三步自检
| 症状 | 可能原因 | 处理 |
|---|---|---|
授权页一直转圈、qwen auth长时间无响应 | 网络到不了认证服务器 | 检查代理、代理白名单或换网络 |
| 授权成功却报时间戳/签名类错误 | 系统时钟偏差 | 校准系统时间到 NTP 同步 |
| 反复提示未认证，换网络也没用 | 本地缓存的凭据损坏或过期 | 删除~/.qwen/oauth_creds.json后重新qwen auth |
配完后的体检
- 确认
~/.qwen/oauth_creds.json存在且是今天生成或刚刷新过的。 - 验证一次真实对话能正常返回，而不是只看到欢迎界面。
- 验证过两天后无需任何操作，回复依然正常——这证明自动刷新链路是通的。
收尾
认证配好后，代码生成与编辑、多文件批量操作、IDE 集成、实时协作这些能力全部解锁，直接可用。一条专业提示：留意oauth_creds.json的最后刷新时间，长期闲置（数周以上）再回来用时，若发现提示重新认证，属于令牌彻底过期，重跑一次qwen auth即可，不用怀疑配置丢了。
【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
