Claude API 提示未登录问题排查与解决方案

1次阅读

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

Claude API 采用基于 token 的认证机制，核心是通过 OAuth 2.0 协议获取访问凭证。典型使用场景包括：

聊天机器人集成
自动化内容生成
知识库问答系统

认证流程分为两步：首先通过 client credentials 获取 access token，然后在后续请求的 Authorization 头携带该 token。默认 token 有效期为 1 小时，过期后需要刷新。

Token 过期未刷新 ：超过有效期后继续使用旧 token
认证头缺失 / 格式错误 ：未设置 Authorization 头或格式不符合 Bearer {token} 规范
权限作用域不足 ：请求的 API 端点超出 token 授权范围
并发令牌失效 ：同一 token 在多服务实例间共享导致冲突
时钟偏差问题 ：服务器与客户端系统时间不同步超过允许阈值

import requests
from datetime import datetime, timedelta

class ClaudeAPIClient:
    def __init__(self, client_id, client_secret):
        self.client_id = client_id
        self.client_secret = client_secret
        self.token = None
        self.token_expiry = None

    def _get_new_token(self):
        """获取新 access token"""
        auth_url = "https://api.claude.ai/oauth2/token"
        payload = {
            'grant_type': 'client_credentials',
            'client_id': self.client_id,
            'client_secret': self.client_secret
        }

        try:
            response = requests.post(auth_url, data=payload)
            response.raise_for_status()
            token_data = response.json()
            self.token = token_data['access_token']
            self.token_expiry = datetime.now() + timedelta(seconds=token_data['expires_in'] - 60)  # 提前 1 分钟刷新
            return True
        except Exception as e:
            print(f"Token 获取失败: {str(e)}")
            return False

    def _ensure_valid_token(self):
        """确保 token 有效"""
        if not self.token or datetime.now() >= self.token_expiry:
            return self._get_new_token()
        return True

    def make_request(self, method, endpoint, payload=None, max_retries=3):
        """封装 API 请求"""
        for attempt in range(max_retries):
            if not self._ensure_valid_token():
                continue

            headers = {'Authorization': f'Bearer {self.token}',
                'Content-Type': 'application/json'
            }

            try:
                response = requests.request(
                    method,
                    f"https://api.claude.ai{endpoint}",
                    json=payload,
                    headers=headers
                )

                # 处理 401 未授权响应
                if response.status_code == 401:
                    self.token = None  # 强制下次获取新 token
                    continue

                response.raise_for_status()
                return response.json()

            except requests.exceptions.HTTPError as e:
                print(f"请求失败 ( 尝试 {attempt + 1}/{max_retries}): {str(e)}")
                if attempt == max_retries - 1:
                    raise

        return None