Skip to content

[docs] AI Stack — Token Plan: document both Base URL forms (Anthropic vs OpenAI) — VI + EN - #33

Merged
greennode-vdb merged 1 commit into
mainfrom
huyenttn3
Aug 5, 2026
Merged

[docs] AI Stack — Token Plan: document both Base URL forms (Anthropic vs OpenAI) — VI + EN#33
greennode-vdb merged 1 commit into
mainfrom
huyenttn3

Conversation

@greennode-vdb

Copy link
Copy Markdown
Contributor

Follow-up to #32.

Problem

Every Token Plan page gave only the OpenAI-standard endpoint (https://tokenplan.api.greennode.ai/v1), so a reader setting up Claude Code or Claude Desktop had no correct Base URL — and the A-Z guide / Manage pages told them to "confirm the applicable endpoint with the support team" instead of stating it.

The correct values are already published in the AI Coding guides (commit 48ff1bab, getting-started.md / bat-dau.md):

Tool standard Token Plan Base URL
OpenAI (Cursor, Continue.dev, OpenCode, Codex, LiteLLM, OpenAI SDK…) https://tokenplan.api.greennode.ai/v1with /v1
Anthropic (Claude Code, Claude Desktop, Anthropic SDK) https://tokenplan.api.greennode.aino /v1

This PR makes the Token Plan section say the same thing.

What changed

README (VI + EN) — the Subscription Endpoint bullet now names the shared host and splits the two forms instead of presenting /v1 as the only option.

A-Z guide (VI + EN)

  • Section 5 now opens with a standard → Base URL table, so the rule is stated before any tool-specific steps.
  • New section 5.6, "Anthropic-standard tools (Claude Code, Claude Desktop)"ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN blocks for macOS/Linux/WSL and Windows PowerShell, matching the style of 5.2.
  • 5.1 and 5.2 relabelled as the OpenAI-standard path so their /v1 values aren't read as universal.
  • Section 2 (Package Detail) and section 4 (the "3 values to jot down" table) list both forms.
  • Section 5.5: the 404 Not Found row now covers the real failure — the Base URL doesn't match your tool's standard — rather than only "missing /v1".
  • Section 6.2: the 3-value block an Admin hands to each member shows both URLs with a comment marking which is which.
  • Removed the closing warning hint that now duplicated 5.6 sitting directly above it.

Buy / Manage (VI + EN) — Subscription Endpoint description and the PAYG-vs-Token-Plan comparison table list both forms (comparison table split into two Base URL rows, Compatibility row now OpenAI SDK / Anthropic SDK). The Claude Code note gives the actual URL and env var names instead of deferring to support.

Verification

All 8 Token Plan files pass: 0 dead relative links, 0 dead heading anchors (including the new #56-… cross-references and the diacritic-stripped Vietnamese anchors GitBook generates), every table has a separator row, hint/tabs/tab blocks balanced, no unclosed code fences. VI and EN A-Z guides still mirror at 24 headings each.

Files

  • English/ai-stack/token-plan/{README,a-z-guide,buy-token-plan,manage-token-plan}.md
  • Vietnamese/ai-stack/token-plan/{README,huong-dan-a-z,mua-goi-token-plan,quan-ly-token-plan}.md

🤖 Generated with Claude Code

… vs OpenAI) — VI + EN

Every Token Plan page only gave the OpenAI-standard endpoint with /v1, so
Claude Code / Claude Desktop users had no correct Base URL. Aligns with the
values already published in the AI Coding guides (commit 48ff1ba):

  OpenAI standard    -> https://tokenplan.api.greennode.ai/v1
  Anthropic standard -> https://tokenplan.api.greennode.ai   (no /v1)

- README: Subscription Endpoint split into the two forms
- A-Z guide: new section 5.6 for Anthropic-standard tools with
  ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN blocks; 5.1 and 5.2 relabelled as
  the OpenAI-standard path; section 5 opens with a standard-to-URL table;
  Package Detail and "3 values" tables list both forms; the 404 row now covers
  the wrong-form-for-your-standard case; the key handout block in 6.2 shows both
- Buy / Manage: Subscription Endpoint and the PAYG comparison table list both
  forms; the Claude Code note gives the actual URL instead of asking the reader
  to check with support

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@greennode-vdb
greennode-vdb merged commit 2eada68 into main Aug 5, 2026
8 checks passed
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