Claude Code 使用方法 — 从入门文章结束的地方开始

关于 Claude Code 使用方法的文章很多，但大多数都在“安装并收到第一条响应”处结束。 真正容易卡住的是之后：每次都要重复相同的说明，确认窗口出现得过于频繁，工作正进行到一半时 5 小时使用量窗口却关闭了。本文从入门文章结束的地方开始，依次整理这三个问题。

先统一一个前提。Claude Code 不是把代码粘贴到聊天窗口中的工具，而是常驻于终端和代码仓库中的代理。它会读取和修改文件、运行测试，甚至提交代码。因此，开始时要做的不是背诵用法，而是把项目规则交给它。

前三个步骤——运行、/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 会随每个请求一同发送，所以越长越消耗令牌——保持简短，只写规则。提交到 git 后，整个团队都会应用相同的规则。

权限——减少确认窗口，但不要全部关闭

每次修改文件或运行命令时都会出现确认窗口。这是安全措施，因此实际工作中应在不全部关闭的前提下，仅允许读取和验证类操作。在会话中选择“始终允许”后会被记住，写入 .claude/settings.json 后则会固定应用于项目。

虽然有跳过所有确认的标志，但这样连删除和远程 push 都会无需确认。只能在损坏后也可以丢弃的容器或一次性工作树中使用。使用判断标准已整理在 何时使用 --dangerously-skip-permissions 中。

自定义命令——不必每次都输入相同的请求

代码审查、发布前检查、整理提交消息等几乎每次都以相同方式请求的任务，都可以创建为命令。只需在 .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 个令牌为 $1.40 / $7.00，Claude Haiku 4.5 为 $0.70 / $3.50。费用从预付余额中扣除，因此没有使用的月份不会产生费用。订阅和按量计费哪种更便宜，以及盈亏平衡点计算，请参阅 Claude Code 价格；使用韩国银行卡无法支付时的解决方法请参阅 Claude API 价格与支付；使用量窗口本身的结构请参阅 Claude Pro 限制。

让结果变好的请求与让结果变差的请求

最后，这是使用方法差异体现得最明显的部分。附上文件路径 后，探索所需的令牌会减少，因此结果更快、更准确——相比“修复验证逻辑”，“将 src/api/user.ts 中的验证逻辑改为使用 zod”。

另外，不要一次性提出大型任务。将流程拆分为更改 → 测试 → 下一项更改，失败时就能明确知道回退位置。发生错误时的区分方法请参阅 Claude Code 错误整理。

如果想以相同方式使用 OpenAI 方面的编码代理，Codex 使用方法整理了无需 ChatGPT 套餐、使用 API 密钥运行 Codex CLI 的步骤。

常见问题