တပ်ဆင်မှု လမ်းညွှန်
Chapter 1 မစတင်မီ သင့်စက်ကို အဆင်သင့်ဖြစ်အောင် ပြင်ဆင်ပါ။ ~၄၅–၆၀ မိနစ် (terminal နှင့် အကျွမ်းတဝင်မရှိပါက ၉၀ မိနစ်)။ Linux, macOS နှင့် Windows (WSL မှတစ်ဆင့်) တို့တွင် အလုပ်လုပ်သည်။
သင်သည် code editor တစ်ခု၊ Node, Python, Git နှင့် Claude Code တို့ကို ထည့်သွင်းရမည်ဖြစ်ပြီး အားလုံးကို ပြန်လည်စစ်ဆေးရပါမည်။
အမြန်လမ်းကြောင်း (command တစ်ခုတည်း)
Terminal အသုံးပြုရတာ အဆင်ပြေပါသလား? ဤအရာသည် အားလုံးကို ထည့်သွင်းပေးပြီး စစ်ဆေးပေးပါမည် -
curl -fsSL https://raw.githubusercontent.com/vibe-code-tours/vibecode-setup/main/student-setup.sh | bash ထပ်ခါတလဲလဲ run နိုင်ပါသည်။ အဆုံးတွင် Passed: 6, Failed: 0 ဖြစ်ရန် လိုအပ်ပါသည်။ အရင်းအမြစ်နှင့် ဤလမ်းညွှန်ကို GitHub repo တွင် ကြည့်ရှုနိုင်သည်။
Windows: WSL ကို အရင်ထည့်သွင်းပါ (အဆင့် ၀)၊ ထို့နောက် Ubuntu ထဲတွင် ၎င်းကို run ပါ။ script သည် editor (အဆင့် ၅) သို့မဟုတ် GitHub SSH (အဆင့် ၆) တို့ကို လုပ်ဆောင်ပေးမည်မဟုတ်ပါ — ၎င်းတို့ကို ကိုယ်တိုင်လုပ်ဆောင်ပါ။
အဆင့် ၀ — Windows အတွက်သာ- WSL ထည့်သွင်းပါ
Windows ကို တိုက်ရိုက်မပံ့ပိုးပါ — သင်သည် အရာအားလုံးကို WSL (Windows ထဲရှိ တကယ့် Linux) ထဲတွင် run ရပါမည်။ PowerShell (Admin) တွင်-
wsl --install စက်ကို Restart ချပါ၊ Start မှ Ubuntu ကို ဖွင့်ပါ။ အောက်ပါအချက်အားလုံးကို ထိုနေရာတွင် run ပါ။ macOS / Linux: ဤအဆင့်ကို ကျော်ပါ။
အဆင့် ၁ — Node.js (nvm မှတစ်ဆင့်)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# CLOSE the terminal, open a NEW one, then:
nvm install --lts
nvm use --lts
nvm alias default node
node --version # v22.x နံပါတ် ၁ အမှား- nvm ထည့်သွင်းပြီးနောက် terminal ကို ပိတ်ပြီး ပြန်ဖွင့်ရန် မေ့လျော့ခြင်း။ ၎င်းကို လုပ်ဆောင်ပါ။
အဆင့် ၂ — Python (uv မှတစ်ဆင့်)
curl -LsSf https://astral.sh/uv/install.sh | sh
# restart terminal, then:
uv python install 3.12
python3 --version # Python 3.12.x အဆင့် ၃ — Git
# Linux / WSL
sudo apt update && sudo apt install -y git
# macOS
xcode-select --install # or: brew install git
git --version အဆင့် ၄ — Claude Code
curl -fsSL https://claude.ai/install.sh | bash
# if "command not found" -> close terminal, open new one
claude --version # 2.x
claude # first run: opens your browser to log in ပထမဆုံးအကြိမ် စတင်အသုံးပြုချိန်တွင် လော့ဂ်အင်ဝင်ခြင်းသည် တစ်ကြိမ်သာ လုပ်ဆောင်ရမည့် အဆင့်ဖြစ်သည်။ သင် ချတ်ထဲသို့ ရောက်ရှိသည်နှင့် သင်၏ ပထမဆုံး မက်ဆေ့ဂျ်ကို ရိုက်ထည့်ပြီး Enter ကို နှိပ်ပါ — သင်၏ “first contact”:
Say hello in one sentence. အဆင်ပြေသော ပြန်လည်ဖြေကြားချက် ရရှိပါက သင်၏ ထည့်သွင်းမှု၊ ကွန်ရက်နှင့် အကောင့်အားလုံး အလုပ်လုပ်သည်ဟု ဆိုလိုသည်။
Path A အဆင်မပြေပါက (အချို့ကွန်ရက်များသည် claude.ai ကို ပိတ်ထားတတ်သည်)၊ npm fallback ကို အသုံးပြုပါ-
npm install -g @anthropic-ai/claude-code
claude --version ကုန်ကျစရိတ် — Claude Code သည် အခပေးမှသာ အသုံးပြုနိုင်သည်- Anthropic API (Sonnet ~M tokens လျှင် $3/$15 ခန့်) သို့မဟုတ် Claude Pro $20/mo။ အခမဲ့အသုံးပြုနိုင်သည့် tier မရှိပါ။
အဆင့် ၅ — opencode CLI
opencode သည် open-source ဖြစ်ပြီး မည်သည့် model နှင့်မဆို အသုံးပြုနိုင်သည့် CLI agent ဖြစ်သည် (Anthropic, OpenAI, Google နှင့် local models များဖြင့် အလုပ်လုပ်သည်)။ Claude ကို ဆက်သွယ်၍မရသည့်အခါတွင်ပင် အလုပ်လုပ်မည့် agent တစ်ခု ရှိနေစေရန် ၎င်းကို Claude Code နှင့်အတူတူ install လုပ်ထားပါသည်။
# Path A — official installer
curl -fsSL https://opencode.ai/install | bash
opencode --version တရားဝင် installer အဆင်မပြေပါက npm fallback ကို အသုံးပြုပါ-
# Path B — npm fallback
npm install -g opencode-ai
opencode --version ပထမဆုံးအကြိမ် အသုံးပြုချိန်တွင် provider/model ရွေးချယ်ရန် interactive picker ပေါ်လာမည်ဖြစ်သည်။ ကျွန်ုပ်တို့၏ shared endpoint လွှင့်တင်ပြီးပါက config snippet ကို ထုတ်ပြန်ပေးမည်ဖြစ်ပြီး ၎င်းကို ~/.config/opencode/opencode.json ထဲသို့ ထည့်သွင်းပေးပါ။
ကုန်ကျစရိတ် — opencode ကိုယ်တိုင်မှာ အခမဲ့ဖြစ်ပြီး သင်အသုံးပြုသည့် model အတွက်သာ ကျသင့်မည်ဖြစ်သည်။ ပထမနေ့အတွက် အသက်သာဆုံး အခမဲ့လမ်းကြောင်းမှာ- opencode + Google AI Studio API key (အခမဲ့ Gemini Flash-Lite quota ~1,500 req/day) ဖြစ်သည်။
အဆင့် ၆ — Vibe proxy သို့ ချိတ်ဆက်ပါ
Claude Code နှင့် opencode သည် သင်၏ ကိုယ်ပိုင် key ဖြင့် ကျွန်ုပ်တို့၏ shared proxy ကို ချိတ်ဆက်အသုံးပြုသည်။ သင်၏ key ကို cohort bot (Telegram သို့မဟုတ် Discord — /mykey ပို့ပါ) မှ ရယူပြီး setup script ကို run ပါ — ၎င်းသည် script ကို download လုပ်၊ သင်၏ key ကို အသုံးပြုပြီး tool နှစ်ခုလုံးကို proxy ဆီသို့ ချိန်ညှိပေးပါမည်။
curl -fsSL https://raw.githubusercontent.com/vibe-code-tours/vibecode-setup/main/api-setup.sh -o api-setup.sh
curl -fsSL https://raw.githubusercontent.com/vibe-code-tours/vibecode-setup/main/vibe-key.env.example -o vibe-key.env
# open vibe-key.env, paste VIBE_PROXY + VIBE_KEY from the bot, save, then:
source api-setup.sh ပြီးပါပြီ — tool နှစ်ခုလုံးသည် Vibe proxy ကို ဖြတ်သန်းအသုံးပြုနေပါပြီ။ စတင် coding လုပ်ပါ -
claude # or: opencode source သုံးခြင်းသည် သင်၏ လက်ရှိ shell တွင် ချက်ချင်း သက်ရောက်စေသည်။ နောက်ပိုင်း ပြန်ဖျက်ပြီး ကိုယ်ပိုင် Claude login ပြန်ယူလိုပါက - bash api-setup.sh --restore
အဆင့် ၇ — Code editor
တစ်ခုရွေးပါ (နှစ်ခုလုံး အခမဲ့ဖြစ်ပြီး VS Code အပေါ် အခြေခံထားသဖြင့် extension များမှာလည်း နှစ်ခုလုံးတွင် အလုပ်လုပ်သည်)-
- VS Code — စံနှုန်းသတ်မှတ်ချက်: code.visualstudio.com
- Antigravity IDE — Google ၏ AI-ဦးစားပေး editor (VS Code fork): antigravity.google
အကြံပြုထားသော extension များ (ကြိုက်နှစ်သက်ရာတွင် ထည့်သွင်းပါ)
| Extension | အဘယ်ကြောင့် |
|---|---|
| Python (ms-python.python) | Python ဘာသာစကား အထောက်အပံ့၊ run/debug |
| ESLint + Prettier | JS/TS linting + အလိုအလျောက် format ပြုလုပ်ခြင်း |
| GitLens | Git history နှင့် blame ကို inline ကြည့်ရှုနိုင်ရန် |
| Error Lens | Error များကို မျဉ်းတားရုံတင်မကဘဲ inline ဖော်ပြပေးရန် |
| Markdown All in One | ဒီ Tour မှာ markdown တွေ အများကြီး ရေးရပါလိမ့်မယ် |
| GitHub Pull Requests | Editor ထဲကနေ ထွက်စရာမလိုဘဲ PR များကို စီမံခန့်ခွဲရန် |
| Path Intellisense | File path များကို အလိုအလျောက် ဖြည့်စွက်ပေးရန် |
Antigravity ကဲ့သို့သော fork များသည် Open VSX registry ကို အသုံးပြုနိုင်သည် — အထက်ပါ အားလုံးမှာ နှစ်ခုလုံးတွင် ရှိသောကြောင့် ရှာဖွေပြီး ထည့်သွင်းခြင်းမှာ အတူတူပင်ဖြစ်သည်။
အဆင့် ၈ — GitHub အကောင့် + SSH
အန္တရာယ်အရှိဆုံးအဆင့် — စစ်ဆေးမှုကို မကျော်ပါနှင့်။
ssh-keygen -t ed25519 -C "your_email@example.com" # Enter through prompts
cat ~/.ssh/id_ed25519.pub # copy the .pub key
# GitHub -> Settings -> SSH and GPG keys -> New SSH key -> paste
ssh -T git@github.com # "Hi <username>!" = success Private key (~/.ssh/id_ed25519, .pub မပါသောဖိုင်) ကို ဘယ်တော့မှ မျှဝေခြင်းမပြုပါနှင့်။
အဆင့် ၉ — အားလုံးကို ပြန်လည်စစ်ဆေးပါ
စစ်ဆေးပေးမည့် script ကို run ပါ (fast-path script က ၎င်းကို အလိုအလျောက် လုပ်ဆောင်ပေးပါမည်) -
curl -fsSL https://raw.githubusercontent.com/vibe-code-tours/vibecode-setup/main/student-setup.sh | bash ရည်မှန်းချက် - Passed: 6, Failed: 0။
စျေးနှုန်း + အခမဲ့ tier quota များ- PRICING.md (အမြန်ကြည့်လမ်းညွှန်)
ပြဿနာဖြေရှင်းခြင်း
| ရောဂါလက္ခဏာ | ပြုပြင်ရန် |
|---|---|
| nvm: command not found | Terminal ကို ပိတ်ပြီး အသစ်ပြန်ဖွင့်ပါ။ သို့မဟုတ် source ~/.bashrc (mac: ~/.zshrc) ကို run ပါ။ |
| claude: command not found | Terminal ကို ပိတ်ပြီး အသစ်ပြန်ဖွင့်ပါ။ အခြေအနေ ၉၀% လောက်မှာ အဆင်ပြေသွားပါလိမ့်မယ်။ |
| command not found right after install | Terminal ကို ပိတ်ပြီး အသစ်ပြန်ဖွင့်ပါ — shell အသစ်ဖွင့်မှ PATH update ဖြစ်ပါလိမ့်မယ်။ |
| Windows: nothing works in CMD/PowerShell | Native Windows မှာ မဟုတ်ဘဲ WSL/Ubuntu ထဲမှာပဲ run ရပါမယ်။ |
| ssh -T git@github.com → Permission denied | .pub key ကို GitHub ထဲမှာ အကောင့်မှန်အောင် ထည့်ထားသလားဆိုတာ ပြန်စစ်ပါ။ |
| sudo: command not found (macOS) | sudo ကို ဖြုတ်ပါ — brew install ကိုပဲ သုံးပါ။ |
| Install script blocked | Antivirus သို့မဟုတ် corporate proxy ကြောင့် ဖြစ်နိုင်ပါတယ် — ကိုယ်ပိုင် network နဲ့ စမ်းကြည့်ပါ။ |
အဆင်မပြေသေးဘူးလား? အမှား (error) ကို အတိအကျကူးပြီး cohort channel ဖြစ်တဲ့ #setup-help မှာ မေးမြန်းနိုင်ပါတယ်။ error အတိအကျရှိရင် ကူညီရလွယ်ကူပါတယ်၊ "အလုပ်မလုပ်ဘူး" ဆိုတာမျိုးကတော့ ကူညီရခက်ပါတယ်။
ရွေးချယ်နိုင်သော အခြား AI coding tools များ (အခမဲ့ / open-source)
မဖြစ်မနေ မလိုပါဘူး။ Claude Code က ကျွန်ုပ်တို့ရဲ့ default ဖြစ်ပေမဲ့ ဒီ Tour က AI နယ်ပယ်တစ်ခုလုံးအကြောင်း ဖြစ်တဲ့အတွက် Chapter 7 မှာ အခြားရွေးချယ်စရာတွေကို လေ့လာသွားမှာပါ။ အားလုံးက အခမဲ့နဲ့ open-source တွေ ဖြစ်ပြီး တစ်ခုချင်းစီအတွက် ကိုယ်ပိုင် provider account (အချို့က free tier ရသည်) လိုအပ်ပါတယ်။
| Tool | လိုင်စင် | ထည့်သွင်းပါ | လိုအပ်ချက်များ |
|---|---|---|---|
| OpenCode | MIT | curl -fsSL https://opencode.ai/install | bash | မည်သည့် model provider မဆို |
| Codex CLI | Apache-2.0 | npm i -g @openai/codex | OpenAI account |
| Gemini CLI | Apache-2.0 | npm i -g @google/gemini-cli | Google account — free tier |
သိထားသင့်တဲ့ အခြားအရာတွေ (ကျွန်ုပ်တို့ install စာရင်းမှာ မပါပါ) - Aider နဲ့ llm - Ollama ကတစ်ဆင့် local open models တွေကို run ပေးတဲ့ open-source CLIs တွေဖြစ်ပြီး လုံးဝအခမဲ့နဲ့ offline အသုံးပြုနိုင်ပါတယ်။ ၎င်းတို့ကို Chapter 7 မှာ ညွှန်းဆိုထားပါတယ်။ အားလုံးကို ပထမရက်မှာတင် install မလုပ်ပါနဲ့ - တစ်ခုကို ရွေးချယ်ပြီး စမ်းသပ်ကြည့်ပါ။
အားလုံးပြီးသွားတဲ့အခါ သင်ရရှိမည့်အရာများ
- VS Code သို့မဟုတ် Antigravity + extensions များ
- Node 22 + npm, Python 3.12 (via uv)
- Git + GitHub SSH ချိတ်ဆက်ပြီး
- Claude Code (ပထမဆုံး command ကို စမ်းသပ်ပြီး)
- စစ်ဆေးချက် ၆ ခုစလုံး Passed (အစိမ်းရောင်) ဖြစ်သွားပြီ
ဒါကတော့ တစ်ကြိမ်ပဲ လုပ်ရမယ့် အလုပ် (tax) ပါ။ တစ်ခါပဲ ပေးဆောင်လိုက်ပါ၊ နောက်ထပ် ပြန်လုပ်စရာ မလိုတော့ပါဘူး။ Chapter 1 မှာ ပြန်တွေ့ကြမယ်။