x402-proxy 0.10.6 → 0.10.7

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.10.7] - 2026-04-01
+
+### Added
+- `claude` and `claude --model` shown in default `npx x402-proxy` commands output
+- `claude --help` lists available models and usage examples
+
 ## [0.10.6] - 2026-04-01
 
 ### Fixed
@@ -387,7 +393,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `appendHistory` / `readHistory` / `calcSpend` - JSONL transaction history
 - Re-exports from `@x402/fetch`, `@x402/svm`, `@x402/evm`
 
-[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.6...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.7...HEAD
+[0.10.7]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.6...v0.10.7
 [0.10.6]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.5...v0.10.6
 [0.10.5]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.4...v0.10.5
 [0.10.4]: https://github.com/cascade-protocol/x402-proxy/compare/v0.10.3...v0.10.4

package/dist/bin/cli.js

@@ -1083,18 +1083,36 @@ Examples:
 //#endregion
 //#region src/commands/claude.ts
 const DEFAULT_MODEL = "stepfun/step-3.5-flash";
+const modelList = [
+	"stepfun/step-3.5-flash",
+	"minimax/minimax-m2.5",
+	"minimax/minimax-m2.7",
+	"z-ai/glm-5",
+	"z-ai/glm-5-turbo",
+	"moonshotai/kimi-k2.5"
+].map((id) => `    ${id}`).join("\n");
 function normalizeClaudeArgs(args) {
 	return args[0] === "--" ? args.slice(1) : args;
 }
 const claudeCommand = buildCommand({
 	docs: {
 		brief: "Run Claude Code through a paid local proxy",
-		fullDescription: `Start a local x402-proxy server and launch Claude Code with ANTHROPIC_BASE_URL pointed at it.
+		fullDescription: `Starts a local x402-proxy server and launches Claude Code with
+ANTHROPIC_BASE_URL pointed at it. All inference requests go through
+the proxy, which handles payments automatically via MPP.
 
-Examples:
-  $ x402-proxy claude
-  $ x402-proxy claude --model z-ai/glm-5
-  $ x402-proxy claude -- --print "explain this codebase"`
+Usage:
+  $ x402-proxy claude                           Start with default model
+  $ x402-proxy claude --model z-ai/glm-5        Use a specific model
+  $ x402-proxy claude -- --print "explain this" Pass args to Claude Code
+  $ x402-proxy claude -- -p "summarize *.ts"    Print mode (non-interactive)
+
+Available models (via surf.cascade.fyi):
+${modelList}
+
+The --model value is passed as ANTHROPIC_MODEL and ANTHROPIC_CUSTOM_MODEL_OPTION
+to Claude Code. Any model supported by the upstream endpoint will work, even if
+not listed above.`
 	},
 	parameters: {
 		flags: {
@@ -1453,6 +1471,8 @@ Examples:
 				console.log(pc.dim("  Commands:"));
 				console.log(`    ${pc.cyan("$ npx x402-proxy <url>")}              Fetch a paid API`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy mcp <url>")}          MCP proxy for AI agents`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy claude")}             Run Claude Code via paid proxy`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy claude --model <id>")} Use a specific model`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy setup")}              Reconfigure wallet`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy wallet")}             Addresses and balances`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy wallet history")}     Full payment history`);
@@ -1470,6 +1490,7 @@ Examples:
 				console.log(`    ${pc.cyan("$ npx x402-proxy setup")}              Create a wallet`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy <url>")}              Fetch a paid API`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy mcp <url>")}          MCP proxy for AI agents`);
+				console.log(`    ${pc.cyan("$ npx x402-proxy claude")}             Run Claude Code via paid proxy`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy wallet")}             Addresses and balances`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy wallet history")}     Payment history`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy --help")}             All options`);
@@ -1919,7 +1940,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.10.6"
+				version: "0.10.7"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -1957,7 +1978,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.10.6"
+				version: "0.10.7"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -2052,7 +2073,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.10.6"
+				version: "0.10.7"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -2067,7 +2088,7 @@ Wallet is auto-generated on first run. No env vars needed.`
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.10.6"
+				version: "0.10.7"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -2466,7 +2487,7 @@ const app = buildApplication(buildRouteMap({
 	docs: { brief: "curl for x402 paid APIs" }
 }), {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.10.6" },
+	versionInfo: { currentVersion: "0.10.7" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 //#endregion

package/dist/openclaw/plugin.js

@@ -1159,7 +1159,7 @@ function createWalletCommand(ctx) {
 			if (parts[0]?.toLowerCase() === "send") return { text: "Use `/x_send <amount|all> <address>` for transfers." };
 			try {
 				const snap = await getWalletSnapshot(ctx.rpcUrl, solanaWallet, evmWallet, ctx.historyPath);
-				const lines = [`x402-proxy v0.10.6`];
+				const lines = [`x402-proxy v0.10.7`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**Protocol** - ${ctx.getDefaultRequestProtocol()}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.10.6",
+  "version": "0.10.7",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base, Solana, and Tempo. Also works as an OpenClaw plugin.",
   "type": "module",
   "sideEffects": false,