(5) Configurar Clientes
A esta altura você já deve ter: feito o cadastro → adicionado crédito → criado uma chave de API com o grupo certo → confirmado que seu ambiente Node.js funciona. Agora vamos conectar seu cliente / CLI à Tianshu.
Endpoint (rota)
A Tianshu oferece duas rotas:
| Rota | Endereço | Para |
|---|---|---|
| Rota padrão | https://tian-shu.org | A grande maioria dos casos; estável e confiável |
| Rota direta | https://api.tian-shu.org | Requisições de longa duração como geração de imagens, contornando timeouts do gateway |
Endpoints compatíveis com OpenAI precisam de /v1
Se você usa um cliente / ferramenta compatível com OpenAI (Codex, o SDK da OpenAI, a configuração compatível com OpenAI do Cherry Studio, etc.), acrescente /v1 ao endereço: https://tian-shu.org/v1. Para configurações dedicadas, como a do Claude Code, siga o exemplo no guia correspondente.
Recomendado: configuração com um clique usando o CC-Switch
Para tornar a configuração o mais fácil possível, recomendamos a ferramenta open-source CC-Switch, que gerencia graficamente as configurações de conexão do Claude Code e do Codex, poupando você de editar arquivos manualmente:
- CC-Switch · Passos Comuns (Instalação)
- CC-Switch · Configuração do Claude Code
- CC-Switch · Configuração do Codex
Usuários avançados: configure a CLI manualmente
Se você preferir editar os arquivos de configuração por conta própria, siga os guias manuais:
- Instalar a CLI (Verificação de Ambiente)
- Configuração Manual do Claude Code
- Configuração Manual do Codex
- Proxy de Otimização de Cache do Claude Code (avançado; economiza crédito)
Clientes gráficos / seus próprios programas
- Para clientes gráficos, veja Clientes de Terceiros.
- Para escrever seu próprio código, veja os exemplos em Python / Node.js em Início Rápido.
Qualquer que seja o método usado
Conclua os passos anteriores primeiro — garanta que o grupo do token está correto e que tanto o Node.js quanto a CLI relevante funcionam corretamente — antes de iniciar a configuração.