YAML Metadata Warning:empty or missing yaml metadata in repo card
Check out the documentation for more information.
Claude Desktop CLI Wrapper
μ΄ νλ‘μ νΈλ ν°λ―Έλ κΈ°λ°μ Claude Code CLIλ₯Ό μΌλ° μ¬μ©μκ° μ΅μν λ°μ€ν¬ν λ©μ μ /μ±ν μ ν리μΌμ΄μ ννμ GUI μ°½μΌλ‘ κ°μΈμ μ¬μ©ν μ μκ² ν΄μ£Όλ μ΄κ²½λ Electron κΈ°λ° λνΌμ λλ€.
λ΄λΆμ μΌλ‘λ μ€μ Claude Code CLI νλ‘μΈμ€κ° λμνλ―λ‘, μ¬μ μ ꡬμ±ν΄ λ Langfuse Hook λ° CodeBurn λͺ¨λν°λ§ μμ€ν μ΄ 100% μ μ μλν©λλ€.
π μ£Όμ νΉμ§
- μ±λ΄ μ€νμΌ GUI: xterm.js κΈ°λ°μ μΈλ ¨λ Dark ν λ§ μ€νμΌλ§ μ μ©.
- 무μ€λ¨ λͺ¨λν°λ§: Claude Codeμ μλ λΌμ΄νμ¬μ΄ν΄μ κ·Έλλ‘ λ°λ₯΄λ―λ‘
langfuse_hook.pyκ° μ μ μλνμ¬ ν ν°/λΉμ© νΈλνΉ κ°λ₯. - ν¬λ‘μ€ νλ«νΌ: Windows, macOS, Linux λΉλ λ° λ°°ν¬ μ§μ.
- λ€μ΄ν°λΈ μ±λ₯:
node-ptyλ₯Ό ν΅ν λΆλλ¬μ΄ κ°μ ν°λ―Έλ νκ²½ ꡬν.
π οΈ μ¬μ μꡬμ¬ν
- Node.js: LTS λ²μ (v20 μ΄μ κΆμ₯)
- Claude Code CLI κΈλ‘λ² μ€μΉ:
npm install -g @anthropic-ai/claude-code- ν°λ―Έλμμ
claude --helpλλclaudeλ₯Ό μ³€μ λ μ μμ μΌλ‘ μΌμ§λ μνμ¬μΌ ν©λλ€.
- ν°λ―Έλμμ
π» λ‘컬 κ°λ° λ° μ€ν λ°©λ²
μμ‘΄μ± λͺ¨λ μ€μΉ:
npm install- μ€μΉ μ C++ λ€μ΄ν°λΈ λͺ¨λ(
node-pty) μ»΄νμΌμ μν΄ κ°λ° λ¨Έμ μ λΉλ λꡬ(Windowsμ κ²½μ° Visual Studio Build Tools, macOSμ κ²½μ° Xcode Command Line Tools, Linuxμ κ²½μ° build-essential)κ° νμν μ μμ΅λλ€.
- μ€μΉ μ C++ λ€μ΄ν°λΈ λͺ¨λ(
λ‘컬 ν μ€νΈ μ€ν:
npm start- Electron μ°½μ΄ λ¨λ©° Claude Code CLIκ° μ¦μ μμλ©λλ€.
λ€μ΄ν°λΈ λͺ¨λ μ¬λΉλ (νμμ): Electronμ Node ABI λ²μ κ³Ό λ‘컬 Node.js λ²μ μ΄ λ¬λΌ μ€ν μλ¬κ° λ κ²½μ° μ€νν©λλ€.
npm run rebuild
π¦ νλ«νΌλ³ ν¨ν€μ§ λ° μ€μΉ νμΌ μμ±
μ΄ νλ‘μ νΈλ electron-builderλ₯Ό μ¬μ©νμ¬ ν¨ν€μ§μ μνν©λλ€.
λ€μ΄ν°λΈ λͺ¨λ ν¬λ‘μ€ μ»΄νμΌμ μ μ½
node-ptyλ C++ κΈ°λ° λ€μ΄ν°λΈ λͺ¨λμ΄λ―λ‘, λμ νλ«νΌ(OS) νκ²½ λ΄μμ μ§μ ν¨ν€μ§νλ κ²μ κ°λ ₯ν κΆμ₯ν©λλ€. μ: Windowsμ© μ€μΉ νμΌ(.exe)μ μ»κ³ μΆλ€λ©΄ Windows νκ²½μμ λΉλλ₯Ό μνν΄μΌ μλ¬κ° λ°μνμ§ μμ΅λλ€.
1. Windows λΉλ (Windows λ¨Έμ μμ μν)
npm run dist
- λΉλκ° μλ£λλ©΄
dist/ν΄λμClaude Desktop CLI Setup 1.0.0.exeνμΌμ΄ μμ±λ©λλ€.
2. macOS λΉλ (macOS λ¨Έμ μμ μν)
npm run dist
- λΉλκ° μλ£λλ©΄
dist/ν΄λμClaude Desktop CLI-1.0.0.dmgνμΌμ΄ μμ±λ©λλ€.
3. Linux λΉλ (Ubuntu λ± Linux λ¨Έμ μμ μν)
npm run dist
- λΉλκ° μλ£λλ©΄
dist/ν΄λμ.AppImageλ°.debμ€μΉ νμΌμ΄ μμ±λ©λλ€.