Os links para cursos, projetos e vídeos desta página são exclusivos para assinantes do INEMA.PRO.Depois de entrar, volte a esta página.

OSWork
IA como sistema de trabalho

Do zero ao seu ambiente de agentes, comando por comando: terminal no Windows, pasta de projetos, Codex ou Claude Code, GitHub com chave SSH e uma VPS. Quem aprende a navegar no Windows navega na VPS do mesmo jeito.

Comando por comando · copie e cole

OSWork na prática

Faça na ordem, num computador com Windows 10 ou 11. Cada passo mostra o comando e o que você deve ver na tela. Onde aparecer SeuNome ou SEU-USUARIO, troque pelo seu.

Parte 1 — Seu computador

O terminal é só outra janela para as mesmas pastas do Windows. Aqui você vê isso com os próprios olhos.

  1. Passo 1

    Abra o terminal

    Aperte a tecla Windows, digite cmd e aperte Enter.

    Você vê: Uma janela preta com C:\Users\SeuNome> — essa é a sua pasta pessoal.

  2. Passo 2

    Crie a pasta projetos e a do primeiro projeto

    Digite um comando por vez e aperte Enter depois de cada um.

    cd %USERPROFILE%
    mkdir projetos
    cd projetos
    mkdir meu-site
    cd meu-site

    Você vê: C:\Users\SeuNome\projetos\meu-site>

  3. Passo 3

    Veja no Windows onde tudo fica

    Este é o passo mais importante. O comando abaixo abre o Explorador de Arquivos exatamente na pasta em que o terminal está.

    explorer .

    Você vê: A pasta meu-site aberta no Explorador, dentro de projetos. Terminal e Explorador mostram o mesmo lugar: o que você cria num aparece no outro.

  4. Passo 4

    Navegue com 6 comandos

    É tudo o que você precisa para andar pelas pastas. Treine: volte uma pasta, liste e entre de novo.

    dirlista o que tem na pasta
    cd nomeentra na pasta
    cd ..volta uma pasta
    mkdir nomecria uma pasta
    explorer .abre a pasta no Windows
    clslimpa a tela
    cd ..
    dir
    cd meu-site
  5. Passo 5

    Instale Git, GitHub CLI e Node (uma vez)

    O winget já vem no Windows. Depois de instalar, feche o cmd e abra de novo, para ele enxergar os programas novos.

    winget install --id Git.Git -e
    winget install --id GitHub.cli -e
    winget install --id OpenJS.NodeJS.LTS -e

    Você vê: Depois de reabrir: git --version e gh --version mostram um número de versão.

  6. Passo 6

    Instale o agente: Claude Code ou Codex

    Escolha um, ou os dois. Na primeira vez que abrir, entre com a sua assinatura (Claude Pro/Max ou ChatGPT Plus/Pro).

    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    npm install -g @openai/codex

    Você vê: A primeira linha instala o Claude Code; a segunda, o Codex. Em janela nova: claude --version ou codex --version.

  7. Passo 7

    Trabalhe dentro da pasta do projeto

    O agente só enxerga a pasta em que você está. Entre nela e chame o agente (claude ou codex). Peça: “Crie um index.html com uma página simples sobre mim e um arquivo AGENTS.md com as regras deste projeto.” Para sair, digite /exit.

    cd %USERPROFILE%\projetos\meu-site
    claude
    dir
    start index.html

    Você vê: Os arquivos novos aparecem no dir e no Explorador; start abre a página no navegador.

Parte 2 — GitHub: guardar e publicar

O git guarda versões do projeto, o gh conversa com a sua conta do GitHub e a chave SSH é a sua identidade sem senha.

  1. Passo 8

    Diga ao Git quem é você

    Use o mesmo e-mail da sua conta do GitHub.

    git config --global user.name "Seu Nome"
    git config --global user.email "seu@email.com"
  2. Passo 9

    Crie a sua chave SSH

    Aperte Enter nas 3 perguntas. Depois abra a pasta onde a chave ficou.

    ssh-keygen -t ed25519 -C "seu@email.com"
    explorer %USERPROFILE%\.ssh

    Você vê: id_ed25519 é a chave privada: nunca envie a ninguém. id_ed25519.pub é a pública: é ela que você entrega ao GitHub e à VPS.

  3. Passo 10

    Conecte o gh à sua conta e envie a chave

    Responda: GitHub.com → SSH → escolha id_ed25519.pub → Login with a web browser. Depois teste a chave (na primeira vez responda yes).

    gh auth login
    ssh -T git@github.com

    Você vê: Hi SEU-USUARIO! You've successfully authenticated.

  4. Passo 11

    Crie o repositório e envie o projeto

    Público: qualquer pessoa vê. Privado: só você e quem você convidar. Para privado, troque --public por --private.

    cd %USERPROFILE%\projetos\meu-site
    git init
    git add .
    git commit -m "primeira versão"
    git branch -M main
    gh repo create meu-site --public --source=. --push

    Você vê: O endereço github.com/SEU-USUARIO/meu-site com os seus arquivos.

  5. Passo 12

    Publique a página no GitHub Pages

    Grátis em repositório público. Também dá pelo site: Settings → Pages → branch main.

    gh api repos/{owner}/{repo}/pages -X POST -f "source[branch]=main" -f "source[path]=/"

    Você vê: Em 1 ou 2 minutos a página abre em https://SEU-USUARIO.github.io/meu-site/

  6. Passo 13

    A rotina de todo dia

    Mudou algo? Salve uma versão e envie. Ou peça ao agente: “salve e envie para o GitHub”.

    git add .
    git commit -m "o que mudou"
    git push

Parte 3 — VPS: o mesmo, num servidor

Uma VPS é um computador Linux ligado 24 horas. Você entra nele pelo mesmo terminal e navega do mesmo jeito; só alguns nomes mudam.

  1. Passo 14

    Contrate a VPS com a sua chave

    Escolha Ubuntu. Na criação, o provedor pede uma chave SSH: cole o texto que este comando mostra.

    type %USERPROFILE%\.ssh\id_ed25519.pub

    Você vê: Uma linha começando com ssh-ed25519. Copie a linha inteira.

  2. Passo 15

    Entre na VPS

    Troque IP-DA-VPS pelo número que o provedor mostrou. Na primeira vez responda yes. Para sair, digite exit.

    ssh root@IP-DA-VPS

    Você vê: root@nome-da-vps:~# — agora o terminal é o servidor.

  3. Passo 16

    Mesma navegação, outros nomes

    Na VPS não há Explorador: o ls faz esse papel.

    dirls
    cd nome / cd ..cd nome / cd ..
    mkdir nomemkdir nome
    clsclear
    type arquivocat arquivo
    %USERPROFILE%~
    mkdir -p ~/projetos
    cd ~/projetos
    ls
  4. Passo 17

    Traga o projeto e instale o agente

    Repositório público clona direto. Se for privado, instale o gh (apt install -y gh) e rode gh auth login, como no Windows.

    apt update && apt install -y git
    git clone https://github.com/SEU-USUARIO/meu-site.git
    cd meu-site
    ls
    curl -fsSL https://claude.ai/install.sh | bash

    Você vê: Os mesmos arquivos do seu Windows, agora na VPS. Rode claude dentro da pasta, como no passo 7.

Parte 4 — Quando quiser ligar outros sistemas

VercelImporta o repositório do GitHub e publica o site sozinho a cada git push, com domínio próprio. Bom para sites e apps que vão crescer.
SupabaseBanco de dados, login de usuários e arquivos para o seu app. O agente escreve a integração; você guarda as chaves fora do repositório.

Quer aprofundar? Escolha o curso

O passo a passo acima é o caminho. Os cursos explicam cada parte com calma.

Todas as edições ↓

Escolha sua edição do OSWork

Dois caminhos para organizar seu trabalho com IA. Escolha pela sua experiência e pelo tempo disponível. As edições anteriores estão no fim da página.

OSWork v6.2 — percurso completo, passo a passo

O percurso completo do v2 refeito para quem está começando: oito módulos e 49 aulas de uns 15 minutos. Do chat ao terminal e Codex, pastas, Skills, Git, bot no Telegram e VPS, com passo a passo visual e um glossário dos termos técnicos.

OSWork Quick — na prática

Os 25 passos desta página como curso: cmd e pastas no Windows, Explorador, Claude Code ou Codex, Git com gh e chave SSH, GitHub Pages e VPS. Quatro partes, com progresso, notas e cola de comandos.

O passo a passo em vídeo, com Nei

Os 17 passos desta página feitos comando por comando, copiando e colando: do terminal vazio no Windows ao site publicado no GitHub Pages e ao mesmo projeto rodando numa VPS, com o agente trabalhando dentro da pasta. Avatar e voz do Nei, 8 minutos, legendas SRT.

Vídeos da edição anterior do Quick

A primeira edição do Quick (organização do trabalho com IA, sem terminal) em sete aulas, com avatar e voz do Nei, ilustrações e legendas SRT.

Avançado

O percurso técnico v2, módulo por módulo

Abra os módulos para conhecer os seis tópicos de cada aula. Os links levam diretamente ao curso no idioma desta página.

Módulo 1 — Modelos: escolha pela tarefa

Comparar modelos com uma tarefa real e um critério de qualidade.

  1. IA como sistema de trabalho
  2. Tipos de IA e para que servem
  3. Modelo não é esforço de raciocínio
  4. Crie uma régua de qualidade
  5. Entenda acesso e cobrança
  6. Delimite a autonomia
Abrir o módulo completo
Módulo 2 — Chat, Work e Desktop

Redigir uma encomenda de trabalho com entradas, saída e revisão.

  1. Chat resolve uma conversa
  2. Work recebe uma encomenda
  3. Desktop aproxima os arquivos
  4. Local e nuvem são escolhas de execução
  5. Escreva um contrato de entrega
  6. Revise o trabalho recebido
Abrir o módulo completo
Módulo 3 — Terminal e Codex na prática

Abrir um projeto de treino no Codex e produzir uma alteração verificável.

  1. Terminal é uma porta de entrada
  2. Instale pela fonte oficial
  3. Autentique sem espalhar segredos
  4. Entre na pasta antes de pedir
  5. Faça uma primeira tarefa de leitura
  6. Use permissões e recuperação
Abrir o módulo completo
Módulo 4 — Pastas, Markdown e segredos

Montar a casa digital e separar conhecimento de credenciais.

  1. Uma pasta representa um contexto
  2. Markdown é texto organizado
  3. Cada arquivo tem um trabalho
  4. Segredos não são conhecimento compartilhável
  5. Ignore antes do primeiro commit
  6. Faça uma limpeza de contexto
Abrir o módulo completo
Módulo 5 — AGENTS, Skills e memória

Criar instruções de projeto e uma capacidade reutilizável com critério de revisão.

  1. AGENTS.md orienta a execução
  2. Global e projeto se complementam
  3. Skills empacotam procedimentos
  4. Memória precisa de manutenção
  5. Falhas viram proteções pequenas
  6. Teste a capacidade reutilizável
Abrir o módulo completo
Módulo 6 — Git e GitHub sem perder trabalho

Salvar uma versão, inspecionar diferenças e recuperar uma mudança de treino.

  1. Git é o histórico do projeto
  2. Observe antes de preparar
  3. Salve uma versão com intenção
  4. Clone e atualize com cuidado
  5. Recupere sem apagar o histórico
  6. Publique só o que revisou
Abrir o módulo completo
Módulo 7 — Telegram como interface de trabalho

Executar um bot restrito de consulta e entender onde a IA entra.

  1. Telegram é a interface, não o agente
  2. Crie o bot e proteja o token
  3. Autorize pessoas e ações
  4. Comece com long polling
  5. Conecte capacidades em etapas
  6. Teste operação e falhas
Abrir o módulo completo
Módulo 8 — VPS do zero e operação 24/7

Preparar um plano de implantação, supervisão, backup e verificação do serviço.

  1. Uma VPS é uma máquina sob sua responsabilidade
  2. Entre por SSH e preserve acesso
  3. Instale só o necessário
  4. Proteja a rede e as credenciais
  5. Systemd supervisiona o processo
  6. Disponibilidade exige rotina de cuidado
Abrir o módulo completo

Avançado

Kit do percurso técnico

O kit reúne modelos de AGENTS.md, memória, decisões, registro de falhas, contrato de tarefa, Skill de relatório e plano de VPS. Inclui um bot Python com autoteste offline.

O bot de treino é determinístico: não chama um modelo de IA nem executa mensagens como comandos. A integração com IA é explicada como uma etapa posterior.

Versões anteriores

O OSWork v6.2 refez o percurso completo do v2 para quem está começando. As edições anteriores continuam abertas para quem já começou por elas.

Versão anterior · PT · EN · ES

OSWork v2 — percurso técnico

Oito módulos, quatro trilhas e 48 tópicos. Do chat ao terminal e Codex, arquivos, Skills, Git, bot no Telegram e operação supervisionada em VPS. Inclui kit de prática.

Versão anterior · PT · EN · ES

OSWork v6 — iniciantes, visual

Para quem está começando: sete aulas de uns 15 minutos com telas de chat simuladas, antes e depois reais e passo a passo visual. Você monta pastas por assunto, uma ficha com as suas regras, um molde de pedido e uma rotina de conferência, sem instalar nada.

Versão anterior · PT · EN · ES

OSWork v5 — para iniciantes

Para profissionais 40+ com pouca familiaridade com IA. Sete aulas de 20 a 25 minutos para organizar pastas, orientações, pedidos reutilizáveis e uma rotina de conferência, sem programação.