Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
oxi는 Claude Code, Codex, Cursor 등 여러 AI 코딩 도구를 하나의 대화 환경에서 통합하여 사용할 수 있게 해주는 툴입니다. 에이전트를 전환해도 컨텍스트가 유지되며, 자체 기기에서 오픈 모델을 실행할 수 있는 것이 특징입니다. Rust 바이너리로 제작되어 가볍고 별도의 계정이나 Electron 설치가 필요 없습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기macOS (Apple Silicon) 및 Linux (x86_64):
curl -fsSL https://maziluiosif.github.io/oxi/install.sh | sh
Windows (x86_64), PowerShell에서:
imr https://maziluiosif.github.io/oxi/install.ps1 | iex
프로젝트 폴더 내에서 oxi를 실행하거나 앱 메뉴에서 열 수 있습니다. 업데이트하려면 oxi update를 실행하거나 동일한 명령을 다시 실행하세요.
Sublime Text가 설치되어 있다면, 같은 명령으로 oxi의 Sublime Text 패키지도 추가됩니다.
<details> <summary>Homebrew, 수동 다운로드, 설치 옵션</summary>brew tap maziluiosif/tap
brew install --cask oxi
xattr -cr /Applications/oxi.app # macOS 전용, 설치 후 한 번 실행
Releases에서 사용하려는 플랫폼의 아카이브를 받아 압축을 풀고, macOS에서는 oxi.app을 /Applications으로 이동한 다음, 앱이 Apple에 의해 공증되지 않았기 때문에 xattr -cr /Applications/oxi.app을 한 번 실행해야 합니다. Windows에서는 처음 사용할 때 자세히 → 그래도 실행을 클릭하세요.
| 변수 | 효과 |
|---|---|
OXI_VERSION | 특정 릴리스 설치, 예: v1.8.0 |
| ... |
Rust 1.92+ (rustup)와 C/C++ 빌드 도구가 필요합니다.
git clone https://github.com/maziluiosif/oxi
cd oxi
cargo run --release
winget install --id LLVM.LLVM -e
winget install --id Kitware.CMake -e
또한 C++를 사용한 데스크톱 개발 워크로드를 포함하여 Visual Studio Build Tools도 설치해야 합니다. 빌드 과정에서 libclang을 찾지 못하면 다음 명령으로 설정하세요:
[Environment]::SetEnvironmentVariable(
1. **프로젝트 열기.** 폴더에서 `oxi`를 실행하거나 사이드바의 **폴더 열기…**를 사용합니다.
2. **설정(Settings) → 모델 및 제공업체(Models & providers)**에서 모델을 선택합니다:
- **무료 및 비공개:** **Local HF**를 선택하고, **런타임 설치(Install runtime)**를 클릭한 다음, 모델을 다운로드(일반적으로 선택된 항목 옆에 표시됨)하고 **실행(Run)**을 클릭합니다.
- **이미 Claude Code, Codex 또는 Cursor가 있나요?** 외부 에이전트(External agents) 아래에서 해당 기능을 선택하고 **활성화(Make active)**를 클릭합니다. 기존 로그인 정보를 사용합니다.
- **API 키가 있나요?** OpenAI, OpenRouter, Anthropic 호환 및 기타 항목 아래에 붙여넣습니다.
3. **실제 작업을 요청하세요:** *"테스트를 실행하고 실패한 것을 수정해 줘."* 더 큰 변경 사항의 경우 먼저 `/plan`을 입력합니다.
## 얻게 되는 것들
<table>
<tr>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/maziluiosif/oxi/HEAD/assets/screenshots/stage-local-models.png" alt="런타임 설치 및 Qwen 모델 실행을 통한 로컬 HF 설정" />
<b>로컬 모델, 준비되어 있습니다.</b> HuggingFace에서 GGUF를 선택하면 oxi가 <code class="language-none">llama-server</code>를 설치하고 다운로드하여 여기 또는 SSH를 통해 GPU 박스에서 실행합니다. LM Studio와 Ollama도 작동합니다.
</td>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/maziluiosif/oxi/HEAD/assets/screenshots/stage-router.png" alt="라우터 설정" />
<b>모든 제공업체, 또는 모든 것.</b> ACP를 통한 Claude Code, Codex 및 Cursor, ChatGPT 로그인, 또는 모든 API를 사용합니다. 라우터는 작업별로 하나를 선택하고 할당량이 소진되면 전환합니다.
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/maziluiosif/oxi/HEAD/assets/screenshots/stage-agent.png" alt="테스트 실행, 파일 읽기 및 편집하는 에이전트" />
<b>자신의 작업 과정을 보여주는 에이전트.</b> 코드를 읽고, 검색하고, 편집하며, 명령을 실행하고, 웹을 검색하고, MCP 서버를 호출합니다. 편집이나 명령어는 먼저 승인을 요청할 수 있습니다.
</td>
</tr>
</table>
</td>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/maziluiosif/oxi/HEAD/assets/screenshots/stage-review.png" alt="변경 사항에 Stage 및 Discard 버튼이 있는 스테이지와 비교 화면" />
<b>실제 diff 에디터에서 검토하기(Review).</b> Side by side 또는 인라인 방식으로, 모든 블록마다 수정 가능하며 Stage 및 Discard 기능 제공. 정의로 이동, 찾기 및 바꾸기, 미니맵, 탭 사용 가능.
</td>
</tr>
<tr>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/maziluiosif/oxi/HEAD/assets/screenshots/stage-git.png" alt="히스토리에 새 커밋이 있는 Git 패널" />
<b>내장된 Git 기능(Git built in).</b> Stage, commit, branch, compare, pull 및 push 지원하며, AI가 작성한 커밋 메시지 제공. 작업 공간에 연결된 터미널은 클릭 한 번 거리에 위치.
</td>
<td width="50%" valign="top">
<img src="https://raw.githubusercontent.com/maziluiosif/oxi/HEAD/assets/screenshots/stage-plan.png" alt="Implement plan 버튼이 있는 계획(Plan) 화면" />
<b>먼저 계획하고, 그다음에 구축하기(Plan first, then build).</b> <code />/plan</code>을 사용하여 파일을 변경하지 않고 조사할 수 있으며, 실시간 체크리스트 제공. 클릭 한 번으로 구현 가능.
</td>
</tr>
</table>
또한: 워크스페이스별 채팅 저장, 로컬 Whisper 음성 받아쓰기(voice dictation), API 키 없이 웹 검색 (DuckDuckGo, Bing 또는 SearXNG), 사용자 지정 시스템 프롬프트, `AGENTS.md` 지원, 그리고 다섯 가지 테마(Dark, Light, Midnight, Sublime, Sublime 4).
## 모델 및 제공업체(Models and providers)
설정(Settings) 또는 컴포저(composer)의 모델 선택기에서 제공업체를 선택하세요.
| 제공업체 (Provider) | |
|---|---|
| **로컬 HF (Local HF)** | oxi가 GGUF를 다운로드하여 `llama-server`를 실행해 줍니다 |
| ... |
Router를 사용하면 채팅에서 단순히 *
| Provider | Default base URL | Key from environment |
|---|---|---|
| OpenAI | `https://api.openai.com/v1` | `OPENAI_API_KEY` |
| ... |
ChatGPT 로그인에는 로그인 콜백을 위해 포트 `1455`가 비어 있어야 합니다. 라우터(Router)의 태스크 분류기는 키가 설정되어 있으면 OpenRouter를 사용하고, 그렇지 않으면 로컬 규칙으로 폴백합니다. 이는 설정(Settings) → Provider → Router에서 끌 수 있습니다.
## 데이터 (Your data)
모든 것은 사용자 기기에 보관됩니다. 설정은 구성 폴더(예: Linux의 경우 `~/.config/oxi/settings.json`)에 있으며, 진단 로그인 `oxi.log` 및 oxi가 충돌할 경우 `crash.log`와 함께 위치합니다 (설정 → 정보에서 열 수 있음). API 키, 로그인 토큰, SSH 비밀번호는 설정 파일이 아닌 시스템 키체인(macOS Keychain, Windows Credential Manager, Linux의 Secret Service)에 저장됩니다.
작업 공간(workspace)에 루트 디렉터리에 `AGENTS.md`가 있는 경우, oxi는 이를 에이전트의 지침에 추가합니다.
## 알아두면 좋은 점 (Good to know)
- 승인 프롬프트(Approval prompts)가 실제 안전 경계입니다. 셸 명령어와 MCP 도구는 격리되지 않습니다(not sandboxed).
- SSH 터널은 사용자가 제어하는 기기에만 연결하세요.
- 이미지 입력은 모델이 이미지를 지원하는지에 따라 달라집니다.
## 기여 (Contributing)
빌드, 테스트, 코드 레이아웃 및 PR 규칙에 대해서는 [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하십시오.