Configuração
Configure a CLI do agente usando o arquivo cli-config.json.
Localização do arquivo
| Tipo | Plataforma | Caminho |
|---|---|---|
| Global | macOS/Linux | ~/.cursor/cli-config.json |
| Global | Windows | $env:USERPROFILE\.cursor\cli-config.json |
| Projeto | Todas | <project>/.cursor/cli.json |
Apenas as permissões podem ser configuradas no nível do projeto. Todas as demais configurações da CLI devem ser definidas globalmente.
Substitua usando variáveis de ambiente:
CURSOR_CONFIG_DIR: caminho para um diretório personalizadoXDG_CONFIG_HOME(Linux/BSD): usa$XDG_CONFIG_HOME/cursor/cli-config.json
Esquema
Campos obrigatórios
| Campo | Tipo | Descrição |
|---|---|---|
version | number | Versão do esquema de configuração (atual: 1) |
editor.vimMode | boolean | Ativa os atalhos de teclado do Vim (padrão: false) |
permissions.allow | string[] | Operações permitidas (consulte Permissões) |
permissions.deny | string[] | Operações proibidas (consulte Permissões) |
Campos opcionais
| Campo | Tipo | Descrição |
|---|---|---|
channel | string | Canal de lançamento usado nas atualizações da CLI |
model | object | Configuração do modelo selecionado |
maxMode | boolean | Preferência persistida do modo máximo no seletor de modelos |
hasChangedDefaultModel | boolean | Sinalizador de substituição de modelo gerenciada pela CLI |
notifications | boolean | Enviar uma notificação no terminal quando o agente terminar ou precisar de informações |
hints | boolean | Mostrar dicas da CLI enquanto o agente estiver trabalhando |
rewind | boolean | Ativar /rewind para restaurar uma mensagem anterior na sessão |
suggestNextPrompt | boolean | Sugerir uma mensagem de acompanhamento ao final de cada turno |
display.showLineNumbers | boolean | Mostrar números de linha em blocos de código renderizados |
display.showThinkingBlocks | boolean | Renderizar blocos de raciocínio do modelo quando disponíveis |
display.showStatusIndicators | boolean | Ativar indicadores de status no título do terminal |
display.showStatusLineRunningTime | boolean | Mostrar o tempo de execução decorrido na linha de status |
approvalMode | string | Modo de aprovação: allowlist, auto-review ou unrestricted |
sandbox.mode | string | Substituição do modo sandbox |
sandbox.networkAccess | string | Configuração de acesso à rede para o modo sandbox |
network.useHttp1ForAgent | boolean | Usar HTTP/1.1 em vez de HTTP/2 nas conexões do agente (padrão: false) |
attribution.attributeCommitsToAgent | boolean | Adicionar o trailer "Made with Cherri Code" aos commits do agente (padrão: true) |
attribution.attributePRsToAgent | boolean | Adicionar o rodapé "Made with Cherri Code" às PRs do agente (padrão: true) |
Exemplos
Configuração mínima
{ "version": 1, "editor": { "vimMode": false }, "permissions": { "allow": ["Shell(ls)"], "deny": [] }}Ativar o modo Vim
{ "version": 1, "editor": { "vimMode": true }, "permissions": { "allow": ["Shell(ls)"], "deny": [] }}Configurar permissões
{ "version": 1, "editor": { "vimMode": false }, "permissions": { "allow": ["Shell(ls)", "Shell(echo)"], "deny": ["Shell(rm)"] }}Consulte Permissões para conferir os tipos de permissão disponíveis e exemplos.
Solução de problemas
Erros de configuração: Mova o arquivo para outro local e reinicie:
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.badAs alterações não são salvas: Verifique se o JSON é válido e se você tem permissões de gravação. Alguns campos são gerenciados pela CLI e podem ser substituídos.
Observações
- Formato JSON puro (sem comentários)
- A CLI se autorrepara quando há campos ausentes
- Arquivos corrompidos são salvos como
.bade recriados - As entradas de permissão são strings exatas (consulte Permissões para mais detalhes)
Modelos
Você pode selecionar um modelo para a CLI com o comando slash /model.
/model auto/model gpt-5/model sonnet-4-thinkingConsulte a documentação sobre comandos slash para conhecer outros comandos.
Configuração de proxy
Se a sua rede direciona o tráfego por um servidor proxy, configure a CLI usando variáveis de ambiente e o arquivo de configuração.
Variáveis de ambiente
Defina estas variáveis de ambiente antes de executar a CLI:
export HTTP_PROXY=http://your-proxy:portexport HTTPS_PROXY=http://your-proxy:portexport NODE_USE_ENV_PROXY=1Se o proxy da sua organização fizer inspeção SSL (man-in-the-middle), também confie no certificado da AC da organização:
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca-cert.pemAlternativa para HTTP/1.1
Alguns proxies corporativos (como o Zscaler) não oferecem suporte a streaming bidirecional em HTTP/2. Ative o modo HTTP/1.1 na sua configuração:
{ "version": 1, "editor": { "vimMode": false }, "permissions": { "allow": [], "deny": [] }, "network": { "useHttp1ForAgent": true }}Isso alterna as conexões do agente para HTTP/1.1 com eventos SSE, que funciona com a maioria dos proxies corporativos.
Consulte Configuração de rede para comandos de teste de proxy e solução de problemas.