AI Workspace
Use Codex, Claude Code ou VS Code em seu dispositivo local para executar comandos e editar arquivos de projeto em um dispositivo remoto. FlashDesk cuida da configuração da conexão para você.
Conteúdo
Visão geral
AI Workspace é um espaço de trabalho FlashDesk para usar ferramentas de IA locais em um dispositivo remoto. A ferramenta AI é executada no dispositivo do operador, enquanto os comandos para o dispositivo remoto são executados através do SSH quando necessário.
Uso básico
Habilite AI Workspace no dispositivo remoto
No dispositivo remoto, habilite a permissão de conexão AI Workspace e SSH nas configurações FlashDesk.
Abra AI Workspace no dispositivo da operadora
Selecione o dispositivo de destino e abra AI Workspace. FlashDesk cria uma pasta de espaço de trabalho local, gera arquivos auxiliares SSH e troca automaticamente uma chave SSH temporária com o dispositivo remoto.
Escolha como trabalhar
Escolha o comando SSH para tarefas únicas diretas ou escolha a edição do projeto quando desejar criar um Local Mirror e editar arquivos localmente.
Abra uma ferramenta de IA
Abra Codex ou Claude Code na janela AI Workspace. FlashDesk grava o arquivo de instruções da ferramenta selecionada na área de trabalho.
Execute comandos ou edite arquivos
Para o trabalho do comando SSH, peça à ferramenta AI para executar comandos remotos por meio do auxiliar gerado. Para edição do projeto, edite os arquivos Local Mirror e depois retorne ao FlashDesk para revisar e aplicar a comparação.
O que você pode fazer
- Abra Codex, Claude Code, VS Code ou a pasta do espaço de trabalho de FlashDesk.
- Execute comandos no dispositivo remoto através do SSH.
- Crie um Local Mirror de um projeto remoto selecionado e edite-o localmente.
- Revise as alterações do Local Mirror antes de aplicá-las de volta ao dispositivo remoto.
- Deixe Custom instructions por dispositivo remoto que é mesclado automaticamente nos arquivos de instruções da ferramenta AI.
Como funciona
| Item | Descrição |
|---|---|
AI Workspace |
Um diretório de trabalho local criado para uma conexão FlashDesk. |
.flashdesk-workspace/ssh_config |
Configuração SSH e scripts auxiliares gerados por FlashDesk para o dispositivo remoto selecionado. As ferramentas de IA devem usar os comandos auxiliares em vez de editar esses arquivos diretamente. |
.flashdesk-workspace/identity |
Identidade SSH temporária gerada por FlashDesk para o AI Workspace atual. FlashDesk registra-o automaticamente no dispositivo remoto e remove-o quando AI Workspace fecha. |
AGENTS.md / CLAUDE.md |
Arquivos de instruções gerados quando a ferramenta de IA correspondente é aberta. FlashDesk também adapta seu conteúdo ao Host OS detectado (Windows vs POSIX) e os regenera quando Custom instructions é atualizado. |
| Local Mirror | Uma cópia local de um projeto remoto selecionado. O usuário pode revisar as alterações antes de aplicá-las novamente ao dispositivo remoto. |
Modos de espaço de trabalho
Comando SSH funciona
Use este modo para trabalho direto e único no dispositivo remoto, como verificar logs, listar arquivos, reiniciar um serviço ou fazer uma pequena alteração confirmada.
Edição de projetos com Local Mirror
Use este modo quando quiser editar um projeto remoto localmente. FlashDesk clona o arquivo ou pasta remota selecionada em Local Mirror. Após a edição, revise a comparação em FlashDesk e aplique apenas as alterações selecionadas de volta ao dispositivo remoto.
Custom instructions
Custom instructions permite que você deixe notas permanentes que a ferramenta de IA deve seguir neste espaço de trabalho – convenções de codificação, o gerenciador de pacotes a ser usado, ramificações para evitar toque, regras de aprovação, qualquer coisa que você normalmente repetiria no início de cada sessão.
- Abra a partir do botão Custom instructions próximo a Abra a pasta na janela AI Workspace.
- Salvo por dispositivo remoto, para que cada projeto possa ter suas próprias notas permanentes.
- Mesclado em
AGENTS.md/CLAUDE.mdem uma seçãoCustom instructions (sempre siga), então Codex e Claude Code os selecionam automaticamente. Os arquivos de instruções existentes são reescritos sempre que você salva.
Notas operacionais
- AI Workspace está desativado por padrão e deve ser permitido no dispositivo remoto.
- O dispositivo remoto também deve permitir conexões SSH.
- Pergunte ao usuário do dispositivo remoto antes de usar SSH para criar, substituir, mover ou excluir arquivos no dispositivo remoto.
- Ao usar Local Mirror, aplique alterações ao dispositivo remoto somente depois que o usuário confirmar a diferença em FlashDesk.
- Arquivos grandes podem tornar a criação do Local Mirror mais lenta. FlashDesk pode perguntar se deseja incluir ou ignorar arquivos grandes.