XuanShu API
TRAE SOLO Setup Guide
Add custom models to TRAE SOLO and connect to XuanShu API Claude or Codex channels. All configuration happens in the graphical interface without the command line.
1. Get your API Key
2. Open the custom model settings
- Open TRAE SOLO's settings.
- Go to the Models page.
- Click "Add Model".
- Select "Custom Configuration".
3. Fill in the configuration by channel
The two channels use different base URLs: the Claude channel uses the root address, while the Codex channel must include /v1. Using the wrong URL will cause an immediate connection error. Models change over time; check /available-channels for the current list.
4. Verify success
After saving, select the new model in TRAE SOLO and send a message. You should get a response. At the same time, open /usage and confirm you see a successful API call for that model. Both checks passing means you're connected.
5. Troubleshooting
| Symptom | Check | Fix |
|---|---|---|
| Connection fails / 404 | Claude channel URLs must not include /v1; Codex channel URLs must include /v1. | Correct the Base URL and save again. |
| 401 / 403 | Make sure you copied the full Key without truncation and it hasn't expired. | Go to /keys and copy or create a new Key. |
| Model unavailable | The model ID must exactly match the ID shown in /available-channels. | Switch to a current model for the same protocol. |
| 429 (rate limited) | Check your balance, Key limits, and concurrency in /usage. | Lower concurrency and wait for the rate limit window to reset. |