Start by checking where your free Token came from.
| Token source | Recommended usage |
|---|
| Token won from Free Lottery | Import it into CCSwitch first, then connect it to Codex |
| Token claimed from Free API Keys | Manage it in CCSwitch, then connect it to Codex or Claude Code |
| Xiaomi MiMo shared Token | Follow Xiaomi’s official integration documentation first |
An API Key is equivalent to account credentials. Do not post the full key in groups, issues, screenshots, or public documents. Mask the middle part before sharing screenshots.
- Open Free Lottery and sign in.
- Go to your lottery records.
- Open a winning record detail page.
- Copy the API URL and API Key.
The detail page is personal and may show your real API Key, so this documentation does not include a real screenshot of that page.
Use CCSwitch
CCSwitch is a local desktop tool for managing providers for Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes, and similar tools.
Basic flow:
- Copy the API URL and API Key from hvoy.
- Open CCSwitch.
- Select the app you want to connect, such as Codex or Claude Code.
- Add a provider from the top-right
+ button.
- Use a preset if one exists; otherwise create a custom provider.
- Fill in the API URL, API Key, and model name.
- Add the provider, then enable it.
Codex usually needs a terminal restart or app restart after switching providers. If Claude Code hot switching does not take effect, close and reopen it as well.
Direct Codex Configuration
If you do not use CCSwitch, you can write the API URL and API Key directly into Codex configuration.
~/.codex/auth.json:
{
"OPENAI_API_KEY": "paste your API Key here"
}
~/.codex/config.toml:
model = "your-model-name"
[model_providers.custom]
name = "custom"
base_url = "paste your API URL here"
wire_api = "chat"
External Links
