Skip to content

docs: note that macOS keychain claude logins do not persist refreshes - #468

Merged
umputun merged 2 commits into
masterfrom
docker-keychain-refresh-docs
Oct 24, 2026
Merged

umputun merged 2 commits into
masterfrom
docker-keychain-refresh-docs

Conversation

@umputun

@umputun umputun commented Oct 24, 2026

Copy link
Copy Markdown
Owner

the Docker wrapper bind-mounts ~/.claude/.credentials.json and ~/.codex/auth.json so token refreshes reach the host (#412). A Claude login kept only in the macOS keychain takes a different path: the wrapper extracts it, mounts it read-only and copies it into the container, so a refresh during a long run stays there and can force a new login on the host. The README said refreshes always persist.

  • both "refreshes persist" claims now carry the keychain exception
  • new "Claude login in the macOS keychain" note with the claude setup-token + -E CLAUDE_CODE_OAUTH_TOKEN workaround from the issue thread, and the fact that the wrapper still needs a regular host login
  • two backlog items: the wrapper still reads the keychain when that token is passed, and the keychain extraction path has no test

keychain write-back itself is not part of this, so #411 stays open for it.

Related to #411

The Docker wrapper bind-mounts ~/.claude/.credentials.json and ~/.codex/auth.json so token
refreshes reach the host. A Claude login kept only in the macOS keychain is extracted, mounted
read-only and copied into the container instead, so a refresh during a run stays there and can
force a new login on the host. The README said refreshes always persist.

Document the exception and the claude setup-token plus -E CLAUDE_CODE_OAUTH_TOKEN workaround,
including that the wrapper still needs a regular host login.

Related to #411
Copilot AI balanced review requested due to automatic review settings October 24, 2026 17:53

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying ralphex with  Cloudflare Pages  Cloudflare Pages

Latest commit: eb90203
Status: ✅  Deploy successful!
Preview URL: https://927183b4.ralphex.pages.dev
Branch Preview URL: https://docker-keychain-refresh-docs.ralphex.pages.dev

View logs

@umputun
umputun merged commit 7909fff into master Oct 24, 2026
5 checks passed
@umputun
umputun deleted the docker-keychain-refresh-docs branch October 24, 2026 17:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants