Visão geral das ferramentas de CLI
CLI é uma ferramenta de linha de comando, não um software específico. Claude Code, Codex CLI, Gemini CLI, OpenClaw e OpenCode pertencem todos a esta categoria: você digita linguagem natural no terminal e eles podem ler projetos, interpretar código, gerar arquivos, executar comandos ou ajudar você a concluir tarefas de desenvolvimento.
O que é CLI e para que serve
As ferramentas de CLI são mais poderosas do que os softwares de chat comuns e também são mais fáceis de usar incorretamente. Quando iniciantes forem configurá-las pela primeira vez, execute-as apenas em projetos de teste e faça com que elas "apenas interpretem, não modifiquem e não executem comandos".
O que preparar primeiro
| Itens de preparação | Descrição | Por que é importante |
|---|---|---|
| Terminal | O Windows usa o PowerShell, o macOS / Linux usa o Terminal | A CLI roda inteiramente no terminal |
| A ferramenta em si | Primeiro instale o Claude Code, Codex CLI, Gemini CLI, OpenClaw ou OpenCode | O arquivo de configuração só tem efeito para ferramentas instaladas |
| Chave / Método de login | Pode ser um login oficial, API Key, OAuth ou a chave de um provedor de IA | Diferentes CLIs têm métodos de autenticação diferentes |
| Base URL | Necessário apenas ao passar por um provedor de IA ou proxy | O sufixo do endereço pode variar conforme os diferentes protocolos, então você não pode apenas mudar o nome de domínio. |
| Projeto de teste | Crie uma nova pasta vazia ou copie o projeto. | Evite bagunçar um projeto real durante a primeira configuração |
Acesso às páginas individuais
Como escolher qual página visualizar
| O que você quer fazer agora | Recomendado abrir | Por que |
|---|---|---|
| Apenas quer alternar uniformemente entre múltiplos provedores de CLI | Passos gerais do CC-Switch | O CC-Switch é mais adequado para gerenciamento centralizado de provedores, distribuindo depois para ferramentas como Claude, Codex, Gemini, etc. |
| Apenas configurar o Claude Code | Configuração do Claude Code | Para o Claude Code, concentre-se na chave relacionada à Anthropic / Claude, Base URL, nome do modelo e settings.json |
| Apenas configurar o Codex CLI | Configuração do Codex | Para o Codex, concentre-se no config.toml, provedores compatíveis com OpenAI, nome do modelo e variáveis de ambiente |
| Apenas configurar o Gemini CLI | Configuração do Gemini | O método de login, a chave e as interfaces Vertex / Gemini do Gemini são diferentes das interfaces compatíveis com OpenAI |
| Usar o OpenClaw / OpenCode | OpenClaw / OpenCode | O campo de provedor dessas duas ferramentas pode mudar entre versões; você deve consultar a página correspondente e a documentação oficial |
Riscos a serem observados antes da configuração
| Riscos | Onde costumam ocorrer | Recomendações |
|---|---|---|
| As ferramentas podem ler arquivos de projeto | Claude Code, Codex, Gemini, OpenClaw, OpenCode | Execute no diretório de teste na primeira vez; não abra diretamente projetos de produção reais |
| Os modelos podem executar ou sugerir comandos | Todas as CLIs de código | Ative o modo de confirmação primeiro e verifique cada ação cuidadosamente ao encontrar comandos de excluir, mover, instalar, fazer upload, etc. |
| Itens de configuração se sobrescrevem | Variáveis de ambiente do sistema, configuração do projeto, configuração do usuário, CC-Switch | Quando a configuração não surtir efeito, verifique primeiro a prioridade; não modifique vários locais ao mesmo tempo |
| Uso misto de protocolos | Interfaces compatíveis com OpenAI, Claude, Gemini, Vertex e provedores de IA | Preencha a página da ferramenta de acordo com a interface que o painel do provedor oferece |
| Copiar o exemplo de outra pessoa | Tutoriais de terceiros, capturas de tela, documentos antigos | A URL, a chave e o nome do modelo no exemplo devem ser substituídos pelo conteúdo do painel do seu próprio provedor |
Como fazer o primeiro teste de segurança
Depois que a configuração estiver concluída, não deixe imediatamente a CLI modificar o projeto real. Primeiro, crie um diretório vazio, coloque um arquivo de teste simples nele e permita que a ferramenta apenas leia e interprete, sem modificar o arquivo.
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.Se esta etapa não retornar normalmente, vá para a página correspondente de solução de problemas. Não permita que a CLI processe automaticamente o projeto real antes de confirmar que a configuração foi bem-sucedida.