Agent / Harness integrations
Connect NekoCloud to coding agents, editor extensions and personal assistants. These guides adapt official custom-provider documentation; configuration guidance is not proof that every model or full tool chain works on NekoCloud. No local conversion proxy is required by default, and an API key is not an official subscription login.
Before starting
Create your own key, check balance, group access and model protocol. Replace every REPLACE_WITH_MODEL_ID. A provider prefix is usually a local route name, not part of the upstream model ID. Install through trusted official packages.
Choose a tool
| Agent / Harness | Configuration focus |
|---|---|
| Claude Code | Anthropic Messages |
| Codex / VS Code / Codex++ | Responses |
| OpenCode | Chat / Responses |
| Factory Droid | BYOK |
| Aider | Chat Completions |
| Goose | Custom provider |
| Pi coding agent | models.json |
| Gemini CLI | 版本限制 / Version dependent |
| Cline | OpenAI Compatible |
| Roo Code | Native tools |
| Kilo Code | Custom provider |
| Continue | YAML |
| Hermes Agent | Custom endpoint |
| OpenClaw | Custom provider |
| CC Switch / CLI / ccman | 配置管理 / Config managers |
| Cursor / Windsurf | 接入边界 / Limitations |
Protocol and endpoint
| Protocol | Typical base URL | Note |
|---|---|---|
| Chat Completions | https://api.nekocloud.vip/v1 | Use a compatible model |
| Responses | https://api.nekocloud.vip/v1 | Not interchangeable with Chat Completions |
| Anthropic Messages | https://api.nekocloud.vip | Claude Code uses the domain root; check other SDKs' version handling |
| Native Gemini | https://api.nekocloud.vip/v1beta | Verify custom endpoint and version suffix behavior |
OpenAI-compatible does not guarantee tools, streaming, reasoning parameters or images. Verify a short message, a read-only non-sensitive file tool round trip, and Usage. Avoid unlimited retries.
See chat applications and API basics. Each guide links its official sources. New API's app collection informs the structure; agent documentation takes priority for actual fields. Version changes may affect UI and configuration; do not replace whole files when an option is missing.