From b5a7407847a3b025910646fe7ed5e49959526950 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Sun, 22 Mar 2026 13:20:34 +0900 Subject: [PATCH] =?UTF-8?q?docs(research):=20CLI=20=EC=84=B8=EC=85=98=20?= =?UTF-8?q?=EC=9E=AC=EA=B0=9C=C2=B7=EC=9E=90=EB=8F=99=ED=99=94=20=EB=A6=AC?= =?UTF-8?q?=EC=8A=A4=ED=81=AC=20=EC=A0=95=EB=A6=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Made-with: Cursor --- ...…˜_์—ฐ์†๋Œ€ํ™”_๋ฐ_์ž๋™ํ™”_๋ฆฌ์Šคํฌ.md | 58 +++++++++++++++++++ .../research/orchestration_tools/README.md | 1 + 2 files changed, 59 insertions(+) create mode 100644 journey/research/orchestration_tools/260323_CLI_์„ธ์…˜_์žฌ๊ฐœ_์„น์…˜_์—ฐ์†๋Œ€ํ™”_๋ฐ_์ž๋™ํ™”_๋ฆฌ์Šคํฌ.md diff --git a/journey/research/orchestration_tools/260323_CLI_์„ธ์…˜_์žฌ๊ฐœ_์„น์…˜_์—ฐ์†๋Œ€ํ™”_๋ฐ_์ž๋™ํ™”_๋ฆฌ์Šคํฌ.md b/journey/research/orchestration_tools/260323_CLI_์„ธ์…˜_์žฌ๊ฐœ_์„น์…˜_์—ฐ์†๋Œ€ํ™”_๋ฐ_์ž๋™ํ™”_๋ฆฌ์Šคํฌ.md new file mode 100644 index 0000000..af4ad9f --- /dev/null +++ b/journey/research/orchestration_tools/260323_CLI_์„ธ์…˜_์žฌ๊ฐœ_์„น์…˜_์—ฐ์†๋Œ€ํ™”_๋ฐ_์ž๋™ํ™”_๋ฆฌ์Šคํฌ.md @@ -0,0 +1,58 @@ +--- +type: research +tags: [research, orchestration, cli, gemini-cli, claude, codex, session, context, automation, tos] +status: open +research_target: ํ„ฐ๋ฏธ๋„ CLI(GeminiยทClaudeยทCodex)์—์„œ ์„ธ์…˜ ์žฌ๊ฐœยท์ด๋ฆ„/ID๋กœ ์ž‘์—… ๊ตฌํš ๋‚˜๋ˆ„๊ธฐ, ์ž๋™ํ™”ยท๊ตฌ๋… ToS ๋ฆฌ์Šคํฌ, ์—์ด์ „ํŠธ ์—ฐ๋™ ์‹œ ํ•œ๊ณ„ ์ •๋ฆฌ +--- + +# CLI ์„ธ์…˜ ์žฌ๊ฐœยท์„น์…˜ํ˜• ์—ฐ์† ๋Œ€ํ™” ๋ฐ ์ž๋™ํ™” ๋ฆฌ์Šคํฌ + +**์ž‘์„ฑ์ผ**: 2026-03-23 +**์„ฑ๊ฒฉ**: ๋Œ€ํ™”ยท์›น ๊ฒ€์ƒ‰ยท์ œํ’ˆ ๋™ํ–ฅ์„ ๋ฐ”ํƒ•์œผ๋กœ ํ•œ **์šด์˜ ๋ฉ”๋ชจ**. ๋ช…๋ น์–ด๋Š” **์„ค์น˜๋œ CLI ๋ฒ„์ „** ๊ธฐ์ค€์œผ๋กœ ์žฌํ™•์ธํ•  ๊ฒƒ. + +## 1. ์•„์ด๋””์–ด ์š”์•ฝ + +- ํ„ฐ๋ฏธ๋„์—์„œ **์ž‘์—… ๋‹จ์œ„(์„น์…˜)** ๋ฅผ ์ด๋ฆ„ยทIDยทํƒœ๊ทธ๋กœ ๊ตฌ๋ถ„ํ•ด ๋‘๊ณ , **๊ฐ™์€ ์„ธ์…˜์œผ๋กœ ์ด์–ด์„œ** ์งˆ๋ฌธยท๋ช…๋ น์„ ์Œ“๊ณ  ์‹ถ์€ ๊ฒฝ์šฐ. +- **์˜คํ†  ์ปดํŒฉํŠธ**(๋Œ€ํ™” ์••์ถ•)๋กœ ํ† ํฐ์„ ์•„๋ผ๋ฉด์„œ ์žฅ์‹œ๊ฐ„ ์ด์–ด๊ฐ€๊ธฐ. +- ๋‚˜์•„๊ฐ€ **Slack ๋“ฑ ์™ธ๋ถ€ ์—์ด์ „ํŠธ๊ฐ€ CLI๋ฅผ ํ˜ธ์ถœ**ํ•ด ํŒŒ์ผ ์ด๋™ ๋“ฑ์„ ๋ฐ˜๋ณต ์‹œํ‚ฌ ๋•Œ, **โ€œ์–ด์ œ ์˜ฎ๊ธด ๊ทธ ํŒŒ์ผโ€** ์„ ์„ธ์…˜์ด **ํŒŒ์ผ์‹œ์Šคํ…œ๊นŒ์ง€ ์ถ”์ ํ•˜๋Š”์ง€**์— ๋Œ€ํ•œ ๊ธฐ๋Œ€์น˜ ์ •๋ฆฌ. + +## 2. ๋„๊ตฌ๋ณ„ ์„ธ์…˜ยท์žฌ๊ฐœ (๊ฐœ์š”) + +| ๋„๊ตฌ | ์„ธ์…˜ยท์žฌ๊ฐœ ์š”์ง€ | ๋น„๊ณ  | +|------|----------------|------| +| **Gemini CLI** | ๋Œ€ํ™” ์ €์žฅยท๋ชฉ๋กยท์žฌ๊ฐœ(`--resume`, ํƒœ๊ทธ/์‹๋ณ„์ž๋กœ ๊ตฌ๋ถ„ ๊ฐ€๋Šฅํ•œ ํŒจํ„ด) | ์ œํ’ˆ ์—…๋ฐ์ดํŠธ ์‹œ ํ”Œ๋ž˜๊ทธ ํ™•์ธ | +| **Claude Code CLI** | `--continue`, `--resume` / ์„ธ์…˜ ๋ชฉ๋ก์—์„œ ์„ ํƒ, ์ด๋ฆ„ ๋ถ™์ด๊ธฐ | `-r` ๋“ฑ **ํ•œ ์ค„์— ์งˆ๋ฌธ๊นŒ์ง€** ๋„ฃ๋Š” ํŒจํ„ด๋„ ๋ฌธ์„œํ™”๋จ | +| **OpenAI Codex CLI** | `codex resume`, `--last`, ์„ธ์…˜ ID ์ง€์ • | ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ์ง„์ž… ํ›„ ์ž…๋ ฅ์ด ๊ธฐ๋ณธ; exec ๋ชจ๋“œ๋Š” ๋ณ„๋„ | +| **gcloud CLI** | **๋Œ€ํ™”ํ˜• AI ์„ธ์…˜ ๊ฐœ๋… ์—†์Œ** (๋ฆฌ์†Œ์Šค ๊ด€๋ฆฌ์šฉ) | ๋ณธ ์ฃผ์ œ์™€ ๋ฌด๊ด€ | + +**โ€œ์„น์…˜ ๋ฒˆํ˜ธ๋งŒ ์™ธ์›Œ์„œ ๋งค๋ฒˆ ๋„ฃ๊ธฐโ€** +- ๊ตฌํ˜„๋งˆ๋‹ค **์ˆซ์ž ์ธ๋ฑ์Šค** vs **UUID/์ด๋ฆ„**์ด ๋‹ค๋ฆ„. โ€œ๋ฒˆํ˜ธโ€๋Š” **๋ชฉ๋ก์—์„œ ๋ณด์ด๋Š” ์‹๋ณ„์ž**๋กœ ์ดํ•ดํ•˜๋Š” ํŽธ์ด ์•ˆ์ „ํ•จ. + +## 3. ์ฝ˜ํ…์ŠคํŠธ vs ํŒŒ์ผ ์ƒํƒœ (์ค‘์š”) + +- ์„ธ์…˜์— ๋‚จ๋Š” ๊ฒƒ์€ ์ฃผ๋กœ **๋Œ€ํ™” ํ…์ŠคํŠธ**(๋ฐ ๋„๊ตฌ๊ฐ€ ๋ฐ˜ํ™˜ํ•œ ์ถœ๋ ฅ ์š”์•ฝ). +- **`mv` ๋“ฑ์œผ๋กœ ๋ฐ”๋€ ์‹ค์ œ ๊ฒฝ๋กœ**๋Š” CLI๊ฐ€ **์ž๋™์œผ๋กœ ์ง€์† ์ถ”์ ํ•˜์ง€ ์•Š์Œ**. โ€œ์–ด์ œ ๊ทธ ํŒŒ์ผโ€์€ **์ด์ „ ํ„ด ๋Œ€ํ™”ยท๋กœ๊ทธยทCLAUDE.mdยท๋ฉ”๋ชจ๋ฆฌ**์— ์˜์กดํ•œ **์ถ”๋ก **์— ๊ฐ€๊น๊ณ , ๊ฒฝ๋กœ๊ฐ€ ๋ฐ”๋€Œ๋ฉด ์˜ค๋™์ž‘ ๊ฐ€๋Šฅ. +- **ํ™•์‹คํžˆ ํ•˜๋ ค๋ฉด**: ์Šคํฌ๋ฆฝํŠธยทDBยท๋งค๋‹ˆํŽ˜์ŠคํŠธ ๋“ฑ **์™ธ๋ถ€ SSOT**์— โ€œ๋…ผ๋ฆฌ ํŒŒ์ผ ID โ†’ ํ˜„์žฌ ๊ฒฝ๋กœโ€๋ฅผ ๋‘๋Š” ํŽธ์ด ์•ˆ์ „ํ•จ. + +## 4. ์ž๋™ํ™”ยท๊ตฌ๋…ยท๋ฐด ๋ฆฌ์Šคํฌ (๊ฐœ๋… ์ •๋ฆฌ) + +- **๊ณต์‹ CLI๋ฅผ ์‚ฌ๋žŒ์ด ์ˆ˜๋™์œผ๋กœ** ์„ธ์…˜ ์žฌ๊ฐœยท์งˆ๋ฌธ ๋ฐ˜๋ณต: ์ผ๋ฐ˜์ ์œผ๋กœ ์ผ์ƒ์  ์‚ฌ์šฉ ํŒจํ„ด์— ๊ฐ€๊น๋‹ค๊ณ  ์•Œ๋ ค์ ธ ์žˆ์Œ (๋‹จ, **์ตœ์ข… ํŒ๋‹จ์€ ๊ฐ ์„œ๋น„์Šค ToSยท๊ณต์ง€**). +- **Slack ๋ด‡ โ†’ ๋ฌด์ธ์œผ๋กœ CLI ๋ฐ˜๋ณต ํ˜ธ์ถœยท๊ณ ๋นˆ๋„ ๋ฃจํ”„**๋Š” โ€œ์ž๋™ํ™” ํ•˜๋„ค์Šคโ€์— ๊ฐ€๊นŒ์›Œ **๋‚จ์šฉ ํƒ์ง€ยท๋ ˆ์ดํŠธ๋ฆฌ๋ฐ‹**๊ณผ ๋งž๋‹ฟ์„ ์ˆ˜ ์žˆ์Œ. ๊ณผ๊ฑฐ **์„œ๋“œํŒŒํ‹ฐ ํ•˜๋„ค์Šคยท๊ตฌ๋… ์•…์šฉ** ๊ด€๋ จ ๋…ผ์˜๊ฐ€ ์žˆ์—ˆ์Œ โ€” **์ •์ฑ…์€ ์ˆ˜์‹œ ๋ณ€๊ฒฝ**. +- **์™„ํ™” ๋ฐฉํ–ฅ(๊ฐœ๋…)**: ๋ฒค๋” **๊ณต์‹ API**ยท๋ช…์‹œ์  ์ฟผํ„ฐยท๊ฐ์‚ฌ ๊ฐ€๋Šฅํ•œ ๋กœ๊ทธ, ๋˜๋Š” ์ž๋™ํ™” ์ •์ฑ…์ด ๋น„๊ต์  ๋ช…ํ™•ํ•œ ๊ฒฝ๋กœ ๊ฒ€ํ† . + +## 5. ์ธํ”„๋ผยท์›Œํฌ์ŠคํŽ˜์ด์Šค์™€์˜ ๊ด€๊ณ„ + +- ์„ธ์…˜ ๋ฐ์ดํ„ฐ๋Š” **ํ•ด๋‹น ๋จธ์‹ (๋˜๋Š” CLI๊ฐ€ ์“ฐ๋Š” ํ™ˆ ๋””๋ ‰ํ„ฐ๋ฆฌ)** ์— ์Œ“์ด๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์Œ. **23/24 ์„œ๋ฒ„๋ฅผ ๋ฐ”๊ฟ” SSH** ํ•˜๋ฉด โ€œ๊ฐ™์€ ์„น์…˜โ€์ด **์ž๋™์œผ๋กœ ์ด์–ด์ง€์ง€ ์•Š์„ ์ˆ˜ ์žˆ์Œ**. +- ํŒ€ ํ‘œ์ค€์€ **infra DOCS** [๋กœ์ปฌ ๊ฐœ๋ฐœ์ž ์›Œํฌํ”Œ๋กœ์šฐ](https://git.ro-being.com/ivada-infra/DOCS/-/blob/main/workflow/local_developer_workflow.md)์˜ gitยท๊ฒฝ๊ณ„ ๊ทœ์น™๊ณผ ํ•จ๊ป˜ ์ฝ์„ ๊ฒƒ. + +## 6. ๋‹ค์Œ ๊ฒ€์ฆ(Truth First) + +- [ ] ๊ฐ CLI `--help` / ๊ณต์‹ ๋ฌธ์„œ์—์„œ **resumeยทsession** ํ‚ค์›Œ๋“œ ์žฌํ™•์ธ +- [ ] ์‚ฌ์šฉ ์ค‘์ธ **์š”๊ธˆ์ œยทToS** ์—์„œ automationยทAPI ๊ฒฝ๋กœ ํ—ˆ์šฉ ๋ฒ”์œ„ ํ™•์ธ +- [ ] ํŒŒ์ผ ์ด๋™ ์ž๋™ํ™”๋Š” **๋Œ€ํ™” ๊ธฐ์–ต์ด ์•„๋‹Œ ์ƒํƒœ ์ €์žฅ์†Œ**๋กœ ์„ค๊ณ„ ๊ฒ€ํ†  + +## 7. ๊ด€๋ จ ๋‚ด๋ถ€ ๋ฌธ์„œ + +- [OpenClaw ๊ณต์‹ ๋ฌธ์„œ ์š”์•ฝ](./260205_openclaw_official_docs_summary.md) +- [OpenClaw ๋กœ๋น™ ์ ์šฉ ๋ฆฌ์„œ์น˜](./260205_openclaw_๋กœ๋น™_์ ์šฉ_๋ฆฌ์„œ์น˜.md) +- [์ปจํ…์ŠคํŠธ ์—”์ง€๋‹ˆ์–ด๋งยทClaude Code ์˜์ƒ ๋ฆฌ์„œ์น˜](./260313_์ปจํ…์ŠคํŠธ์—”์ง€๋‹ˆ์–ด๋ง_๋”ฅ์—์ด์ „ํŠธ_ํด๋กœ๋“œ์ฝ”๋“œ_์˜์ƒ๋ฆฌ์„œ์น˜.md) diff --git a/journey/research/orchestration_tools/README.md b/journey/research/orchestration_tools/README.md index 0137890..a869950 100644 --- a/journey/research/orchestration_tools/README.md +++ b/journey/research/orchestration_tools/README.md @@ -8,3 +8,4 @@ - [๋กœ๋น™ ์—์ด์ „ํŠธ ๋ฃจํ”„ยท์Šคํ‚ฌ ํ›…ยทLLM ์‹คํ–‰ ๊ตฌ์กฐ ๋ฆฌ์„œ์น˜](260312_๋กœ๋น™_์—์ด์ „ํŠธ๋ฃจํ”„_์Šคํ‚ฌํ›…_LLM์‹คํ–‰๊ตฌ์กฐ_๋ฆฌ์„œ์น˜.md) โ€” LLM API, ์—์ด์ „ํŠธ ๋Ÿฐํƒ€์ž„, ์Šคํ‚ฌ ๊ณ„์•ฝ, ํ›… ๊ตฌ์กฐ๋ฅผ ๋กœ๋น™ ๊ธฐ์ค€์œผ๋กœ ์ •๋ฆฌ - [๋กœ๋น™ LLM APIยทAgent APIยท๋ชจ๋ธ ์„ ์ •ยท๋น„์šฉ ๋น„๊ต ๋ฆฌ์„œ์น˜](260312_๋กœ๋น™_LLM_API_Agent_API_๋ชจ๋ธ์„ ์ •_๋น„์šฉ๋น„๊ต_๋ฆฌ์„œ์น˜.md) โ€” Gemini/OpenAI ๊ณ„์—ด ๋น„๊ต, ๋น„์šฉ ๋ฌธ์„œํ™” ์›์น™, ๋กœ๋น™ ๊ธฐ์ค€ ๋ชจ๋ธ ์„ ํƒ ๋ฐฉํ–ฅ ์ •๋ฆฌ - [Context Engineering, DeepAgents, Claude Code ์˜์ƒ ๋ฆฌ์„œ์น˜](260313_์ปจํ…์ŠคํŠธ์—”์ง€๋‹ˆ์–ด๋ง_๋”ฅ์—์ด์ „ํŠธ_ํด๋กœ๋“œ์ฝ”๋“œ_์˜์ƒ๋ฆฌ์„œ์น˜.md) โ€” ์œ ํŠœ๋ธŒ ์˜์ƒ์˜ ๋„๊ตฌ ์„ค๋ช…์„ ๊ณต์‹ ๋ฌธ์„œ์™€ ๊ต์ฐจ ๊ฒ€์ฆํ•œ ๋ฆฌ์„œ์น˜ +- [CLI ์„ธ์…˜ ์žฌ๊ฐœยท์„น์…˜ํ˜• ์—ฐ์† ๋Œ€ํ™” ๋ฐ ์ž๋™ํ™” ๋ฆฌ์Šคํฌ](260323_CLI_์„ธ์…˜_์žฌ๊ฐœ_์„น์…˜_์—ฐ์†๋Œ€ํ™”_๋ฐ_์ž๋™ํ™”_๋ฆฌ์Šคํฌ.md) โ€” GeminiยทClaudeยทCodex ์„ธ์…˜ ์ด์–ดํ•˜๊ธฐ, gcloud์™€ ๊ตฌ๋ถ„, ๋ฌด์ธ ์ž๋™ํ™”ยทToS ๋ฆฌ์Šคํฌ, ํŒŒ์ผ ๊ฒฝ๋กœ ์ถ”์  ํ•œ๊ณ„