Cách dùng Claude Code — 4 việc cần làm sau bài hướng dẫn nhập môn

Có rất nhiều bài viết giải thích cách sử dụng Claude Code, nhưng hầu hết đều kết thúc ở bước “cài đặt và chạy lần đầu”. Vấn đề thực sự bắt đầu sau đó — bạn phải viết cùng một chỉ dẫn mỗi lần, có quá nhiều hộp thoại xác nhận, rồi chạm giới hạn sử dụng 5 giờ giữa chừng. Trang này bắt đầu từ nơi các bài hướng dẫn nhập môn kết thúc và lần lượt xử lý cả 3 vấn đề đó.

Trước hết, Claude Code không phải là “một công cụ để dán mã vào cuộc trò chuyện”, mà là một tác nhân hoạt động trong kho mã thông qua terminal. Nó đọc tệp, chỉnh sửa, chạy kiểm thử và thậm chí tạo commit. Vì vậy, điều đầu tiên cần làm không phải là học cách sử dụng, mà là cung cấp các quy tắc của dự án.

3 bước đầu tiên — khởi chạy, /init, yêu cầu cụ thể

Chỉ có 3 việc đáng làm ngay sau khi cài đặt. Đặc biệt, nếu bỏ qua bước thứ hai, /init, bạn sẽ phải lặp lại cùng một phần giải thích trong mọi phiên làm việc sau đó.

# 1. プロジェクトのディレクトリで起動する（ここが全ての前提）
cd ~/work/my-app
claude

# 2. 最初の一手は /init — リポジトリを読んで CLAUDE.md を書き出す
> /init

# 3. 以降は普通の日本語で頼む。ファイル名を添えるほど精度が上がる
> src/api/user.ts のバリデーションを zod に置き換えて、テストも直して

/init đọc kho mã và tạo CLAUDE.md. Nội dung được tạo chỉ là bản nháp, vì vậy hãy luôn tự chỉnh sửa thay vì để nguyên. Phần tiếp theo sẽ nói về nội dung đó.

CLAUDE.md — chỉ viết một lần những điều bạn vẫn phải giải thích mỗi lần

CLAUDE.md là tệp Markdown được đặt ở thư mục gốc của dự án và tự động được đọc trong mỗi phiên. Chỉ nên ghi ở đây những điều “không thể hiểu được chỉ bằng cách đọc mã”.

# 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/ — 生成物。手で編集しない。

Ngược lại, cũng có những thứ rõ ràng là không nên ghi. Cấu trúc thư mục và phần giải thích hàm có thể biết được bằng cách đọc mã nên không cần thiết. Vì CLAUDE.md được đưa vào mọi yêu cầu, tệp dài sẽ chắc chắn tiêu tốn token — hãy viết ngắn gọn, chỉ ghi các quy ước. Commit vào git sẽ giúp áp dụng cùng một bộ quy tắc cho toàn đội.

Quyền — giảm số lần xác nhận, nhưng đừng bỏ qua quá nhiều

Mỗi lần chỉnh sửa tệp hoặc thực thi lệnh đều yêu cầu xác nhận. Đây là cơ chế an toàn, nên cách cân bằng trong thực tế là không tắt toàn bộ mà “chỉ cho phép các thao tác đọc và xác minh”. Nếu chọn “Always allow” trong phiên, lựa chọn này sẽ được ghi nhớ; ghi vào .claude/settings.json sẽ cố định nó ở cấp dự án.

Cũng có cờ bỏ qua mọi xác nhận, nhưng khi đó cả thao tác xóa và push lên remote cũng được thực hiện mà không cần xác nhận. Chỉ nên dùng trong container có thể bỏ đi khi hỏng hoặc trong worktree dùng một lần. Tiêu chí quyết định và cách sử dụng an toàn được tổng hợp tại Cách sử dụng --dangerously-skip-permissions.

Lệnh tùy chỉnh — không viết cùng một cách yêu cầu mỗi lần

Các tác vụ gần như luôn yêu cầu cùng một cách thức, chẳng hạn như review, kiểm tra trước khi phát hành hoặc định dạng thông điệp commit, có thể được chuyển thành lệnh. Chỉ cần đặt tệp Markdown vào .claude/commands/.

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

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

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

Sau đó, chỉ cần nhập /review src/api/user.ts là bạn sẽ nhận được bài review theo cùng một tiêu chí. Commit vào git giúp chia sẻ trong nhóm và đặt chính tiêu chuẩn review vào kho mã. Các mẫu lệnh hữu ích trong thực tế được giải thích chi tiết bằng tiếng Anh tại Claude Code workflows.

Cách tiếp tục khi cửa sổ 5 giờ đóng lại

Hạn mức sử dụng gói đăng ký được quản lý theo cửa sổ trượt 5 giờ và có thể đóng vào buổi chiều khi công việc đang chạy tốt. Việc nâng cấp gói cũng không mở lại ngay tại thời điểm đó. Về cơ bản có 3 lựa chọn.

Có thể làm cách thứ ba mà không cần hủy gói đăng ký. Chỉ trong thời gian 2 dòng sau được thiết lập, bạn sẽ bị tính phí theo mức sử dụng; xóa các biến này sẽ đưa bạn về gói đăng ký ban đầu.

# 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

Mức giá được tải trực tiếp từ danh mục: Claude Sonnet 5 có giá $1,40 / $7,00 cho mỗi 1M token, còn Claude Haiku 4.5 có giá $0,70 / $3,50. Chi phí được trừ từ số dư trả trước, nên tháng không sử dụng sẽ có hóa đơn bằng 0. Tại Giá Claude Code, chúng tôi tính xem gói đăng ký hay tính phí theo mức sử dụng rẻ hơn, chi phí thực tế cho mỗi bước và điểm hòa vốn. Cơ chế của cửa sổ được giải thích tại Giới hạn Claude Pro, còn việc chọn mô hình mặc định được đề cập tại Sự khác biệt giữa Opus và Sonnet.

Cách yêu cầu giúp tăng độ chính xác và cách làm giảm độ chính xác

Cuối cùng, đây là phần thể hiện rõ nhất sự thành thạo trong cách sử dụng. Thêm tên tệp và đường dẫn sẽ giảm số token dùng để tìm kiếm, giúp kết quả nhanh và chính xác hơn — thay vì “sửa phần xác thực”, hãy nói “thay phần xác thực của src/api/user.ts bằng zod”.

Ngoài ra, đừng gửi yêu cầu lớn trong một lần. Chia thành thay đổi → kiểm thử → thay đổi tiếp theo sẽ giúp bạn biết rõ cần quay lại đâu nếu thất bại. Việc phân tích lỗi khi xuất hiện lỗi được tổng hợp trên các trang riêng như Lỗi 401 của Claude Code.

Nếu muốn thử cùng cách làm với tác nhân của OpenAI, Cách sử dụng Codex tổng hợp quy trình chạy bằng khóa API mà không cần gói ChatGPT.

Câu hỏi thường gặp