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

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

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

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

---

第一步：安装与初始配置

安装

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

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

配置 API Key

Claude Code 使用 Anthropic 的 API。在 console.anthropic.com 创建账号并获取 API Key。

# 方式一：环境变量（推荐）
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# 方式二：首次运行 claude 命令时设置
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 后很快就会发现——指令的写法直接决定输出的质量。

糟糕的例子 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
"

三个关键技巧：

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

---

第七步：融入每日工作流

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

早上的确认工作

# 汇总昨天的提交内容
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 提速指南
• 将 Claude Code API 成本削减 90% 的完整指南
• Claude Code 安全最佳实践完整指南
• CLAUDE.md 最佳实践