AIDE 문서
AIDE
사용법
핵심만 담은 짧은 가이드: 첫 실행부터 에이전트용 나만의 명령까지.
시작하기
AIDE is a desktop code editor with an AI studio built in: an agent, a design canvas and a team of twelve roles work in one window. Below is the short path from install to your first edit.
Node.js 20+,Rust, Windows용 Tauri 2 필수 구성 요소를 설치하세요.- 프로젝트 폴더에서
npm install을 실행한 다음npm run tauri dev를 실행하세요. - 코드 폴더 열기: Ctrl+O.
- 설정에서 모델을 연결하세요. API 키는 파일이 아니라 Windows 자격 증명 관리자에 저장됩니다.
- Describe the task in the chat on the right. The agent proposes a plan, asks permission for file writes and commands, and reports what it did together with the token count.
If you just use the installer, Node.js and Rust are not needed — everything is already inside.
Install and updates
The ready-made installer is on this site: the “Download for Windows” button in the Start section. You need Windows 10 or 11 and WebView2 — current builds already have it.
- Building from source.
npm install, thennpm run tauri build. The files land in thebundlefolder next to the project: an NSIS installer and an MSI package. - Updates arrive by themselves. Once a day AIDE compares its version with the latest GitHub release and offers to update. You can also check manually.
- Signature. Update files are checked against a cryptographic signature: the app will not trust a build from an outside source.
- Windows warning. The installer is not signed with a paid publisher certificate, so SmartScreen may ask for confirmation on first launch. It does not affect the editor itself.
- Uninstalling. The usual Windows uninstall. Your projects, settings and keys stay in place — remove them separately if you want to.
Workspace
The project tree is on the left. Files and folders are created, renamed and deleted from the context menu, and changes on disk are picked up right away: an outside edit is never lost.
- Tabs. They keep their cursor position and undo history and close with the middle mouse button. Images, PDFs and fonts open for preview right in the editor.
- Panels. Explorer, project search, Git, snippets and extensions switch in the left panel and stay out of each other's way.
- Text search. Ctrl+Shift+F searches by text, with case and file masks.
- Search by meaning. A query like “parse config file” finds the right places even when the code uses other words: function and path names count separately from plain text.
- Command palette. Ctrl+P — files and actions without the mouse.
Editor and languages
The editor is built on CodeMirror 6: highlighting, line numbers, completion, search and replace, multiple cursors and folding.
- Language servers. Type hints, error squiggles, go to definition and back, rename a symbol and format a file — the same servers VS Code uses.
- Works without a server. If no language server is installed for a language, highlighting, navigation and symbol search remain.
- Git conflicts. Shown as a merge view: accept your side or theirs with a button, no need to edit the file by hand.
- Agent edits. Ctrl+K on selected code — the agent proposes a new version and you accept or reject it by diff.
Chat and models
OpenAI, Anthropic, Google and any compatible server are supported: the address and the model list are set in the provider settings.
- Local models. Ollama or LM Studio on this computer — then requests never leave the machine.
- Keys. Stored in the Windows Credential Manager, separately per provider. A key never reaches the project, the model's reply or a log.
- Tokens. Every answer shows what it cost, so models can be compared by price rather than by feel.
- History. Lives in the project: come back to the folder and the conversation continues where it stopped.
- Attachments. Attach a file or an image to a message and its text joins the model's context.
- Queue. If the agent is still working, a new message waits in the queue; the arrow next to it sends it immediately and stops the current answer.
세 가지 모드
창 상단의 스위치로 인터페이스 전체가 바뀝니다. 프로젝트, 기록, 에이전트는 그대로입니다.
- IDE
- CodeMirror 6 기반 에디터, 파일 트리, 탭 터미널, Git, 검색. 에이전트는 오른쪽 채팅에 있습니다.
- Vibe
- 결과를 말로 설명하세요. 팀 리드가 작업을 단계로 나누고, 역할들이 수행하며, QA가 확인합니다.
- 디자인
- 캔버스에서 목업을 만든 다음 「프로젝트에 생성」을 누르고 스택을 고르세요: HTML, React, Vue, Svelte, Next.js, Astro.
에이전트
- 권한. 파일 쓰기와 터미널 명령 실행은 당신이 「허용」한 뒤에만.
- 보고. 답변 끝에 「완료: 작업 6개 ›」 같은 작업 목록과 사용한 토큰 수가 표시됩니다.
- 되돌리기. 수정 전에 체크포인트가 만들어집니다. 「되돌리기」 버튼으로 바뀐 파일을 복원합니다.
- 중지. 모델에 보낸 요청을 즉시 끊습니다.
- 선택 영역 수정. 코드를 선택하고 Ctrl+K를 누르세요. 변경 사항이 diff로 표시되고 수락하거나 거부할 수 있습니다.
- Clarifications. When a task can be read in different ways, the agent asks first and then works — it does not decide for you.
Terminal and Git
- A real pty. Interactive programs, colours, arrows and Ctrl+C all work. As many terminal tabs as you need.
- Git panel. Changed files, a line-by-line diff, branch and history; commits are made from there too.
- Agent commands. It can run them, but only with your confirmation: you see exactly what is about to run.
Quality checks
- After edits. AIDE runs the project's checks — types, linter, tests — and reports back if something broke.
- Before “done”. The verify-before-done skill requires re-reading the diff, building the project and running the tests.
- Diagnostics. Language server errors show up in the panel immediately, before the project is even run.
- Turning off. Self-checks can be disabled in settings when a project is big and the checks take long.
크루
- 얼굴, 목소리, 스킬을 가진 열두 역할: 팀 리드, 디자인, 프론트, 백엔드, QA, 데브옵스, 분석가, 법무, 회계, 마케터, 인턴, 분위기 메이커. CEO는 당신입니다. 작업을 맡기면 역할들이 논의하고 일을 나눕니다.
- 파일을 바꾸고 명령을 실행할 수 있는 건 「손」이 있는 역할뿐이고, 나머지는 조언하고 검토합니다. 역할의 작업도 에이전트와 같은 권한 절차를 거칩니다.
You are the CEO: you decide what of it makes it into the code.
규칙과 명령
프로젝트 루트에 AGENTS.md 또는 CLAUDE.md를 두면 에이전트가 작업 전에 그 규칙을 읽습니다.
나만의 채팅 명령: 프롬프트를 담은 .aide/commands/이름.md 파일을 만드세요. 채팅에 /이름으로 나타나고, $ARGUMENTS는 명령 뒤에 입력한 내용으로 바뀝니다.
Project rules beat the agent's habits: if a file forbids changing something, the agent asks instead of doing it silently.
Security and data
- Keys. In the Windows Credential Manager. Not in the project, the repository or the logs.
- Permissions. File writes, commands and network access only after confirmation.
- Your code. Stays on disk: AIDE sends it only to the model you chose.
- A local model. Then nothing leaves the computer at all.
- No telemetry. The app collects no usage statistics and sends no hidden reports.
Settings
- Appearance. Interface language, theme, editor font size, panel and terminal behaviour.
- Providers. A fixed model list for servers that cannot list models themselves.
- Skills. Built-in rule sets can be switched on and off: verify before done, careful changes, secure code, debugging, tests, frontend.
- Permissions. What the agent may do without asking and what always needs a confirmation.
단축키
| Ctrl+O | 프로젝트 폴더 열기 |
| Ctrl+S | 파일 저장 |
| Ctrl+W | 탭 닫기 |
| Ctrl+P | 명령 팔레트 |
| Ctrl+R | 최근 프로젝트 |
| Ctrl+B | 사이드바 표시/숨기기 |
| Ctrl+J | 터미널 표시/숨기기 |
| Ctrl+Shift+F | 프로젝트에서 검색 |
| Ctrl+Shift+G | Git 패널 |
| Ctrl+K | 선택한 코드를 에이전트가 수정 |
| Esc | 팔레트, 설정, 수정 닫기 |
Frequently asked questions
- Do I need Node.js and Rust just to use AIDE?
- No. The installer already contains everything the app needs. Node is only needed for checks in your own project, and Rust only if you build AIDE yourself.
- Where does my code go?
- Only to the model you chose. With a local model it goes nowhere.
- Where are API keys stored?
- In the Windows Credential Manager, encrypted, separately for each provider.
- Can I work without internet?
- Yes, with a local model: the editor, terminal and Git always work, and the agent works with the local model.
- What if the agent makes a mistake?
- A checkpoint is taken before edits and Undo restores the files. Permissions stop it from doing anything without your consent.
- Does AIDE run on macOS or Linux?
- The build is for Windows today. The Tauri and React code is portable, but there are no ready builds for other systems.
- How do I update?
- By itself: the app checks for an update and offers to install it. Or download the new installer from this site.
- Why does Windows warn when installing?
- The installer is not signed with a paid publisher certificate — that is a SmartScreen warning, not a virus. Update signatures are verified separately.
When something does not work
- The model does not answer. Check the key and the provider address in settings and your internet access. Error 401 means a wrong key, 429 means a rate limit.
- It will not install. Close the running AIDE and try again.
- Panels disappeared. Ctrl+B and Ctrl+J bring back the side panel and the terminal.
- The terminal is empty. Open a new terminal tab — the old session may have ended.
- No highlighting or hints. A language server may be missing for that language: install it in the system and the editor picks it up.
- Checks fail. Paste the check output into the chat — the agent reads the error and fixes the cause, not the symptom.