Claude Code 新手入门 2026：从零开始你的 AI 编程之旅

快速回答

Claude Code 是 Anthropic 推出的终端 AI 编程 Agent 工具。准备工作只需三步：安装 Node.js 18+，通过 npm 全局安装 Claude Code（npm install -g @anthropic-ai/claude-code），配置 API 密钥和网关地址。新手强烈推荐通过 TeamoRouter 统一网关接入，它能解决两大痛点：提示词缓存（Prompt Caching）命中率 >99%，让 Agent 循环成本直降 90%；以及全球可用，不受地区限制。安装完成后，在任意项目目录运行 claude 即可开始第一场 AI 编程会话。

什么是 Claude Code？

Claude Code 是 Anthropic 开发的命令行 AI 编程工具。与 Claude Web（浏览器聊天界面）不同，Claude Code 运行在你的终端里，拥有完整的文件系统访问权限、Git 历史读取能力和 Shell 环境操作能力。它能够阅读你的代码库、编辑文件、执行命令、创建提交和管理 Pull Request -- 全程由你监督。

你可以把它理解为住在终端里的一位 AI 结对程序员。你描述你想要构建或修复什么，Claude Code 会自主浏览项目、编写代码、运行测试，并持续迭代直到任务完成。它不仅仅是一个输出代码片段的聊天机器人，而是一个能真正在你代码库上干活的 Agent。

2026 年的核心能力包括：

全代码库感知： Claude Code 会索引你的项目，在动手修改前理解整体架构。
多文件编辑： 单次会话即可在项目全局范围内创建、修改和删除文件。
终端命令执行： 直接运行构建命令、测试、Linter 和 Git 操作。
Git 集成： 自动暂存修改、生成提交信息、创建分支和发起 PR。
MCP 服务器支持： 通过模型上下文协议连接数据库、API、网络搜索等外部工具。

对于新手来说，Claude Code 的体验就像一个资深开发坐在你旁边，一边写代码一边解释每一步的用意，而你始终掌握着对所有改动的最终决定权。

准备工作：安装前需要什么

1. Node.js 18 或以上版本

Claude Code 以 npm 包形式分发，依赖 Node.js。检查你的版本：

bash

node --version

如果尚未安装 Node.js，前往 nodejs.org 下载（推荐 LTS 版本），或使用版本管理器：

bash

# macOS / Linux：通过 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

# macOS：通过 Homebrew 安装
brew install node

2. 终端应用

macOS： 自带的「终端」或 iTerm2
Windows： Windows Terminal、PowerShell 或 Git Bash
Linux： 任意终端模拟器（GNOME Terminal、Konsole 等）

Windows 新手建议使用 Windows Terminal 或 Git Bash 以获得最佳体验。命令提示符（cmd）在交互式 CLI 场景下存在一些限制。

3. API 密钥

Claude Code 通过 API 访问 Claude 模型。你有两个选择：

Anthropic 官方直连： 在 console.anthropic.com 注册并创建 API Key。仅适用于 Anthropic 支持的地区。
TeamoRouter 统一网关（推荐新手使用）： TeamoRouter 提供一个 API Key 即可访问 Claude、GPT、Gemini 等多种模型。它内建提示词缓存（Agent 降本的关键）、统一账单面板，且全球可用，涵盖 Anthropic 未直接服务的地。注册地址：teamorouter.com。

我们强烈推荐新手走 TeamoRouter 路线。它能避免新手最高频的踩坑点 -- 因缓存失效导致 Agent 跑一圈账单爆炸 -- 并将配置简化到一组 API Key + Base URL 即可搞定。

4. 基础命令行操作能力

你不需要是命令行高手，但至少应该会：

切换目录（cd、ls）
运行命令并看懂输出
基础文件操作（不必须掌握 -- Claude Code 会帮你处理这些）

如果「终端」「命令行」这些词听上去很陌生，建议先花 15 分钟看一个终端入门教程。这点投入日后会带来巨大回报。

第一步：安装 Claude Code

Node.js 准备好后，一条命令即可完成安装：

bash

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

-g 表示全局安装，之后在任何目录都可以直接使用 claude 命令。

验证安装：

bash

claude --version

你应该看到类似 1.0.x 的版本号。如果提示 command not found，重启终端，或者检查 npm 全局 bin 目录是否在 PATH 中。

其他安装方式

Homebrew（macOS）： brew install claude-code（适用于已收录的 tap）
直接下载： Anthropic 在其 GitHub Releases 页面提供了部分平台的独立二进制包。
不全局安装： npx @anthropic-ai/claude-code 临时使用，无需安装。

新手推荐全局 npm 安装，最简单也最可靠。

第二步：配置 API 连接

这是最关键的一步，也是新手最常翻车的地方。Claude Code 需要知道使用哪个 API 端点以及用哪把密钥认证。

方案 A：TeamoRouter 网关（推荐新手）

如果你选择了 TeamoRouter，配置如下：

bash

# 设置 TeamoRouter API 密钥
export ANTHROPIC_API_KEY="tr-你的-teamorouter-key"

# 指向 TeamoRouter 的 Anthropic 兼容端点
export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"

要让配置永久生效（不用每次打开终端都重新输入），将其写入 shell 配置文件：

bash

# zsh（macOS 默认）：写入 ~/.zshrc
echo 'export ANTHROPIC_API_KEY="tr-你的-teamorouter-key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"' >> ~/.zshrc
source ~/.zshrc

# bash（Linux 默认）：写入 ~/.bashrc
echo 'export ANTHROPIC_API_KEY="tr-你的-teamorouter-key"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"' >> ~/.bashrc
source ~/.bashrc

为什么 TeamoRouter 更适合新手：

提示词缓存开箱即用： Claude Code 每轮对话都会重发长上下文。没有缓存的话，Token 消耗可暴涨 10 倍。TeamoRouter 在压测中缓存命中率 >99%，意味着大部分上下文被命中后仅按全价 10% 计费。
一把 Key 通吃所有模型： 日后你想尝试 Codex、Gemini CLI 或 Cursor，同一把 TeamoRouter Key 全部兼容，不用管理多个账户和账单。
全球可用： 无论你身在何处，包括 Anthropic 未直接覆盖的地区，都能稳定访问。

更多网关详情见 TeamoRouter AI API 网关。

方案 B：Anthropic 官方直连

如果你希望直接走 Anthropic 官方：

bash

export ANTHROPIC_API_KEY="sk-ant-你的-anthropic-key"
# 无需设置 ANTHROPIC_BASE_URL，默认走 api.anthropic.com

注意：Anthropic 直连有区域限制。如果你不在支持地区（如中国、部分亚洲和中东地区），必须使用网关或中转。TeamoRouter 可以无感解决这个问题。

第三步：你的第一次 Claude Code 会话

现在进入最激动人心的环节。打开终端，进入一个项目目录（或新建一个），启动 Claude Code：

bash

# 创建一个练习项目
mkdir my-first-claude-project
cd my-first-claude-project

# 初始化 git（Claude Code 在版本控制下工作效果最佳）
git init

# 启动 Claude Code
claude

Claude Code 以交互模式启动，显示提示符：

text

Claude Code v1.0.x
输入 /help 查看命令列表。

>

现在试试你的第一条提示词。新手建议从一个简单且结果可验证的任务开始：

"创建一个 Python 脚本 hello.py，打印 'Hello from Claude Code!' 和一个 5 到 1 的倒计时，然后运行它。"

Claude Code 会：

读取项目目录状态（当前为空）。
创建 hello.py 并写入代码。
运行 python hello.py 并展示输出。
询问你是否保留这些改动。

整个过程，Claude Code 的思考和操作都会打印在终端里。它每计划创建或修改一个文件、每计划运行一条命令，都会先展示出来，等你同意后才执行。

理解权限模型

Claude Code 的权限体系让你始终掌控全局：

读取操作（列出文件、阅读代码）通常自动放行。
写入操作（创建/修改文件）默认需要你确认。
命令执行（运行脚本、Git 操作）默认需要你确认。
网络访问（API 调用、安装包）默认需要你确认。

你可以在 ~/.claude/settings.json 中调整这些权限。新手建议保持默认设置 -- 它们在学习阶段保护你不被误操作伤到。

第四步：Claude Code 必备命令速查

Claude Code 使用斜杠命令来触发内置操作。以下是每个新手都应该掌握的：

核心命令

命令	功能
`/help`	查看可用命令和用法
`/clear`	开启全新对话（清空上下文）
`/compact`	压缩对话历史以节省 Token
`/review`	审查本次会话的所有改动
`/undo`	撤销最近一次改动
`/doctor`	检查 Claude Code 运行状态和配置

Git 集成命令

命令	功能
`/commit`	暂存改动并生成提交信息
`/pr`	基于当前改动创建 Pull Request
`/diff`	展示本次会话所有改动差异

配置命令

命令	功能
`/config`	打开配置文件
`/status`	显示当前会话状态、模型和 Token 用量
`/cost`	展示 Token 用量和预估费用

提示词命令

命令	功能
`/add-dir`	添加目录供 Claude Code 索引
`/init`	生成描述项目信息的 CLAUDE.md 文件

最重要的命令是 /help -- 遇到不确定的情况先用它看看。

写出高质量提示词的技巧

让 Claude Code 产出优质结果是一项可以训练的技能。以下原则对新手特别有效：

1. 描述要具体

坏提示："修一下 bug。" 好提示："auth.py 里的 login 函数在邮箱字段为空时会抛出 ValueError。请添加输入校验，在邮箱为空时返回清晰的错误提示。"

2. 提供上下文

告诉 Claude Code 哪些文件是关键、预期行为是什么。如果你的项目里有 CLAUDE.md（通过 /init 生成），Claude Code 会在每次会话开始时自动读取它作为全局上下文。

3. 从小处着手，逐步迭代

把大任务拆成小块。不要说"帮我搭建一个完整的电商后端"，而是从"创建用户表的数据表结构，包含 email、password_hash、created_at 字段"开始。

4. 让它解释思路

如果你正在学习，在提示词里加上"请边做边解释"。Claude Code 会详细叙述它的决策过程，这对新手来说是极好的学习方式。

5. 采用「规划-审查-执行」循环

规划： 让 Claude Code 先列出执行方案，不要直接写代码。
审查： 通读方案，提出调整需求。
执行： 确认方案后让 Claude Code 实施。
验证： 让 Claude Code 跑测试或演示结果。

示例：一次完整的新手工作流

text

# 1. 启动 Claude Code
claude

# 2. 先问方案
> 我想用 Express.js 搭建一个简单的 REST API，
  两个接口：GET /health 和 POST /echo。
  请先列出你的实现方案，不要直接写代码。

# 3. 审查方案后
> 方案没问题。请实现它，加上错误处理，
  再写一个用 curl 调两个接口的测试脚本。

# 4. 实现完成后
> 运行测试脚本，修掉发现的问题。

这种迭代方式让你对全局有充分把握，同时又能充分发挥 Claude Code 的编码能力。

新手常见问题与解决

"claude: command not found"

npm 全局 bin 目录不在 PATH 中。修正：

bash

# 找到 npm 全局安装目录
npm config get prefix

# 加入 PATH（按上面命令的输出调整路径）
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

"Authentication error" 或 "Invalid API key"

检查 API Key 是否有拼写错误（多余空格是高发元凶）。
在提供商后台确认 Key 状态为「启用」。
如果使用 TeamoRouter，确认同时设置了 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL。
运行 echo $ANTHROPIC_API_KEY 验证环境变量确实生效。

"Connection refused" 或超时

直连 Anthropic 的用户：检查网络和所在地区是否被支持。
TeamoRouter 用户：确认 Base URL 是否正确（https://api.teamorouter.com/anthropic）。可以试试 TeamoRouter 客户端，它内置连通性诊断。
如果你在企业内网或使用代理/VPN，可能需要额外配置代理设置。

会话消耗 Token 太多

定期使用 /compact 压缩长对话。
把大任务拆成多个短会话。
在 API 提供商后台确认提示词缓存确实生效（TeamoRouter 面板显示缓存命中率）。
在 API 提供商后台设置月度预算上限。

Claude Code 做了我不想要的改动

保持默认权限设置（写入和命令执行都需要确认）。
每次改动前仔细审查后再批准。
始终在 git 仓库中工作（先 git init），随时可以回滚。
/undo 命令可以撤销最近一次改动。

进阶：配置 CLAUDE.md 文件

当你对基础操作感到顺手后，在项目根目录创建一个 CLAUDE.md 文件。它告诉 Claude Code 你的项目规范、架构和偏好，并在每次会话自动加载。

生成方式：

bash

claude
> /init

或手动创建：

markdown

# 项目概览
这是一个 React + Express 电商应用。

# 编码规范
- 使用 TypeScript，不用 JavaScript
- 偏向函数组件 + Hooks
- 使用 Prettier 格式化（配置在 .prettierrc）
- 用 Vitest 写测试

# 架构
- /client：React 前端（Vite）
- /server：Express API
- /shared：两边共用的类型和工具函数

一份好的 CLAUDE.md 能极大提升 Claude Code 的输出质量，因为你不需要在每次提示词中重复解释项目规范。

完成首次会话后的下一步

完成一个真实的项目任务。 从实际工作中挑一个小事 -- 修一个 bug、加一个校验、写一个单测。真实任务比练习示例学得快得多。
配置 MCP 服务器。 通过模型上下文协议将 Claude Code 连接到你的数据库、任务看板或文档系统。建议从文件系统和网络搜索这两个最容易配的 MCP 服务器开始。
尝试不同模型。 Claude Code 支持多种 Claude 模型（Sonnet、Opus、Haiku）。不同任务用不同模型：日常编码用 Sonnet，复杂架构决策用 Opus，快速生成样板代码用 Haiku。
与编辑器搭配使用。 Claude Code 可以独立运行，但很多开发者在 VS Code 或 JetBrains 旁开一个终端跑它。终端工作流与编辑器内 AI 工具形成互补，而非替代关系。
探索 API 网关。 如果你起步时用了 Anthropic 直连 Key，可以考虑切到 TeamoRouter 获得统一访问、提示词缓存和全球可用性。如果你已经在用 TeamoRouter，试试添加第二款工具（如 Codex 或 Cursor）-- 同一把 Key 全部兼容。

想了解哪款 Claude 产品最适合你的工作流，可看 Claude CLI vs Claude Code vs Claude Web 对比。如果你在中国，参考 Claude 国内怎么用 2026 完整指南。

常见问题（FAQ）

不会编程能用 Claude Code 吗？

有基础编程知识帮助很大，但并非绝对必要条件。Claude Code 可以从自然语言描述中生成完整应用。然而，要审查它的输出、理解报错信息并对代码质量做出合理判断，还是需要一定的编程基础。建议零基础用户先学几周编程基础课，再上手 Agent 类工具。

Claude Code 免费吗？

Claude Code 本身是免费开源的。但你会为它调用的 Claude API 付费。费用取决于用量：一次典型编程会话在启用提示词缓存的情况下约花费 $0.50-$5.00。如果没有缓存（比如低质量中转站），费用可能飙升至 5-10 倍。使用能保障缓存命中率（>99%）的网关可以帮你把成本压在低位。详见 TeamoRouter AI API 网关的定价说明。

Claude Code 和 Claude Pro 有什么区别？

Claude Pro（$20/月）让你通过 Anthropic 的网页和移动应用使用 Claude，每月有固定消息上限。Claude Code 是独立的终端工具，走 API 计费（按 Token 付费）。Claude Code 在软件开发方面更强大，因为它有文件系统权限、能执行命令、能和 Git 配合。不少开发者两者都用：Claude Pro 用来快速提问和研究，Claude Code 用来上手写代码。

Claude Code 能在 Windows 上用吗？

可以。Claude Code 支持 Windows 10 和 11，通过 Windows Terminal、PowerShell 或 Git Bash 运行。npm 安装方式跨平台一致。部分 shell 相关特性（如 Git 集成）在 Git Bash 或 WSL（Windows Subsystem for Linux）下体验更佳，推荐 Windows 用户使用 WSL。

Claude Code 默认用哪个模型？

截至 2026 年，Claude Code 默认使用 Claude Sonnet 4，它在编程任务上的能力、速度和成本之间实现了最优平衡。可以通过 /model 命令或设置 ANTHROPIC_MODEL 环境变量切换模型。Claude Opus 4 适用于复杂架构和深度推理任务，单价更高。

团队成员能共用一把 API Key 吗？

技术上可以，但超过 2-3 人的团队不建议这样做。共用一把 Key 意味着共享速率限制、无法区分个人用量，且存在安全隐患。TeamoRouter 企业版支持多用户 Key，可为每名成员设置独立预算和使用追踪。专业团队请配置独立 Key 或企业网关账户。

Claude Code 卡住或犯错怎么办？

Claude Code 是 Agent，不是先知 -- 它会犯错。请始终在 Git 仓库中操作以便随时回滚。最近一次改动可用 /undo 撤销，大范围回滚用 git checkout .。权限系统（写入前询问、执行前询问）是你的安全网 -- 在对工具完全熟悉之前不要关闭它。

准备好接入了吗？登录控制台 · 购买额度 · 创建 API Key，三步即可开始。

获取 API Key 查看帮助文档