Claude Code 完全入门指南 2026 | 从零到实战应用的 7 个步骤

“听说过 Claude Code，但不知道从哪里开始。”

这正是我第一次使用 Claude Code 时的感受。在终端输入 claude，能看到有什么在运行——但完全不知道该怎么把它融入日常开发中。

在这篇文章里，我将分享我从零开始到在实际工作中熟练使用 Claude Code 所做的一切，整理成 7 个清晰的步骤。如果你已经安装好了但不知道下一步怎么做，这篇指南就是为你准备的。

如果你不知道从哪里读起，可以按这个顺序走：

先把免费的 Claude Code Quick Reference Cheatsheet 放在手边
按本文的“最初 30 分钟”完成一次安全练习
如果卡在设置、权限或 CLAUDE.md，去产品列表对比 Setup Guide
如果每次都不知道怎么写 prompt，使用 50 Prompt Templates
如果你要做团队导入、流程设计或内容变现，查看中文咨询页

安装和认证方式会变化。本文按 2026 年 6 月 1 日的官方说明更新，并建议你在实际安装前同时打开 Anthropic Claude Code getting started docs 确认最新步骤。

最初 30 分钟应该做什么

新手最容易困惑的地方不是安装，而是“已经能运行了，下一步到底让它做什么”。最初 30 分钟不要直接改代码，先练习让 Claude Code 读项目、解释项目、给出小范围建议。

0-5 分钟：只选择一个练习项目

选择一个小型仓库，或者一个可以随时回滚的个人项目。如果必须在工作项目里尝试，先确认当前状态，再新建一个分支。

git status
git switch -c try-claude-code

先看 git status 是为了避免把已有的未提交修改混进去。Claude Code 很方便，但如果起点不清楚，后面就很难判断哪些差异是它造成的。

5-15 分钟：只让它阅读和解释

第一轮不要让它编辑文件，只让它解释。

claude -p "Read only README.md and package.json. Explain this project, how to run it, and which file I should inspect next."

这里的关键是“Read only”。范围越小，你越容易理解 Claude Code 的回答来自哪里。

15-25 分钟：做一次小范围代码审查

下一步只审查一个文件，并明确要求不要编辑。

claude -p "Read only src/utils/date.ts. Point out at most 3 possible bugs, naming issues, or missing tests. Do not edit anything yet."

这一步能训练你判断 Claude Code 的建议是否合理。先学会看建议，再让它动手改代码。

25-30 分钟：只决定一个下一步

最后，让 Claude Code 帮你把今天的任务缩小到一个。

claude -p "Based on the investigation above, suggest one safe next task for a beginner. Keep the reason short."

如果这 30 分钟结束后，你已经能启动 Claude Code、限制阅读范围、看懂它的解释，就已经足够了。第一天不需要完成大规模重构。

第一步：安装与初始配置

安装

npm install -g @anthropic-ai/claude-code

需要 Node.js 18 或更高版本。安装完成后，用 claude --version 确认版本号。

使用当前认证流程

截至 2026 年 6 月 1 日，官方推荐的新手流程是进入项目目录后运行 claude，再按浏览器中的登录流程完成认证。很多旧文章会先讲 API Key，但现在不要一上来就把 API Key 当成唯一入口。

cd your-project
claude

常见认证方式包括：使用 Anthropic Console 计费账号完成 OAuth 登录，使用包含 Claude Code 的 Claude App 订阅登录，以及企业环境下通过 Amazon Bedrock 或 Google Vertex AI 配置。

个人开发者最简单的路径就是进入项目目录后运行 claude，然后按提示登录。只有当团队安全策略或云环境明确要求时，才需要单独处理 API Key 或企业认证配置。

第一次验证

claude -p "Hello! Please introduce yourself."

如果这条命令能正常运行，配置就完成了。

第二步：创建 CLAUDE.md，让 Claude 了解你的项目

Claude Code 会自动读取项目根目录下的 CLAUDE.md。在这里写上项目信息，就不必每次都解释一遍了。

我最初写的 CLAUDE.md 非常简单：

# 项目名称

## 技术栈
- TypeScript + Node.js
- PostgreSQL (Prisma)
- React + Vite

## 常用命令
- 开发服务器：npm run dev
- 测试：npm test
- 构建：npm run build

## 规则
- 注释用中文书写
- 函数名使用英文 camelCase

就这些。Claude Code 就能理解”这个项目用 TypeScript，测试用 npm test 运行”。

我踩的第一个坑：没写 CLAUDE.md 就开始用，结果每次对话都得解释”这个项目是 TypeScript 的”。花 5 分钟在开头写好，之后所有对话都会顺畅很多。

第三步：选择你的第一批”练手任务”

一上来就挑战复杂任务，很容易产生”这比想象中难用”的感觉。建议从这个列表中选择开始：

入门任务清单（难度较低）

# 1. 请求代码解释
claude -p "Read src/auth/login.ts and explain what this file does"

# 2. 请求代码审查
claude -p "Review the code in src/utils/date.ts and tell me what could be improved"

# 3. 请它写测试
claude -p "Write unit tests for the getUserById function in src/api/users.ts"

# 4. 生成 README
claude -p "Create a README.md for this project"

这些任务都是”只读”或”新增文件”类型的操作。修改现有代码的任务，等熟悉了 Claude Code 之后再尝试会更稳妥。

第四步：区分对话模式和单次模式

Claude Code 主要有两种使用方式。

对话模式（`claude`）

cd my-project
claude

终端变成 REPL（交互式界面），可以进行多轮对话。适合边写代码边交流——“用这个意图来修改”、“还是撤回去吧”这类反复试验的场景。

单次模式（`claude -p "..."`）

claude -p "List every place in src/api/ that still has a TODO comment"

执行一次并返回结果。适用于脚本或 CI 调用。

我的使用规则：复杂实现工作用对话模式，调查、确认和定型工作用单次模式。

第五步：通过权限设置安全使用

由于 Claude Code 可以操作文件和执行命令，在初期配置好权限会让你更放心。

创建 .claude/settings.json：

{
  "permissions": {
    "allow": [
      "Read(**)",
      "Glob(**)",
      "Grep(**)",
      "Bash(npm run *)",
      "Bash(git log*)",
      "Bash(git diff*)",
      "Bash(git status*)"
    ],
    "deny": [
      "Bash(rm -rf*)",
      "Bash(git push --force*)"
    ],
    "ask": [
      "Write(**)",
      "Edit(**)",
      "Bash(git commit*)",
      "Bash(git push*)"
    ]
  }
}

这套配置的效果：

自动执行：读取文件、搜索、运行测试
每次确认：写入文件、git commit 和 push
永久禁止：rm -rf 和 git push --force

建议开始时把很多操作放在 ask 里，熟悉之后再逐步移到 allow。

新手最开始不要做的事

Claude Code 很强，所以新手最容易犯的错误是过早放大范围。下面这些事，至少在前几次练习时应该避免。

1. 不要一开始就要求大规模重构

“把这个项目整理好”这种 prompt 太宽了。Claude Code 可以读很多文件，也能给出看起来合理的修改，但新手很难评估差异是否真的安全。

先把范围缩小到一个文件、一个函数、一个测试。

claude -p "Read only src/api/auth.ts and explain possible issues in the login function. Do not edit anything."

2. 不要习惯性使用 `sudo npm install -g`

官方文档明确提醒，不要用 sudo npm install -g 安装 Claude Code，因为这可能带来权限问题和安全风险。如果遇到权限错误，先检查 Node.js 和 npm 的安装方式，而不是直接加 sudo。

3. 不要直接粘贴秘密信息

不要把 .env、生产 API Key、客户数据、内部 token 原样粘贴进去。需要讨论配置时，可以用脱敏后的示例。

claude -p "Review this .env.example structure and suggest missing comments. Do not use real secret values."

4. 不要不看 diff 就提交

Claude Code 修改文件后，一定自己看差异并运行相关验证命令。

git diff
npm test

“看起来能运行”和“只改了该改的地方”不是一回事。新手阶段尤其要把 git diff 和测试当成固定动作。

5. 不要把危险命令放进自动允许

git push --force、rm -rf、生产部署、数据库迁移这类操作，不要一开始就放进 allow。真的需要执行时，让人来确认。

第六步：学会高效发出指令

开始使用 Claude Code 后很快就会发现——指令的写法直接决定输出的质量。

糟糕的例子 vs. 好的例子

# ❌ 太模糊
claude -p "修复登录功能"

# ✅ 具体且范围明确
claude -p "
Fix the login function in src/api/auth.ts (around line 42):
- No handling when the password field is empty — should return a 400 error
- Error messages are English-only — return them in English and Chinese too
Follow the existing error handling pattern in src/utils/errors.ts
"

三个关键技巧：

明确文件名和行号 — 大幅减少探索时间
具体描述期望的行为 — “优化一下”没用
说明约束条件 — “遵循现有模式”、“不要碰其他文件”

第七步：融入每日工作流

掌握基础之后，把它融入日常开发中。以下是我实际每天使用的模式。

早上的确认工作

# 汇总昨天的提交内容
claude -p "Run git log --oneline -10 and give me a plain-English summary of what changed"

修 Bug 时

claude
# → 粘贴错误日志，说"看看这个错误日志，找出原因"

生成 PR 描述

claude -p "
Review the changes in git diff main...feature/add-search and write a GitHub PR description in markdown.
Include: purpose of the changes, implementation approach, and how to test it.
"

辅助代码审查

claude -p "
Review the changed files in this PR:
$(git diff --name-only main...HEAD)

Prioritize flagging any security issues and performance concerns.
"

常见的”初期障碍”与解决方案

障碍 1：“感觉很慢”

Claude Code 随着对话变长会越来越慢。每隔 30–60 分钟执行一次 /compact 来压缩对话历史。

# 在 Claude Code 的 REPL 里
/compact

障碍 2：“会尝试读取太多文件”

在指令里加上”不需要读其他文件”就能解决。

# 修改前
"Fix the bug in src/"

# 修改后
"Read only src/api/auth.ts and fix the bug there. You don't need to read any other files."

障碍 3：“担心费用”

默认使用高性能的 Opus 模型，但简单任务用 Sonnet 就足够了。

# 在会话中切换模型
/model claude-sonnet-4-6

总结：第一周要做的事

第 1 天：安装 + 编写 CLAUDE.md
第 2-3 天：尝试入门任务（代码解释、代码审查）
第 4-5 天：配置权限设置，尝试实际文件编辑
第 6-7 天：融入自己的工作流

用 Claude Code 的次数越多，“什么时候该用它”的直觉就越强。第一周从”请它解释代码”和”让它写测试”开始，然后逐步挑战更复杂的任务。

这个网站（claudecode-lab.com）完全由 Claude Code 运营——文章生成、翻译、部署全部每天自动化。一开始我也觉得”这真的可能吗？“——如今已经离不开 Claude Code 了。希望你也来试试看。

什么时候该看教材，什么时候该咨询

如果你读完本文就能顺利完成一次练习，暂时不用急着买任何东西。下一步应该根据你的卡点来选。

只是需要命令提醒和安全习惯：领取免费 Claude Code cheatsheet
想比较 Setup Guide、prompt 模板等资料：查看产品列表
每次写调试、审查、测试 prompt 都很慢：使用 50 Prompt Templates
团队导入、权限边界、发布流程或内容变现需要一起设计：进入中文咨询页

我的判断标准很简单：个人试用阶段先用免费资料；同一个流程反复出现时再买教材；一旦牵涉团队、生产环境或收入路径，就应该考虑咨询。