小白安装 Claude Code：1分钟直接跑通能用

先别管 API Key

这一页只做一件事：把 Claude Code 装到电脑里。

你现在只需要会三件事：

第一步：下载 Node.js

打开浏览器，进入 nodejs.org。

点击 LTS 版本下载。

Windows 用户：下载完成后双击安装包，一路点 Next。

Mac 用户：下载 macOS 安装包，按提示安装。

第二步：打开终端

Windows：点开始菜单，搜索 PowerShell，打开它。

Mac：打开 Terminal。

然后复制这一行到终端，按回车：

node -v

如果屏幕出现类似 v20.11.0 这样的版本号，说明 Node.js 装好了。

第三步：安装 Claude Code

如果你用的是 Windows PowerShell，复制这一行到终端，按回车：

npm.cmd install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

如果你用的是 Mac，复制这一行：

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

它会自己下载，等它跑完。

如果中途停住，先别乱改，把截图发给右下角小白。

常见红字：npm.ps1 被禁止运行

如果你看到这种红字：

无法加载文件 ... npm.ps1，因为在此系统上禁止运行脚本

这不是 Node.js 没装好，也不是 Claude Code 安装包坏了。

原因是 Windows PowerShell 的安全策略拦住了 npm 的脚本文件。

小白先用最简单的解决法：把命令里的 npm 改成 npm.cmd。

复制这一行重新执行：

npm.cmd install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

如果还是不行，再复制这一行，按回车：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

出现确认时输入 Y，再按回车。

然后重新执行安装命令。

常见红字：npx.ps1 被禁止运行

如果你先看到：

changed 2 packages in 2s

这说明 Claude Code 已经安装成功了。

如果后面你又输入了：

npx @anthropic-ai/claude-code --version

然后出现 npx.ps1 被禁止运行，不要继续折腾 npx。

原因是 PowerShell 又拦住了 npx.ps1。这里不需要 npx。

直接复制这一行验证：

claude --version

如果提示找不到 claude，关闭 PowerShell，重新打开，再执行：

claude --version

如果还是找不到，再复制这一行：

where.exe claude

第四步：确认安装成功

复制这一行到终端，按回车：

claude --version

如果屏幕出现版本号，说明安装成功。

现在该做什么

安装成功后，先启动一次 Claude Code，不要急着配置中转站，也不要急着买 Key。

复制这一行到终端，按回车：

claude

如果出现英文界面：

Choose the text style that looks best with your terminal

这不是报错，是让你选终端主题。默认选中的一般是 Dark mode。

直接按回车就行。

如果不小心选错了，以后在 Claude Code 里输入：

/theme

可以重新选择主题。

第一次打开后，先输入这句话：

请先告诉我你能做什么，不要修改我的文件。

如果你要在自己的项目里用，先进入项目文件夹，再启动：

cd 你的项目文件夹路径

claude

进入后先输入：

请先阅读这个项目，不要改文件，告诉我它是什么技术栈、主要目录和下一步建议。

启动后连不上 Anthropic 官方服务

如果你看到：

Unable to connect to Anthropic services

或者：

Failed to connect to api.anthropic.com

这不是安装失败。说明 Claude Code 已经打开了，但它默认去连接 Anthropic 官方服务，当前网络、地区或账号环境连不上。

国内新手先用 DeepSeek V4 的 Anthropic 兼容接口跑通。

Windows PowerShell 复制下面这一整段，把 sk-你的DeepSeek_API_Key 换成自己的 Key：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek_API_Key"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
claude

Mac / Linux / WSL 复制下面这一整段：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek_API_Key
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
claude

如果模型名不支持 deepseek-v4-pro[1m]，先把三处 deepseek-v4-pro[1m] 改成 deepseek-v4-pro；还不行就先用 deepseek-v4-flash 跑通。

如果你还没有 DeepSeek API Key，先去 platform.deepseek.com 创建一个。

点右下角小白，告诉它：

我已经装好 Claude Code，我是 Windows 还是 Mac，我想用它做什么。

小白会根据你的电脑和目标，继续给你下一步复制命令。

如果你想继续学到项目级

安装只是第 1 关。真正会用 Claude Code，要按下面 6 关走：

不要一上来让它“帮我做一个完整 App”。新手更稳的做法是：

先只读项目 -> 列计划 -> 改一个小功能 -> 看 diff -> 跑检查 -> 复盘成规则

Claude Code 进阶功能怎么理解

CLAUDE.md：项目说明书。告诉 Claude Code 这个项目怎么运行、不能动哪里、完成前要检查什么。

Hooks：硬性提醒或硬性检查。比如任务结束前必须提醒跑 typecheck、测试、构建或安全检查。

Skills：可复用工作方法。比如 UI 审计、教程改写、API 排错、资讯更新，可以沉淀成固定步骤。

插件 / MCP：给 Claude Code 接外部工具。比如浏览器、GitHub、Figma、数据库、飞书。先从只读权限开始。

子智能体：把任务分给不同角色。比如研究员只查资料，测试员只找风险，UI 助手只看页面问题。

自动化任务：适合定时检查、定时总结、定时更新，但涉及发送、删除、付款、上线时必须人工确认。

做项目 MVP 的新手模板

复制下面这段给 Claude Code：

我们做一个最小可用 AI 网页 App。

项目名称：
目标用户：
核心功能：
必须有的页面：
不做的功能：
验收标准：

请先输出 MVP 计划、文件改动范围和分阶段任务。
不要马上写代码。

等它给计划后，再让它按阶段做。每一阶段都要问：

最常见的项目级坑

它直接改了太多文件：停下来，让它把任务拆小，只保留本轮必须改的部分。

它说完成但页面打不开：让它先读报错，不要继续加功能。

API Key 写进代码：马上删掉，改成环境变量，并检查 git diff。

模型没有额度：先切换到便宜模型完成结构和页面，再用强模型处理复杂逻辑。

hooks 或插件装太多：先保留能解释清楚用途的，其他先不要装。

子智能体边界不清：每个子智能体只负责一种事，例如研究、测试、UI、文案，不要都给“全能助手”。

下一步

如果你只想安装，继续按本页做。

如果你想从安装学到做项目，去看：

/agent-install/claude-code

如果你已经装好了，直接做这个任务：

/missions/claude-code-deepseek-project

如果你要让它改真实项目，先做：

/missions/codex-small-feature