Claude Code 使用方法 — 從入門文章結束的地方開始

介紹 Claude Code 用法的文章很多，但大多在「安裝並收到第一個回應」時就結束了。真正卡住人的其實是之後——每次都要重複相同說明、確認視窗出現得太頻繁，以及工作正進行到一半時 5 小時使用量視窗關閉。本文從入門文章結束的地方開始，依序整理這三件事。

先統一一個前提。Claude Code 不是把程式碼貼進聊天視窗的工具，而是常駐於終端機與儲存庫中的代理程式。它會讀取與修改檔案、執行測試，甚至提交 commit。因此最初該做的不是背用法，而是交代專案規則。

前三個步驟——執行、/init、具體請求

安裝後值得做的只有這三件事。尤其跳過第二個 /init，之後每個工作階段都會重複相同說明。

# 1. 프로젝트 디렉터리에서 실행한다 (이게 전제 조건입니다)
cd ~/work/my-app
claude

# 2. 첫 명령은 /init — 저장소를 읽고 CLAUDE.md를 만들어 줍니다
> /init

# 3. 이후엔 한국어로 그냥 부탁하면 됩니다. 파일 경로를 붙일수록 정확해집니다
> src/api/user.ts의 검증 로직을 zod로 바꾸고 테스트도 같이 고쳐줘

/init 會讀取儲存庫並建立 CLAUDE.md。產生的內容只是草稿，不要直接保留，務必手動整理。下一節將說明其內容。

CLAUDE.md——把每次說明的內容只寫一次

CLAUDE.md 是放在專案根目錄的 Markdown 檔案，每個工作階段都會自動讀取。這裡只該寫「即使讀程式碼也無法得知的內容」。

# CLAUDE.md — 프로젝트 루트에 두고 git에 커밋합니다

## 명령어
- 테스트: npm test (파일 하나만: npm test -- path/to/file)
- 타입 검사: npx tsc --noEmit
- 린트: npm run lint

## 규칙
- 날짜는 date-fns만 사용. moment 금지.
- API 핸들러는 app/api/**/route.ts에만 둔다.
- 커밋 메시지는 한국어, prefix는 feat / fix / docs.

## 건드리면 안 되는 곳
- db/migrations/ — 생성물. 직접 수정 금지.

相反地，不該寫什麼也很明確。目錄結構或函式說明讀程式碼就能知道，沒有必要。CLAUDE.md 會隨每個請求一併傳送，因此越長越消耗 token——保持簡短，只寫規則。提交至 git 後，全隊都會套用相同規則。

權限——減少確認視窗，但不要全部關閉

每次修改檔案或執行命令時都會出現確認視窗。這是安全防護，因此實務上應限制在只允許讀取與驗證類操作，而不是全部關閉。工作階段中選擇「一律允許」後會被記住，寫入 .claude/settings.json 則可固定於專案層級。

雖然有跳過所有確認的旗標，但刪除與遠端 push 也會變成無需確認。只能在損壞後可以直接丟棄的容器或一次性工作樹中使用。判斷標準整理於何時使用 --dangerously-skip-permissions。

自訂命令——不必每次重新輸入相同要求

審查、發布前檢查、整理 commit 訊息等每次幾乎都以相同方式要求的工作，都可以建立成命令。只要在 .claude/commands/ 放入 Markdown 即可。

# .claude/commands/review.md — 파일만 두면 /review로 쓸 수 있습니다
지정된 파일을 리뷰하고 다음 세 가지만 지적하세요.

1. 실제로 실패하는 조건이 있는 버그 (재현 방법 포함)
2. 기존 유틸리티로 대체 가능한 중복
3. 테스트가 없는 분기

스타일 취향은 지적하지 마세요.

這樣就能透過 /review src/api/user.ts 執行相同觀點的審查。提交至 git 後，團隊即可共用，也能將審查標準本身放進儲存庫。實務中使用的命令形式，已在 Claude Code workflows 中以英文詳細說明。

使用量視窗關閉後如何繼續工作

訂閱使用量以 5 小時滾動視窗管理，而它偏偏會在下午工作最集中時關閉。升級更高方案也不會讓它立即重新開放。實際上有三種選擇。

第三種方式不必取消訂閱即可使用。只有在以下兩行設定生效期間才會按量計費，刪除變數後就會恢復使用訂閱。若沒有金鑰，請先前往取得 Claude API 金鑰。

# 사용량 창이 닫혀도 작업을 이어가는 두 줄.
# 이 변수가 설정된 동안에만 종량제로 청구되고, 지우면 구독으로 돌아갑니다.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# 클로드 코드의 기본 모델과 opus 별칭은 최신 Opus를, sonnet 별칭은 Sonnet 5.5를
# 가리킵니다. Kunavo가 제공하지 않는 모델(Sonnet 5.5, 아직 들어오지 않은 새 Opus)을
# 요청해 404가 나지 않도록 모델을 고정합니다. sonnet을 고정하지 않으면 /model sonnet,
# opusplan의 실행 단계, model: sonnet으로 지정한 서브에이전트가 404를 받습니다.
# opus 별칭에 고정한 Opus 5.5는 Claude Code v2.1.280 이상이 필요합니다
# (이전 버전이면 먼저 claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5

# 보조 작업을 가장 싼 모델로 넘기는 한 줄 (매 세션 효과가 있습니다)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

費率直接取自目錄：Claude Sonnet 5 每 1M token 為 $1.40／$7.00，Claude Haiku 4.5 為 $0.70／$3.50。費用從預付餘額扣除，因此沒有使用的月份不會產生帳單。訂閱與按量計費哪一種較便宜，以及損益平衡點計算，請參閱Claude Code 費用；使用韓國卡付款受阻時的解決方式，請參閱Claude API 價格與付款；使用量視窗的結構本身，請參閱Claude Pro 限制。

讓結果變好的請求與變差的請求

最後是最能體現使用方式差異的部分。附上檔案路徑可減少探索所需的 token，讓結果更快更準確——「修正驗證邏輯」不如「將 src/api/user.ts 的驗證邏輯改用 zod」。

另外不要一次丟出大型工作。拆成變更 → 測試 → 下一個變更，失敗時就能清楚知道回到哪個節點。發生錯誤時的判斷方式，請參閱Claude Code 錯誤整理。

如果想以相同方式使用 OpenAI 方面的程式碼代理，Codex 使用方法整理了不使用 ChatGPT 方案、改以 API 金鑰執行 Codex CLI 的步驟。

常見問題