Claude Direct

ClaudeDirect

A pixel mascot sits on the left. On the right, two rows of label, value and bar page through:

Claw'd mascots are natively rendered, no icons needed. Bars turn yellow and then red at the warning and high thresholds, and the mascot gets more worried with the higher of 5h and 7d. -- means no active window. A red pixel bottom-right means the last fetch failed. Errors show as SETUP (no token), AUTH (token rejected) or API (nothing fetched yet).

Install

1. First, get a refresh token. You need Python 3 and a Claude account. Create get-token.py file and run it:

#!/usr/bin/env python3
"""One-time OAuth login (PKCE) that prints a refresh token for the clock app.

Run it, open the printed URL, log in, paste the code shown on the callback page.
The refresh token belongs to this login only, so no other client invalidates it.
"""

import base64
import hashlib
import json
import secrets
import sys
import urllib.error
import urllib.parse
import urllib.request

CLIENT_ID = "9d1c250a-e61b-44d9-88ed-5944d1962f5e"
AUTHORIZE_URL = "https://claude.ai/oauth/authorize"
TOKEN_URL = "https://console.anthropic.com/v1/oauth/token"
REDIRECT_URI = "https://console.anthropic.com/oauth/code/callback"
SCOPE = "user:profile"


def main() -> int:
    verifier = secrets.token_urlsafe(32)
    challenge = (
        base64.urlsafe_b64encode(hashlib.sha256(verifier.encode("ascii")).digest())
        .rstrip(b"=")
        .decode("ascii")
    )
    state = secrets.token_urlsafe(32)

    url = AUTHORIZE_URL + "?" + urllib.parse.urlencode(
        {
            "code": "true",
            "client_id": CLIENT_ID,
            "response_type": "code",
            "redirect_uri": REDIRECT_URI,
            "scope": SCOPE,
            "code_challenge": challenge,
            "code_challenge_method": "S256",
            "state": state,
        }
    )
    print("Open this URL, log in, and copy the code shown afterwards:\n")
    print(url + "\n")

    pasted = input("Paste your code here: ").strip()
    code, _, returned_state = pasted.partition("#")
    if returned_state and returned_state != state:
        print("State mismatch, aborting.", file=sys.stderr)
        return 1

    request = urllib.request.Request(
        TOKEN_URL,
        data=json.dumps(
            {
                "grant_type": "authorization_code",
                "code": code,
                "state": returned_state or state,
                "client_id": CLIENT_ID,
                "redirect_uri": REDIRECT_URI,
                "code_verifier": verifier,
            }
        ).encode(),
        headers={
            "Content-Type": "application/json",
            "User-Agent": "claude-direct/1.0",
        },
    )
    try:
        with urllib.request.urlopen(request, timeout=15) as resp:
            tokens = json.load(resp)
    except urllib.error.HTTPError as err:
        print(f"Token exchange failed ({err.code}): {err.read().decode()}", file=sys.stderr)
        return 1

    refresh = tokens.get("refresh_token")
    if not refresh:
        print("No refresh_token in response.", file=sys.stderr)
        return 1
    print("\nPaste this into the app's 'Refresh token' setting:\n")
    print(refresh)
    return 0

if __name__ == "__main__":
    sys.exit(main())

Run it:

python3 get-token.py

• Open the URL it prints and log in to Claude.
• Authorise the app and copy the code displayed on the page and paste it into the terminal.
• The script prints a refresh token. Paste it into the app's Refresh token setting.

The token belongs to this login only, so Claude Code and other tools do not invalidate it. If the clock shows AUTH, run the script again and paste the new token over the old one.

1. In the clock's web UI, open Scripts, create a script named ClaudeDirect, paste claude-direct.ax and save.
2. Open Apps, click the gear on ClaudeDirect, paste the token into Refresh token and save.

Settings