Claude Code 使用方法 — 入門文章之後要做的 4 件事

介紹 Claude Code 用法的文章很多，但大多都在「安裝並執行第一次」時結束。 真正開始遇到問題是在那之後——每次都重複輸入相同指示、確認對話框太多，以及工作途中遇到 5 小時使用限制。本頁從入門文章結束的地方開始，依序處理這 3 個問題。

首先，Claude Code 不是「把程式碼貼到聊天中的工具」，而是住在終端機與儲存庫中的代理程式。它會讀取和修改檔案、執行測試，甚至完成提交。因此首先該做的不是學會操作方法，而是交代專案規則。

最初 3 步——啟動、/init、具體請求

安裝完成後，值得立即做的只有這 3 件事。尤其跳過第二項 /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（1 ファイルだけなら npm test -- path/to/file）
- 型チェック: npx tsc --noEmit
- Lint: npm run lint

## 決めごと
- 日付は必ず date-fns。moment は使わない。
- API ハンドラは app/api/**/route.ts のみ。lib に書かない。
- コミットメッセージは日本語、prefix は feat / fix / docs。

## 触ってはいけない場所
- db/migrations/ — 生成物。手で編集しない。

反過來說，不該寫的內容也很明確。目錄結構和函式說明讀程式碼就能知道，因此不需要。CLAUDE.md 會加入每次請求，寫得太長必然消耗 token——保持精簡，只寫規則。提交到 git 後，全隊都會遵循相同規則。

權限——減少確認次數，但不要跳過太多

每次修改檔案或執行指令時都會要求確認。這是安全裝置，因此實務上的折衷做法不是全部關閉，而是「只允許讀取與驗證類操作」。在工作階段中選擇「一律允許」後會被記住，寫入 .claude/settings.json 後則可固定為專案層級。

也提供可跳過所有確認的旗標，但連刪除或推送至遠端都會不經確認。只能在即使損壞也可丟棄的容器或一次性工作樹中使用。判斷標準與安全用法整理在 --dangerously-skip-permissions 的使用時機。

自訂指令——不要每次都重複相同要求

像審查、發布前檢查、整理提交訊息這類幾乎每次都用相同方式提出要求的工作，可以做成指令。只要在 .claude/commands/ 放入 Markdown 即可。

# .claude/commands/review.md — 置くだけで /review として使える
指定されたファイルをレビューして、次の 3 点だけ指摘してください。

1. 実際に落ちる条件があるバグ（再現手順を添える）
2. 既存のユーティリティで置き換えられる重複
3. テストが無い分岐

スタイルの好みは指摘しないでください。

如此一來，輸入 /review src/api/user.ts 就會得到以相同觀點進行的審查。提交到 git 後即可團隊共用，甚至能將審查標準本身放進儲存庫。實務上有效的指令範本，已在 Claude Code workflows 中以英文詳細說明。

5 小時視窗關閉時如何繼續工作

訂閱方案的使用額度由 5 小時滾動視窗管理，常會在下午工作進入狀態時關閉。即使升級方案，也不會當下立即重新開放。實際上有 3 個選擇。

第三種方法不必取消訂閱即可完成。只有在以下 2 行設定存在期間才會按用量計費，刪除變數後就會恢復原本的訂閱方案。

# 5 時間ウィンドウが閉じても作業を続けるための 2 行。
# この変数が設定されている間だけ従量課金になり、消せば元のサブスクに戻る。
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Claude Code の既定モデルと opus エイリアスは最新の Opus を、sonnet エイリアスは
# Kunavo が提供していない Sonnet 5.5 を指す。/model sonnet や opusplan の実行
# フェーズ、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

# 補助的な処理を一番安いモデルに逃がす 1 行（毎セッション効く）
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。費用會從預付餘額扣除，因此未使用月份的帳單是 0。訂閱方案與按量計費哪個更便宜、每一步的實際成本及損益平衡點，已在 Claude Code 價格 中計算。視窗本身的運作方式見 Claude Pro 限制，預設模型的選擇見 Opus 與 Sonnet 的差異。

會提升準確度的要求方式與會降低準確度的方式

最後是最能看出使用技巧差異的部分。附上檔名和路徑會減少探索所用的 token，讓結果更快、更準確——比起「修正驗證」，請說「將 src/api/user.ts 的驗證替換為 zod」。

此外，不要一次提出大型請求。拆成變更 → 測試 → 下一個變更，即使失敗也能清楚知道回到哪裡。錯誤發生時的排查方式，已整理在 Claude Code 的 401 錯誤 等個別頁面中。

如果想在 OpenAI 端的代理程式中嘗試相同流程，Codex 的使用方法 整理了不使用 ChatGPT 方案、直接以 API 金鑰執行的步驟。

常見問題