Skip to content

[codex] Update Claude CLI billing docs#96848

Merged
vincentkoc merged 6 commits into
openclaw:mainfrom
tirion-p:codex/update-claude-p-billing-docs
Jun 28, 2026
Merged

[codex] Update Claude CLI billing docs#96848
vincentkoc merged 6 commits into
openclaw:mainfrom
tirion-p:codex/update-claude-p-billing-docs

Conversation

@tirion-p

@tirion-p tirion-p commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

What Problem This Solves

OpenClaw's Anthropic provider docs still described the previously announced June 15, 2026 Claude Agent SDK / claude -p billing change as active. Anthropic's current support article now says that change is paused, so the old wording could mislead users about whether claude -p draws from a separate Agent SDK credit or from their subscription usage limits.

Why This Change Was Made

This updates the Claude CLI billing guidance to match Anthropic's current public support language:

The docs now point users back to Anthropic's support articles before they rely on subscription billing behavior.

User Impact

Users evaluating Anthropic API keys, Claude CLI reuse, or Claude subscription proxy workflows get current billing guidance and direct official references. The recommendation to use API keys for predictable production or shared automation remains unchanged.

Evidence

  • corepack pnpm docs:list
  • corepack pnpm format:docs:check
  • corepack pnpm docs:check-mdx
  • git diff --check
  • rg -n "Starting June 15|monthly Agent SDK credit first|no longer draws from normal Claude|separate monthly Agent SDK credit" docs -S returned no matches

Flagged by @fightingsleep.

@openclaw-barnacle openclaw-barnacle Bot added docs Improvements or additions to documentation size: XS triage: low-signal-docs Candidate: docs-only change looks low signal; maintainer review needed. labels Jun 25, 2026
@clawsweeper

clawsweeper Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Codex review: needs maintainer review before merge. Reviewed June 28, 2026, 1:29 PM ET / 17:29 UTC.

Summary
The branch updates four docs pages to replace Claude Agent SDK / claude -p separate-credit billing language with Anthropic's paused-change subscription-limit guidance and official support links.

PR surface: Docs +22. Total +22 across 4 files.

Reproducibility: not applicable. as a runtime reproduction. Source inspection of current main shows the stale billing text, and the PR diff/head contents show the docs-only correction.

Review metrics: none identified.

Merge readiness
Overall: 🦞 diamond lobster
Proof: 🌊 off-meta tidepool
Patch quality: 🦞 diamond lobster
Result: ready for maintainer review.

Overall follows the weaker of proof and patch quality, so missing proof can cap an otherwise strong patch.

Next step before merge

  • No automated repair is needed; the remaining action is normal maintainer docs review and possible merge.

Security
Cleared: Docs-only changes add official support links and do not touch executable, dependency, workflow, secret, package, or security-owned surfaces.

Review details

Best possible solution:

Merge the narrow docs correction after maintainer review, keeping broader Claude CLI runtime, onboarding, or provider billing-policy work separate.

Do we have a high-confidence way to reproduce the issue?

Not applicable as a runtime reproduction. Source inspection of current main shows the stale billing text, and the PR diff/head contents show the docs-only correction.

Is this the best way to solve the issue?

Yes. Updating the affected public docs with current official Anthropic support language is the narrowest maintainable fix for the stale guidance; no OpenClaw runtime, config, or product behavior change is needed.

AGENTS.md: found and applied where relevant.

Codex review notes: model internal, reasoning high; reviewed against 891096926e27.

Label changes

Label justifications:

  • P3: This is a low-risk docs-only correction to time-sensitive provider billing guidance.
  • rating: 🦞 diamond lobster: Overall readiness is 🦞 diamond lobster; proof is 🌊 off-meta tidepool and patch quality is 🦞 diamond lobster.
  • status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR. Not applicable: Real behavior proof is not required because this PR only changes files under docs/.
Evidence reviewed

PR surface:

Docs +22. Total +22 across 4 files.

View PR surface stats
Area Files Added Removed Net
Source 0 0 0 0
Tests 0 0 0 0
Docs 4 38 16 +22
Config 0 0 0 0
Generated 0 0 0 0
Other 0 0 0 0
Total 4 38 16 +22

What I checked:

Likely related people:

  • steipete: Peter Steinberger authored the earlier Anthropic subscription and extra-usage billing guidance that this PR updates. (role: prior billing-doc author; confidence: high; commits: 45675c1698f2, 37301cbc3b33; files: docs/providers/anthropic.md)
  • vincentkoc: Vincent Koc rewrote the Anthropic provider page into its current Mintlify structure and refreshed the docs snapshot containing the affected pages. (role: recent adjacent docs contributor; confidence: medium; commits: af38536fb900, aa69b12d0086; files: docs/providers/anthropic.md, docs/help/faq-models.md, docs/help/testing-live.md)
  • llagy009: Current blame for the affected docs lines points to a recent main commit that reintroduced the docs files, though the commit subject is unrelated to billing guidance. (role: recent line-blame contributor; confidence: low; commits: b5c662f4f54c; files: docs/providers/anthropic.md, docs/help/faq-models.md, docs/help/testing-live.md)
What the crustacean ranks mean
  • 🦀 challenger crab: rare, exceptional readiness with strong proof, clean implementation, and convincing validation.
  • 🦞 diamond lobster: very strong readiness with only minor maintainer review expected.
  • 🐚 platinum hermit: good normal PR, likely mergeable with ordinary maintainer review.
  • 🦐 gold shrimp: useful signal, but proof or patch confidence is still limited.
  • 🦪 silver shellfish: thin signal; proof, validation, or implementation needs work.
  • 🧂 unranked krab: not merge-ready because proof is missing/unusable or there are serious correctness or safety concerns.
  • 🌊 off-meta tidepool: rating does not apply to this item.

Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics.

How this review workflow works
  • ClawSweeper keeps one durable marker-backed review comment per issue or PR.
  • Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
  • A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
  • PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
  • Maintainers can also comment @clawsweeper review to request a fresh review only.
  • Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
  • Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
  • Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

@tirion-p
tirion-p marked this pull request as ready for review June 25, 2026 19:29
@clawsweeper clawsweeper Bot added rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. P3 Low-priority cleanup, docs, polish, ergonomics, or speculative work. labels Jun 25, 2026
@tirion-p

Copy link
Copy Markdown
Contributor Author

Updated docs/help/testing-live.md to remove the stale extra-usage billing wording and align the live-testing note with the Anthropic pause guidance.

Validation rerun:

  • corepack pnpm docs:list
  • corepack pnpm format:docs:check
  • corepack pnpm docs:check-mdx
  • git diff --check
  • targeted stale billing wording rg check returned no matches

@clawsweeper re-review

@clawsweeper

clawsweeper Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

🦞🧹
ClawSweeper re-review requested.

I asked ClawSweeper to review this item again.
Action: item re-review queued (workflow sweep.yml, event repository_dispatch).
Result: the existing ClawSweeper review comment will be edited in place when the review finishes.

@clawsweeper clawsweeper Bot added rating: 🦞 diamond lobster Very strong PR readiness with only minor maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. and removed rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. labels Jun 25, 2026
@tirion-p

Copy link
Copy Markdown
Contributor Author

Hi maintainers, this should be ready for review when someone has a moment.

This is a docs-only update for stale Claude Agent SDK / claude -p billing guidance after Anthropic paused the June 15 billing change. It does not claim to fix the broader Claude CLI runtime/auth issues.

Current state:

  • CI is green
  • ClawSweeper marked it ready for maintainer review
  • Diff is limited to 4 docs files
  • Official Anthropic support links are included
  • No remaining author-side changes are known

Would appreciate a maintainer review/merge if the docs direction looks right.

@clawsweeper clawsweeper Bot added rating: 🦞 diamond lobster Very strong PR readiness with only minor maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. and removed rating: 🦞 diamond lobster Very strong PR readiness with only minor maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. labels Jun 26, 2026
@vincentkoc
vincentkoc merged commit 928aa3e into openclaw:main Jun 28, 2026
36 checks passed
github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request Jun 29, 2026
* Update Claude CLI billing docs

* Sync Claude live testing billing note
QiuYuang pushed a commit to QiuYuang/openclaw that referenced this pull request Jul 1, 2026
* Update Claude CLI billing docs

* Sync Claude live testing billing note
chenyangjun-xy pushed a commit to chenyangjun-xy/openclaw that referenced this pull request Jul 1, 2026
* Update Claude CLI billing docs

* Sync Claude live testing billing note
chenyangjun-xy pushed a commit to chenyangjun-xy/openclaw that referenced this pull request Jul 3, 2026
* Update Claude CLI billing docs

* Sync Claude live testing billing note
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation P3 Low-priority cleanup, docs, polish, ergonomics, or speculative work. rating: 🦞 diamond lobster Very strong PR readiness with only minor maintainer review expected. size: XS status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. triage: low-signal-docs Candidate: docs-only change looks low signal; maintainer review needed.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants