FAQ

Account and Keys

1. Are invoices supported?

Yes. Chinese general VAT invoices and special VAT invoices are supported. After actual consumption reaches 500 RMB, you can request an invoice.

2. What should I do if the key is invalid or authentication fails?

• Check whether extra spaces were copied
• Check whether the key is expired or disabled
• Check whether the request uses the correct header or parameter
• Confirm that you are using the dedicated token group for the tool

3. How do I view balance and usage records?

Sign in to the console to view:

• Current balance
• Top-up records
• Usage details
• Billing details

Website Access

Why does the website show a blank screen?

This is likely caused by an ad-blocking extension. Add our domain to the allowlist.

Common ad blockers:

• AdBlock
• uBlock Origin
• AdGuard

Solution:

1. Open extension settings
2. Add xiaomai.win to the allowlist
3. Refresh the page

Environment and Installation

npm install is slow or fails

You can use a mirror registry:

# Set Taobao mirror
npm config set registry https://registry.npmmirror.com

# Verify configuration
npm config get registry

Node.js version is too old

Claude Code, CodeX, and Gemini CLI all require Node.js 18+.

Upgrade methods:

• Windows: download and install the latest version again
• macOS: brew upgrade node
• Linux: use nvm or the NodeSource repository

Environment variables do not take effect

• Windows: restart the terminal or computer
• macOS/Linux: run source ~/.bashrc or source ~/.zshrc

Tool Usage

CC-Switch cannot start

1. Check for permission issues
2. Try running as administrator
3. Check whether antivirus software blocked it
4. Download and reinstall the latest version

Claude Code connection failed

Check:

• Network connectivity
• API key correctness
• Environment variable settings
• Account balance

Are CodeX and Claude Code tokens interchangeable?

No. Different tools require different token groups:

• Claude Code: Claude Code token group
• CodeX: codex测试 token group
• Gemini CLI: Gemini token group

Create the corresponding dedicated token on the Xiaomai API platform.

Billing

How is billing calculated?

• Billed by actual usage
• Different models have different prices
• See the console for detailed pricing rules

What happens if balance is insufficient?

• Service is paused
• Top up to continue using it
• Service resumes immediately after top-up

Are refunds supported?

• A refund request can be submitted for unused balance
• Used balance is not refundable
• Contact support for the specific review policy

Technical Questions

Is my code stored?

No. We do not store your code content. Requests and responses are only forwarded.

Is enterprise usage supported?

Yes. Enterprise users can:

• Contact support for enterprise solutions
• Use large top-ups and invoice issuance support
• Potentially receive preferential pricing

How do I get technical support?

See Pre-Sales & Support for contact methods.

More Questions

Technical difficulties

If you encounter startup failures, errors, timeouts, or similar problems, read:

Troubleshooting Guide - detailed error diagnosis and solutions

Still Not Solved?

If the above does not answer your question:

• Join the WeChat group for support
• View Pre-Sales & Support