介绍 Claude Code 用法的文章很多，但大多数都止步于“安装并运行第一次”。真正开始遇到问题是在那之后——每次都重复相同的指示、确认对话框太多，以及工作进行到一半遇到 5 小时使用限制。本页面从入门文章结束的地方开始，依次解决这 3 个问题。
首先，Claude Code 不是“把代码粘贴到聊天中的工具”，而是一个驻留在终端和仓库中的代理。它会读取文件、修改文件、运行测试，甚至提交 commit。因此首先应该做的不是学习用法，而是向它传达项目规则。
最初 3 步——启动、/init、具体请求
安装后值得做的只有这 3 件事。尤其是跳过第 2 步 /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 个选择。
| 选择 | 适用场景 |
|---|---|
| 等待窗口打开 | 没有截止时间，可以等待数小时 |
| 更改到更高套餐 | 每天都会遇到。额度持续不足 |
| 仅为这项工作切换到 API 密钥 | 今天必须完成，每月只遇到几次 |
第三种方式无需取消订阅即可实现。只有在下面两行处于设置状态期间，才会按量计费；删除变量后即可恢复原来的订阅。
# 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 密钥运行的步骤。
常见问题
开始使用 Claude Code 时首先应该做什么？
在项目目录中启动 claude，然后首先执行 /init。/init 会读取仓库并生成 CLAUDE.md。这是一个记录项目约定的文件（例如如何运行测试、使用哪些库、哪些文件不能修改），之后会在所有会话中自动加载。如果不先写好它就开始使用，你将不得不每次重复相同的指示。
CLAUDE.md 应该写些什么？
只写“每次都要解释的内容”。具体包括：测试和类型检查的执行命令；项目特有的约定（使用这个日期库、不要在这一层放置逻辑）；以及不得修改的生成文件路径。反过来，不要写那些读代码就能知道的内容。较长的 CLAUDE.md 会随着每次请求一并发送，必然增加成本，却不会提高准确性。
遇到 5 小时使用限制时该怎么办？
有 3 个选择：等待窗口重新开放、升级方案，或仅为这项工作切换到 API 密钥。第三种方式只需设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，不需要取消订阅。变量存在期间按 token 用量计费，删除后即可恢复原状。不想中断工作时，这是最快的方法。
可以减少每次都被问“可以执行吗”吗？
可以。在会话中选择“始终允许”后，权限会被记住；写入 .claude/settings.json 后，还可以按项目固定。预先允许 npm test 或 git status 等读取和验证类命令，可以大幅减少确认次数。虽然存在一次性跳过所有确认的标志，但除非是在隔离环境中，否则不要使用——它会连删除和推送也变成无需确认。
如何创建自定义命令？
只需在 .claude/commands/ 中放置 Markdown 文件。放入 review.md 后，就可以作为 /review 使用。内容可以是自然语言提示词。提交到 git 后，全团队都能使用相同命令，从而共享“每次都以相同方式请求的工作”，例如评审关注点或发布流程。
学习使用方法最有效的技巧是什么？
具体写出文件名和路径。“修复验证”不如“将 src/api/user.ts 中的验证替换为 zod”，因为后者减少了探索所需的 token，结果也更快、更准确。另一个技巧是不要一次性提交大型请求，而是拆成：修改 → 测试 → 下一次修改。这样失败时能明确知道返回到哪里。