CLI 子命令看官方文档生成长期有效的 OAuth 令牌Syntaxclaude setup-token示例claude setup-token全网调研整理典型场景CI/CD 流水线(GitHub Actions、容器、无头服务器)中无法弹出浏览器时,替代交互式 /login 完成认证WSL2、SSH 远端、Docker 容器等本地回调无法到达的环境中,生成可携带令牌供脚本使用以 Claude Pro/Max 订阅额度驱动 claude -p 非交互模式或 Agent SDK 调用,无需单独 API 账单将令牌存入仓库 Secrets,在 Anthropic 官方 GitHub Actions 集成中按需使用令牌泄露或到期后快速续签,重新运行即可生成新令牌,无需重走完整登录流程实用技巧令牌不会自动保存,运行后必须立即复制并设置 export CLAUDE_CODE_OAUTH_TOKEN=<token>令牌格式固定为 sk-ant-oat01-...,可通过前缀快速区分 OAuth 令牌与普通 API Key(sk-ant-api...)运行 /status 命令可确认当前激活的认证方式,排查是否被更高优先级变量静默覆盖有效期约一年,到期后直接重跑 claude setup-token 即可续签,不必重走完整浏览器登录2026-06-15 起非交互式 Agent SDK 用量将从新增的月度 Agent SDK 独立额度扣除,不再消耗交互配额常见坑ANTHROPIC_API_KEY 优先级高于 CLAUDE_CODE_OAUTH_TOKEN,shell profile 中残留旧 API Key 会静默覆盖订阅令牌并意外产生按量计费--bare 模式不读取 CLAUDE_CODE_OAUTH_TOKEN,必须改用 ANTHROPIC_API_KEY 或 apiKeyHelper 才能正常认证令牌仅限推理调用,无法用于建立 Remote Control 远程控制会话来源Authentication - Claude Code Docs (官方文档)Claude Code on Max Plan: OAuth Token vs API Key in 2026 - Medium支持 claude setup-token OAuth Token - GitHub Issue #186Claude Agent SDK OAuth Demo - GitHub回到命令字典