@codexapi/codexclaude 2.0.12 → 2.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CUSTOMIZATIONS.md CHANGED
@@ -5,8 +5,8 @@
5
5
  ## Upstream Runtime
6
6
 
7
7
  - Official package: `@openai/codex`
8
- - Pinned runtime version: `0.141.0`
9
- - Local launcher version: `2.0.12`
8
+ - Pinned runtime version: `0.142.2`
9
+ - Local launcher version: `2.0.13`
10
10
 
11
11
  ## Launcher Behavior
12
12
 
@@ -30,19 +30,20 @@ The launcher writes a Codex model provider named `codexapi`:
30
30
 
31
31
  ## Runtime Defaults
32
32
 
33
- - Model: selected by the user, defaulting to `gpt-5.5`; supported launcher choices are `gpt-5.5`, `claude-opus-4-8`, `deepseek-v4-pro`, and `gemini-3.5-flash`.
33
+ - Model: selected by the user, defaulting to `gpt-5.5`; supported launcher choices are `gpt-5.5`, `claude-opus-4-8`, `claude-sonnet-4-6`, `claude-fable-5`, `deepseek-v4-pro`, and `gemini-3.5-flash`.
34
34
  - Reasoning effort displayed in Codex: `xhigh`
35
- - Server-side upstream reasoning effort: `low`, enforced by CodexAPI.pro regardless of client display.
36
- - Local model catalog: `~/.codexclaude/model_catalog.json`; this keeps native Codex `/model` limited to the four supported CodexAPI.pro choices and prevents fallback metadata warnings for Opus 4.8, Deepseek v4 Budget, and Google Gemini Flash 3.5.
35
+ - Server-side upstream reasoning effort: `high`, enforced by CodexAPI.pro regardless of client display.
36
+ - Local model catalog: `~/.codexclaude/model_catalog.json`; this keeps native Codex `/model` limited to the six supported CodexAPI.pro choices and prevents fallback metadata warnings for Opus 4.8, Sonnet 4.6, Fable 5, Deepseek v4 Budget, and Google Gemini Flash 3.5.
37
37
  - Service tier: omitted by default; `/fast` remains a user-controlled Codex setting and is billed server-side when active.
38
38
  - Approval policy: `never`
39
39
  - Sandbox mode: `danger-full-access`
40
40
  - TUI status line: `model-with-reasoning`, `fast-mode`, `current-dir`
41
- - Opus 4.8 Responses traffic is always routed through the Chicago CodexAPI.pro Claude tool-call bridge, regardless of the selected account/dashboard region.
41
+ - Claude-family Responses traffic uses the Claude-compatible CodexAPI.pro endpoint for CodexAPI.pro and ChatPlus accounts, while MyAPI.world accounts keep the MyAPI endpoint.
42
+ - Fable 5 stays visible to the user while the backend applies the custom routed premium path and 5x billing multiplier.
42
43
  - Deepseek v4 Budget Responses traffic is routed through CodexAPI.pro's Deepseek-compatible gateway.
43
- - Google Gemini Flash 3.5 Responses traffic keeps the user-visible Gemini model id while CodexAPI.pro routes it internally through Sonnet 4.6 with low server effort.
44
+ - Google Gemini Flash 3.5 Responses traffic keeps the user-visible Gemini model id while CodexAPI.pro routes it internally through Sonnet 4.6 with the configured server effort.
44
45
 
45
- Current backend state verified on 2026-06-18: CodexAPI.pro is routing ChatGPT-5.5 traffic through the signed-in Codex account path with `CODEXAPI_GPT55_ROUTE_MODE=codex`. Admin Manage Models can switch cross-model routing to GPT-5.5 via Opus 4.8 or Opus 4.8 via GPT-5.5. This is server-side operational routing and must not change the launcher-visible model ids, model catalog, or customer-facing labels.
46
+ Current backend state verified on 2026-06-25: Admin Manage Models controls runtime routing server-side. This operational routing must not change the launcher-visible model ids, model catalog, or customer-facing labels.
46
47
 
47
48
  ## Wallet Display
48
49
 
@@ -57,3 +58,9 @@ The same wallet lookup is available through:
57
58
  ```bash
58
59
  codexclaude status
59
60
  ```
61
+
62
+ Recent token usage is available through:
63
+
64
+ ```bash
65
+ codexclaude usage
66
+ ```
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # codexclaude
2
2
 
3
- `codexclaude` is the CodexAPI.pro launcher for customers who want one coding CLI that can use ChatGPT-5.5, Opus 4.8, Deepseek v4 Budget, or Google Gemini Flash 3.5 against the same CodexAPI.pro Token Wallet.
3
+ `codexclaude` is the CodexAPI.pro launcher for customers who want one coding CLI that can use ChatGPT-5.5, Opus 4.8, Sonnet 4.6, Fable 5, Deepseek v4 Budget, or Google Gemini Flash 3.5 against the same Token Wallet.
4
4
 
5
- Version `2.0.12` launches the official OpenAI Codex CLI `0.141.0` package and applies CodexAPI.pro account, wallet, model, and Full Access defaults before Codex starts.
5
+ Version `2.0.13` launches the official OpenAI Codex CLI `0.142.2` package and applies account, wallet, model, and Full Access defaults before Codex starts.
6
6
 
7
7
  ## Install
8
8
 
@@ -48,7 +48,7 @@ Switch model:
48
48
  codexclaude model
49
49
  ```
50
50
 
51
- Available model labels are `ChatGPT-5.5`, `Opus 4.8`, `Deepseek v4 Budget`, and `Google Gemini Flash 3.5`. All four use the CodexAPI.pro Responses-compatible endpoint and the same customer Token Wallet.
51
+ Available model labels are `ChatGPT-5.5`, `Opus 4.8`, `Sonnet 4.6`, `Fable 5`, `Deepseek v4 Budget`, and `Google Gemini Flash 3.5`. All six use a Responses-compatible endpoint and the same customer Token Wallet.
52
52
 
53
53
  Show current launcher changes:
54
54
 
@@ -70,17 +70,23 @@ You can also check this without starting Codex:
70
70
  codexclaude status
71
71
  ```
72
72
 
73
+ Show recent wallet-billed token usage:
74
+
75
+ ```bash
76
+ codexclaude usage
77
+ ```
78
+
73
79
  ## Preserved CodexAPI.pro Customizations
74
80
 
75
81
  - Dashboard username or email plus password login.
76
- - ChatGPT-5.5, Opus 4.8, Deepseek v4 Budget, or Google Gemini Flash 3.5 model selection.
82
+ - ChatGPT-5.5, Opus 4.8, Sonnet 4.6, Fable 5, Deepseek v4 Budget, or Google Gemini Flash 3.5 model selection.
77
83
  - CodexAPI.pro Responses-compatible provider at `https://codexapi.pro/v1`.
78
84
  - Full Access defaults: approval policy `never` and sandbox mode `danger-full-access`.
79
85
  - xhigh visible reasoning in the local Codex UI while CodexAPI.pro keeps upstream runtime effort server-managed.
80
- - A local `~/.codexclaude/model_catalog.json` file so native Codex `/model` lists only ChatGPT-5.5, Opus 4.8, Deepseek v4 Budget, and Google Gemini Flash 3.5.
86
+ - A local `~/.codexclaude/model_catalog.json` file so native Codex `/model` lists only ChatGPT-5.5, Opus 4.8, Sonnet 4.6, Fable 5, Deepseek v4 Budget, and Google Gemini Flash 3.5.
81
87
  - No default fast service tier. Fast mode is billed only when the user enables it inside Codex.
82
- - Official Codex `0.141.0` runtime with the current profile-compatible config enabled.
83
- - Token Wallet balance lookup before launch and in `codexclaude status`.
88
+ - Official Codex `0.142.2` runtime with the current profile-compatible config enabled.
89
+ - Token Wallet balance lookup before launch, in `codexclaude status`, and recent usage in `codexclaude usage`.
84
90
  - Opus 4.8 tool-call compatibility through the Chicago CodexAPI.pro Responses gateway.
85
91
  - Google Gemini Flash 3.5 is visible to users while CodexAPI.pro routes it server-side through the approved Sonnet 4.6 low-effort bridge.
86
92
  - Backend-identifying request headers so CodexAPI.pro can enforce subscription plan rules server-side.
@@ -10,10 +10,10 @@ import { stdin as input, stdout as output } from "node:process";
10
10
 
11
11
  const require = createRequire(import.meta.url);
12
12
 
13
- const APP_VERSION = "2.0.12";
14
- const CODEX_VERSION = "0.141.0";
13
+ const APP_VERSION = "2.0.13";
14
+ const CODEX_VERSION = "0.142.2";
15
15
  const DISPLAY_REASONING_EFFORT = "xhigh";
16
- const SERVER_REASONING_EFFORT = "low";
16
+ const SERVER_REASONING_EFFORT = "high";
17
17
  const API_ORIGIN = (process.env.CODEXCLAUDE_API_ORIGIN || "https://codexapi.pro").replace(/\/+$/, "");
18
18
  const API_BASE_URL = `${API_ORIGIN}/v1`;
19
19
  const CHICAGO_API_ORIGIN = "https://api-chicago.codexapi.pro";
@@ -52,16 +52,27 @@ const MODELS = {
52
52
  label: "Opus 4.8",
53
53
  aliases: ["2", "opus", "opus-4.8", "opus-4.7", "claude", "claude-opus-4-8", "claude-opus-4-7"],
54
54
  },
55
+ "claude-sonnet-4-6": {
56
+ id: "claude-sonnet-4-6",
57
+ label: "Sonnet 4.6",
58
+ aliases: ["3", "sonnet", "sonnet-4.6", "sonnet-4-6", "claude-sonnet-4-6", "claude-sonnet-4.6"],
59
+ },
60
+ "claude-fable-5": {
61
+ id: "claude-fable-5",
62
+ label: "Fable 5",
63
+ aliases: ["4", "fable", "fable-5", "fabel", "fabel-5", "claude-fable-5", "claude-fabel-5"],
64
+ premium: true,
65
+ },
55
66
  "deepseek-v4-pro": {
56
67
  id: "deepseek-v4-pro",
57
68
  label: "Deepseek v4 Budget",
58
- aliases: ["3", "deepseek", "deepseek-v4", "deepseek-v4-pro", "budget"],
69
+ aliases: ["5", "deepseek", "deepseek-v4", "deepseek-v4-pro", "budget"],
59
70
  budget: true,
60
71
  },
61
72
  "gemini-3.5-flash": {
62
73
  id: "gemini-3.5-flash",
63
74
  label: "Google Gemini Flash 3.5",
64
- aliases: ["4", "gemini", "flash", "gemini-flash", "gemini-3.5-flash", "gemini-flash-3.5", "google-gemini-flash-3.5"],
75
+ aliases: ["6", "gemini", "flash", "gemini-flash", "gemini-3.5-flash", "gemini-flash-3.5", "google-gemini-flash-3.5"],
65
76
  },
66
77
  };
67
78
 
@@ -93,6 +104,10 @@ async function main() {
93
104
  await status();
94
105
  return;
95
106
  }
107
+ if (command === "usage") {
108
+ await usage();
109
+ return;
110
+ }
96
111
  if (command === "model") {
97
112
  await modelFlow();
98
113
  return;
@@ -122,12 +137,13 @@ codexclaude ${APP_VERSION}
122
137
 
123
138
  Commands:
124
139
  codexclaude login Login with CodexAPI.pro username/email and password
125
- codexclaude model Select ChatGPT-5.5, Opus 4.8, Deepseek v4 Budget, or Google Gemini Flash 3.5
140
+ codexclaude model Select ChatGPT-5.5, Opus 4.8, Sonnet 4.6, Fable 5, Deepseek v4 Budget, or Google Gemini Flash 3.5
126
141
  codexclaude changelog Show the latest CodexAPI.pro launcher changes
127
142
  codexclaude setup Rewrite ~/.codex/config.toml with Full Access defaults
128
143
  codexclaude start Start Codex with --search
129
144
  codexclaude resume Resume with codex resume --search
130
145
  codexclaude status Show saved account, selected model, and wallet balance
146
+ codexclaude usage Show wallet balance and recent token usage
131
147
  codexclaude logout Remove saved codexclaude account state
132
148
 
133
149
  Any other command is passed through to official Codex CLI ${CODEX_VERSION} after config is applied.
@@ -223,17 +239,17 @@ async function ensureReady() {
223
239
  async function askModel(rl, current) {
224
240
  const currentLabel = MODELS[current]?.label || MODELS["gpt-5.5"].label;
225
241
  console.log("\nChoose your coding model:");
226
- console.log(" 1. ChatGPT-5.5");
227
- console.log(" 2. Opus 4.8");
228
- console.log(" 3. Deepseek v4 Budget");
229
- console.log(" 4. Google Gemini Flash 3.5");
242
+ Object.values(MODELS).forEach((model, index) => {
243
+ const premium = model.premium ? " (5x premium billing)" : "";
244
+ console.log(` ${index + 1}. ${model.label}${premium}`);
245
+ });
230
246
  const answer = (await rl.question(`Model [${currentLabel}]: `)).trim().toLowerCase();
231
247
  if (!answer) {
232
248
  return MODELS[current] ? current : "gpt-5.5";
233
249
  }
234
250
  const match = Object.values(MODELS).find((model) => model.aliases.includes(answer));
235
251
  if (!match) {
236
- throw new Error("Unknown model choice. Enter 1 for ChatGPT-5.5, 2 for Opus 4.8, 3 for Deepseek v4 Budget, or 4 for Google Gemini Flash 3.5.");
252
+ throw new Error("Unknown model choice. Run codexclaude model and choose one of the numbered options.");
237
253
  }
238
254
  return match.id;
239
255
  }
@@ -366,6 +382,14 @@ async function getJsonAuth(pathname, config, options = {}) {
366
382
  }
367
383
  }
368
384
 
385
+ async function tryGetJsonAuth(pathname, config, options = {}) {
386
+ try {
387
+ return await getJsonAuth(pathname, config, options);
388
+ } catch {
389
+ return null;
390
+ }
391
+ }
392
+
369
393
  function updateRequiredMessage(metadata) {
370
394
  if (typeof metadata === "string") {
371
395
  return metadata;
@@ -506,6 +530,12 @@ function modelCatalogDescription(modelId) {
506
530
  if (modelId === "claude-opus-4-8") {
507
531
  return "CodexAPI.pro Opus 4.8 coding route with local Codex tools and wallet billing.";
508
532
  }
533
+ if (modelId === "claude-sonnet-4-6") {
534
+ return "CodexAPI.pro Sonnet 4.6 coding route with local Codex tools and wallet billing.";
535
+ }
536
+ if (modelId === "claude-fable-5") {
537
+ return "CodexAPI.pro Fable 5 premium coding route with local Codex tools and wallet billing.";
538
+ }
509
539
  if (modelId === "deepseek-v4-pro") {
510
540
  return "CodexAPI.pro Deepseek v4 Budget coding route with local Codex tools and wallet billing.";
511
541
  }
@@ -564,6 +594,46 @@ async function status() {
564
594
  }
565
595
  }
566
596
 
597
+ async function usage() {
598
+ const config = readConfig();
599
+ if (!config?.username) {
600
+ console.log("Not logged in. Run: codexclaude login");
601
+ return;
602
+ }
603
+ console.log(`Logged in as: ${config.username}`);
604
+ console.log(`API: ${config.apiOrigin || API_ORIGIN}`);
605
+ try {
606
+ const wallet = await walletSnapshot(config);
607
+ console.log(`Token Wallet: ${formatUsd(wallet.balance)}`);
608
+ } catch (error) {
609
+ console.log(`Token Wallet: unavailable (${error.message})`);
610
+ }
611
+ const usagePayload = await usageSnapshot(config);
612
+ if (!usagePayload) {
613
+ console.log("Usage: unavailable from this account endpoint.");
614
+ return;
615
+ }
616
+ const summary = usagePayload.summary || {};
617
+ const totalUsd = summary.totalChargedUsd || summary.totalUsd || summary.chargedUsd || null;
618
+ if (totalUsd !== null && totalUsd !== undefined) {
619
+ console.log(`Recent usage total: ${formatUsd(numericWalletValue(totalUsd))}`);
620
+ }
621
+ const transactions = Array.isArray(usagePayload.transactions) ? usagePayload.transactions.slice(0, 10) : [];
622
+ if (!transactions.length) {
623
+ console.log("No token usage transactions are recorded yet.");
624
+ return;
625
+ }
626
+ console.log("\nRecent token usage:");
627
+ for (const item of transactions) {
628
+ const when = item.createdAt || item.created_at || "";
629
+ const model = item.model || item.modelId || item.service || "model";
630
+ const amount = item.chargedUsd ?? item.charged_usd ?? item.amountUsd ?? item.amount_usd ?? "0";
631
+ const inputTokens = item.inputTokens ?? item.input_tokens ?? 0;
632
+ const outputTokens = item.outputTokens ?? item.output_tokens ?? 0;
633
+ console.log(`- ${when} · ${model} · ${formatUsd(numericWalletValue(amount))} · in ${inputTokens} / out ${outputTokens}`);
634
+ }
635
+ }
636
+
567
637
  async function runCodex(args) {
568
638
  const config = requireConfig();
569
639
  let wallet = null;
@@ -656,12 +726,10 @@ function resolveBundledCodexLaunch() {
656
726
  }
657
727
 
658
728
  async function walletSnapshot(config) {
659
- let payload = null;
660
- try {
661
- payload = await getJsonAuth("/api/v1/wallet/status", config, { timeoutMs: 10000 });
662
- } catch {
663
- payload = await getJsonAuth("/api/v1/me", config, { timeoutMs: 20000 });
664
- }
729
+ const payload =
730
+ await tryGetJsonAuth("/api/v1/wallet/status", config, { timeoutMs: 10000 }) ||
731
+ await tryGetJsonAuth("/api/v1/me", config, { timeoutMs: 20000 }) ||
732
+ await getJsonAuth("/api/me", config, { timeoutMs: 20000 });
665
733
  const user = payload?.user || {};
666
734
  const balance = numericWalletValue(
667
735
  payload?.tokenWalletBalancePreciseUsd ??
@@ -680,6 +748,10 @@ async function walletSnapshot(config) {
680
748
  };
681
749
  }
682
750
 
751
+ async function usageSnapshot(config) {
752
+ return await tryGetJsonAuth("/api/v1/billing/token-usage?limit=25&days=30", config, { timeoutMs: 20000 });
753
+ }
754
+
683
755
  function numericWalletValue(value) {
684
756
  if (typeof value === "number" && Number.isFinite(value)) {
685
757
  return value;
@@ -699,6 +771,12 @@ function modelStatusName(model) {
699
771
  if (model === "claude-opus-4-8") {
700
772
  return "opus-4.8";
701
773
  }
774
+ if (model === "claude-sonnet-4-6") {
775
+ return "sonnet-4.6";
776
+ }
777
+ if (model === "claude-fable-5") {
778
+ return "fable-5";
779
+ }
702
780
  if (model === "deepseek-v4-pro") {
703
781
  return "deepseek-v4 budget";
704
782
  }
@@ -716,6 +794,12 @@ function normalizeConfig(config) {
716
794
  if (normalized.model === "claude-opus-4-7") {
717
795
  normalized.model = "claude-opus-4-8";
718
796
  }
797
+ if (["claude-sonnet-4.6", "sonnet-4.6", "sonnet-4-6"].includes(normalized.model)) {
798
+ normalized.model = "claude-sonnet-4-6";
799
+ }
800
+ if (["claude-fabel-5", "fable-5", "fabel-5"].includes(normalized.model)) {
801
+ normalized.model = "claude-fable-5";
802
+ }
719
803
  if (["gemini-flash-3.5", "gemini-flash-3-5", "google-gemini-flash-3.5"].includes(normalized.model)) {
720
804
  normalized.model = "gemini-3.5-flash";
721
805
  }
@@ -729,7 +813,7 @@ function normalizeConfig(config) {
729
813
 
730
814
  function providerBaseUrlForConfig(config) {
731
815
  const normalized = normalizeConfig(config);
732
- if (normalized.model === "claude-opus-4-8") {
816
+ if (isCodexApiOrigin(normalized.apiOrigin) && normalized.model.startsWith("claude-")) {
733
817
  return CHICAGO_API_BASE_URL;
734
818
  }
735
819
  return `${normalized.apiOrigin || API_ORIGIN}/v1`;
@@ -737,12 +821,21 @@ function providerBaseUrlForConfig(config) {
737
821
 
738
822
  function providerOriginLabel(config) {
739
823
  const normalized = normalizeConfig(config);
740
- if (normalized.model === "claude-opus-4-8") {
741
- return `${CHICAGO_API_ORIGIN} (Chicago forced for Opus 4.8)`;
824
+ if (isCodexApiOrigin(normalized.apiOrigin) && normalized.model.startsWith("claude-")) {
825
+ return "CodexAPI.pro Claude-compatible Responses endpoint";
742
826
  }
743
827
  return normalized.apiOrigin || API_ORIGIN;
744
828
  }
745
829
 
830
+ function isCodexApiOrigin(origin) {
831
+ try {
832
+ const host = new URL(origin || API_ORIGIN).hostname.toLowerCase();
833
+ return host === "codexapi.pro" || host.endsWith(".codexapi.pro") || host === "chatplus.chat" || host.endsWith(".chatplus.chat");
834
+ } catch {
835
+ return false;
836
+ }
837
+ }
838
+
746
839
  function formatUsd(value) {
747
840
  return `$${Number(value || 0).toLocaleString("en-US", {
748
841
  minimumFractionDigits: 2,
package/codexclaude.md CHANGED
@@ -9,8 +9,8 @@ there is no supported configuration or API boundary that can solve the issue.
9
9
  ## Current Release
10
10
 
11
11
  - Launcher package: `@codexapi/codexclaude`
12
- - Launcher version: `2.0.12`
13
- - Official Codex runtime dependency: `@openai/codex@0.141.0`
12
+ - Launcher version: `2.0.13`
13
+ - Official Codex runtime dependency: `@openai/codex@0.142.2`
14
14
  - Public install command: `npm install -g @codexapi/codexclaude@latest`
15
15
  - Default API origin: `https://codexapi.pro`
16
16
  - Normal Responses base URL: `https://codexapi.pro/v1`
@@ -19,19 +19,21 @@ there is no supported configuration or API boundary that can solve the issue.
19
19
  - Generated Codex config: `~/.codex/config.toml`
20
20
  - Generated Codex model catalog: `~/.codexclaude/model_catalog.json`
21
21
 
22
- State verified on 2026-06-18: the launcher pins official Codex CLI `0.141.0`. Backend routing currently sends ChatGPT-5.5 traffic through the signed-in Codex account path with `CODEXAPI_GPT55_ROUTE_MODE=codex`. Admin Manage Models can switch cross-model routing to GPT-5.5 via Opus 4.8 or Opus 4.8 via GPT-5.5; this is server routing state and must not collapse the launcher model list or rename customer-selected model ids.
22
+ State verified on 2026-06-25: the launcher pins official Codex CLI `0.142.2`. Backend routing is server-controlled by Admin Manage Models and must not collapse the launcher model list or rename customer-selected model ids.
23
23
 
24
24
  ## Required User-Facing Model Behavior
25
25
 
26
- `codexclaude` supports exactly four visible model choices:
26
+ `codexclaude` supports exactly six visible model choices:
27
27
 
28
28
  - `gpt-5.5` displayed as `ChatGPT-5.5`
29
29
  - `claude-opus-4-8` displayed as `Opus 4.8`
30
+ - `claude-sonnet-4-6` displayed as `Sonnet 4.6`
31
+ - `claude-fable-5` displayed as `Fable 5`
30
32
  - `deepseek-v4-pro` displayed as `Deepseek v4 Budget`
31
33
  - `gemini-3.5-flash` displayed as `Google Gemini Flash 3.5`
32
34
 
33
- The launcher command `codexclaude model` must list only those four options.
34
- The native Codex `/model` picker must also list only those four options. This
35
+ The launcher command `codexclaude model` must list only those six options.
36
+ The native Codex `/model` picker must also list only those six options. This
35
37
  is enforced by writing `model_catalog_json` in `~/.codex/config.toml` and
36
38
  creating a complete Codex-compatible catalog at
37
39
  `~/.codexclaude/model_catalog.json`.
@@ -56,7 +58,7 @@ because the request body model is how CodexAPI.pro snapshots routing and
56
58
  billing before generation starts. The correct fix is to provide valid metadata
57
59
  for `claude-opus-4-8`.
58
60
 
59
- `bin/codexclaude.js` writes a local catalog with full metadata for all four
61
+ `bin/codexclaude.js` writes a local catalog with full metadata for all six
60
62
  supported slugs. Each entry must include, at minimum:
61
63
 
62
64
  - `slug`
@@ -75,7 +77,7 @@ supported slugs. Each entry must include, at minimum:
75
77
  - `input_modalities`
76
78
  - `additional_speed_tiers`
77
79
 
78
- Keep `visibility = "list"` for the four supported entries. Do not include any
80
+ Keep `visibility = "list"` for the six supported entries. Do not include any
79
81
  other list-visible models in this catalog.
80
82
 
81
83
  ## Reasoning Display Versus Server Runtime
@@ -87,19 +89,18 @@ The user-facing Codex UI must show `xhigh` reasoning. The generated
87
89
  model_reasoning_effort = "xhigh"
88
90
  ```
89
91
 
90
- The API server must continue to enforce low reasoning before upstream runtime.
92
+ The API server must continue to enforce the Admin-selected server reasoning before upstream runtime.
91
93
  This is handled in the CodexAPI.pro backend by normalizing Responses requests
92
- to `settings.agent_default_effort`, currently `low`. Do not change the server
94
+ to `settings.agent_default_effort`, currently `high`. Do not change the server
93
95
  setting just because the launcher displays `xhigh`.
94
96
 
95
97
  The launcher keeps both concepts explicit:
96
98
 
97
99
  - `DISPLAY_REASONING_EFFORT = "xhigh"`
98
- - `SERVER_REASONING_EFFORT = "low"`
100
+ - `SERVER_REASONING_EFFORT = "high"`
99
101
 
100
102
  The status output should show `xhigh`. The server effort line in
101
- `codexclaude status` may show `low` for transparency, but normal launch status
102
- must not say `low`.
103
+ `codexclaude status` may show the configured server effort for transparency, but normal launch status must not imply the user-visible model is downgraded.
103
104
 
104
105
  ## Fast Mode Behavior
105
106
 
@@ -141,7 +142,7 @@ terminal_title = ["project-name", "model-with-reasoning", "run-state"]
141
142
  ```
142
143
 
143
144
  The selected model must remain the user's chosen slug. Do not force the local
144
- config model to `gpt-5.5` when Opus, Deepseek, or Gemini is selected. The backend can
145
+ config model to `gpt-5.5` when Opus, Sonnet, Fable, Deepseek, or Gemini is selected. The backend can
145
146
  route any selected model through GPT-5.5 or another upstream internally, but the
146
147
  client request must preserve the user-facing selected slug for display,
147
148
  snapshotting, and billing records.
@@ -150,9 +151,9 @@ snapshotting, and billing records.
150
151
 
151
152
  `gpt-5.5` uses the configured API origin, normally `https://codexapi.pro/v1`.
152
153
 
153
- `claude-opus-4-8` is pinned to `https://api-chicago.codexapi.pro/v1` in the
154
- launcher. This is deliberate for the current Opus route. Do not make Opus
155
- region-aware unless operations explicitly changes the routing policy.
154
+ Claude-family codexclaude models use the CodexAPI.pro Claude-compatible Responses endpoint for CodexAPI.pro and ChatPlus accounts. MyAPI.world accounts keep their own configured `api.myapi.world` Responses endpoint.
155
+
156
+ `claude-fable-5` is a premium customer-visible model. The backend bills it at the configured 5x multiplier and routes it through the Admin-selected Fable 5 route while preserving `claude-fable-5` in client-visible status and usage records.
156
157
 
157
158
  `deepseek-v4-pro` uses the configured API origin. The backend currently routes
158
159
  this through the CodexAPI.pro-compatible path according to the active server
@@ -160,7 +161,7 @@ policy.
160
161
 
161
162
  `gemini-3.5-flash` uses the configured API origin. The backend must keep
162
163
  `gemini-3.5-flash` visible to the user and usage records while routing the
163
- request internally through `claude-sonnet-4-6` at low server effort.
164
+ request internally through `claude-sonnet-4-6` at the configured server effort.
164
165
 
165
166
  The launcher must send these headers for every model:
166
167
 
@@ -203,7 +204,7 @@ If that endpoint fails, fall back to:
203
204
  /api/v1/me
204
205
  ```
205
206
 
206
- Wallet lookup failures must not block a local coding session.
207
+ `codexclaude usage` reads `/api/v1/billing/token-usage` from the same configured account origin. Wallet and usage lookup failures must not block a local coding session.
207
208
 
208
209
  ## Upgrade Checklist
209
210
 
@@ -212,14 +213,14 @@ When upgrading official `@openai/codex`:
212
213
  1. Update `CODEX_VERSION` in `bin/codexclaude.js`.
213
214
  2. Update `package.json` and `package-lock.json` to the same official Codex version.
214
215
  3. Keep the launcher package version higher than the last published version.
215
- 4. Preserve the four-model `MODELS` map and aliases.
216
- 5. Preserve `DISPLAY_REASONING_EFFORT = "xhigh"` and `SERVER_REASONING_EFFORT = "low"`.
216
+ 4. Preserve the six-model `MODELS` map and aliases.
217
+ 5. Preserve `DISPLAY_REASONING_EFFORT = "xhigh"` and keep `SERVER_REASONING_EFFORT` aligned with the server default.
217
218
  6. Preserve `writeModelCatalog()` and the `model_catalog_json` line in generated config.
218
219
  7. Preserve Full Access defaults: `approval_policy = "never"` and `sandbox_mode = "danger-full-access"`.
219
220
  8. Preserve `wire_api = "responses"` and `supports_websockets = false`.
220
221
  9. Preserve bearer username auth with the CodexAPI.pro API username.
221
222
  10. Preserve the `X-CodexAPI-*` headers.
222
- 11. Preserve Opus 4.8 Chicago routing unless operations changes it.
223
+ 11. Preserve Claude-family endpoint routing unless operations changes it.
223
224
  12. Preserve update enforcement through `/api/v1/codexclaude/version` and npm latest metadata.
224
225
  13. Update this file with a new release section explaining what changed.
225
226
  14. Run the validation commands below before publishing.
@@ -270,6 +271,14 @@ python3 -m py_compile app/main.py app/openai_compat.py app/config.py app/postgre
270
271
  /root/codexapi/.venv/bin/pytest -q tests/test_openai_compat.py tests/test_main_helpers.py
271
272
  ```
272
273
 
274
+ ## Version 2.0.13 Changes
275
+
276
+ - Updated the official OpenAI Codex runtime dependency to `@openai/codex@0.142.2`.
277
+ - Added Sonnet 4.6 and Fable 5 as visible launcher and native Codex `/model` choices.
278
+ - Added `codexclaude usage`, which reads wallet and recent token usage from the signed-in account origin, including CodexAPI.pro, ChatPlus, or MyAPI.world compatible endpoints.
279
+ - Kept Fable 5 customer-visible while the backend applies its custom routed premium path and 5x billing multiplier.
280
+ - Preserved Full Access defaults, xhigh visible reasoning, server-managed high runtime effort, wallet auth, and local model catalog metadata.
281
+
273
282
  ## Version 2.0.12 Changes
274
283
 
275
284
  - Updated the official OpenAI Codex runtime dependency to `@openai/codex@0.141.0`.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@codexapi/codexclaude",
3
- "version": "2.0.12",
4
- "description": "CodexAPI.pro coding CLI launcher for ChatGPT-5.5, Opus 4.8, Deepseek v4 Budget, and Google Gemini Flash 3.5, powered by official Codex CLI 0.141.0.",
3
+ "version": "2.0.13",
4
+ "description": "CodexAPI.pro coding CLI launcher for ChatGPT-5.5, Opus 4.8, Sonnet 4.6, Fable 5, Deepseek v4 Budget, and Google Gemini Flash 3.5, powered by official Codex CLI 0.142.2.",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
7
7
  "bin": {
@@ -17,7 +17,7 @@
17
17
  "node": ">=20"
18
18
  },
19
19
  "dependencies": {
20
- "@openai/codex": "0.141.0"
20
+ "@openai/codex": "^0.142.2"
21
21
  },
22
22
  "publishConfig": {
23
23
  "access": "public"