你将学到
- Claude Code的3种安装方式（npm / 原生脚本 / Homebrew）
- API密钥获取与配置（Anthropic Console + 第三方模型）
- CLAUDE.md项目初始化和第一个编程任务
1. 安装前准备
Claude Code 是 Anthropic 推出的终端 AI 编程助手，运行在命令行中。安装前请确认：
- Node.js 18.0+（如果用npm安装）— 终端运行
node -v检查 - Anthropic API 密钥 — 在 console.anthropic.com 申请
- Git（可选但强烈推荐）— 用于版本回退
2. 三种安装方式
方式一：npm 全局安装（推荐）
# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --versionnpm 是 Node.js 的包管理器，安装后 Claude Code 可以在任何目录下使用。
方式二：原生脚本安装（无需 Node.js）
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell 管理员模式)
irm https://claude.ai/install.ps1 | iex原生安装会下载独立的二进制文件，不需要 Node.js 环境。适合不想装 Node 的用户。
方式三：macOS Homebrew
brew install anthropic-ai/claude-code/claude-code3. 配置API密钥
安装完成后，需要配置 API 密钥才能使用。有两种方式：
方式一：环境变量（推荐）
# 临时生效（当前终端会话）
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
# 永久生效（写入 shell 配置文件 ~/.bashrc 或 ~/.zshrc）
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc方式二：首次启动时输入
第一次运行 claude 命令时，会提示输入 API 密钥，Claude Code 会加密保存在本地。
💡 省钱技巧：除了官方 Anthropic API，Claude Code 也支持接入 DeepSeek V4 等第三方模型，费用可降低50%以上。详见 Claude Code接入DeepSeek V4配置指南。
4. 初始化你的第一个项目
# 进入你的项目目录
cd my-project
# 启动 Claude Code
claude
# Claude Code 启动后，先让它了解你的项目
# 在交互界面中输入：
/init/init 命令会自动扫描项目结构，生成 CLAUDE.md 文件。这个文件是 Claude Code 的”项目记忆”——它告诉 AI 你的技术栈、编码规范、常见坑，让后续每次对话都更精准。
5. 完成第一个AI编程任务
Claude Code 配置完成后，试试让它帮你写第一个功能。在交互界面中输入：
# 方式1：直接描述需求
帮我写一个 Python 脚本，读取 data.csv 文件并输出统计摘要
# 方式2：引用文件（更精准）
@src/utils.py 给这个文件的所有函数添加类型注解和 docstring
# 方式3：Plan模式（复杂任务推荐）
按 Shift+Tab 切换到 Plan 模式，让 AI 先出方案Claude Code 会自动读取项目文件 → 分析上下文 → 生成代码 → 写入文件，你只需要审核结果。如果发现不对，双击 Esc 即可回退。
6. 常见安装问题
| 问题 | 原因 | 解决 |
|---|---|---|
claude: command not found | npm全局路径未加入PATH | 运行 npm config get prefix 确认路径，加入PATH |
| API密钥报401错误 | 密钥无效或过期 | 去 console.anthropic.com 重新生成 |
| Windows安装失败 | PowerShell执行策略限制 | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
| Node版本过低 | Node.js < 18.0 | 用 nvm install 20 升级Node版本 |
7. 总结
- 安装：推荐 npm 全局安装，一行命令搞定
- 配置：设置 ANTHROPIC_API_KEY 环境变量最简单
- 初始化：进项目目录跑
/init生成 CLAUDE.md - 开始用：直接描述需求，Claude Code 自动读文件、写代码
📬 获取更多AI编程技巧
每周分享AI编程实战技巧，点此订阅。
相关文章
- Claude Code小白入门全教程 — 从零上手AI编程
- Claude Code接入DeepSeek V4配置指南 — 省50%API费用
- 5个Claude Code实用技巧 — 效率翻倍
- Claude Code vs Codex深度对比 — 哪个更适合你