Claude API 鉴权失败排查指南：从原理到解决 ‘not logged in’ 错误

1次阅读

共计 1695 个字符，预计需要花费 5 分钟才能阅读完成。

Claude API 采用 OAuth2.0 授权框架配合 JWT(JSON Web Token) 实现双重安全校验。这套组合方案既保证了第三方应用的安全接入能力（OAuth2.0 的强项），又通过 JWT 的自包含特性实现了无状态的验证流程。

OAuth2.0 流程 ：
客户端通过 client_credentials 模式获取 access_token
授权服务返回包含 scope 权限声明的令牌
后续请求需在 Authorization 头携带 Bearer token
JWT 验证机制 ：
令牌采用 HS256 算法签名防止篡改
标准声明包含 iss(签发者)、exp(过期时间)、sub(用户标识)
API 网关会验证签名有效性和时效性

令牌过期 ：JWT 的 exp 声明时间早于当前服务器时间
签名错误 ：客户端生成的签名与服务端验证不匹配
跨域问题 ：CORS 预检请求未携带认证头
权限不足 ：请求的 API 路径不在 token 的 scope 范围内
时钟漂移 ：客户端与认证服务器存在超过 30 秒的时间差

import time
import jwt
from datetime import datetime, timedelta

# 生成带签名的 JWT
def generate_token(api_key):
    payload = {
        'iss': 'client_id_123',
        'exp': datetime.utcnow() + timedelta(minutes=30),
        'scope': 'claude_api'
    }
    return jwt.encode(payload, api_key, algorithm='HS256')

# 请求重试装饰器
def retry_on_401(max_retries=3):
    def decorator(func):
        def wrapper(*args, **kwargs):
            for _ in range(max_retries):
                response = func(*args, **kwargs)
                if response.status_code != 401:
                    return response
                time.sleep(1)
            raise Exception('Authentication failed after retries')
        return wrapper
    return decorator

const jwt = require('jsonwebtoken');

// 令牌缓存对象
const tokenCache = {
  value: null,
  expireAt: 0
};

function getCachedToken(apiKey) {if (tokenCache.value && Date.now() < tokenCache.expireAt) {return tokenCache.value;}

  const newToken = jwt.sign({ iss: 'client_id_123', exp: Math.floor(Date.now() / 1000) + 1800 },
    apiKey,
    {algorithm: 'HS256'}
  );

  tokenCache.value = newToken;
  tokenCache.expireAt = Date.now() + 1700 * 1000; // 提前 100 秒过期
  return newToken;
}