本文从 0 到 1 安装 → 登录 → 新建项目 → 让 Claude 写代码 → 调试/常见坑 → 进阶玩法的顺序来写。你照着做就能跑起来。
0. 先说明：Claude Code 是什么？适合干啥？
Claude Code（有时也叫 Claude CLI / Codex 类似形态）是 Anthropic 出的命令行 AI 编程助手，让你在终端里直接让 Claude：
- 读/改你的项目代码
- 写新功能、修 bug、重构
- 帮你跑测试、定位报错
- 生成脚本、文档、配置等
它更像“能直接操作你仓库的 AI 同事”，比网页聊天更适合做真实项目开发。
1. Windows 使用前置条件（必须装）
1.1 安装 Node.js（必需）
Claude Code 是基于 Node 的 CLI，需要 Node 18+（推荐 LTS 20+）。
-
打开官网：
nodejs.org -
下载 LTS 版（建议 20.x LTS）
-
双击安装，全部 Next（默认就行）
-
安装完成后验证：
打开 PowerShell（Win+X → Windows PowerShell）输入：node -v npm -v能看到版本号就 OK。
1.2 安装 Git（强烈推荐）
Claude Code 会用 Git 来读项目历史、生成 diff、开 PR 等。
-
- 打开官网：
git-scm.com/download/wi… - 下载后一路 Next
git --version
- 打开官网：
1.3 选择终端（推荐 Windows Terminal）
你可以用：
- Windows Terminal（推荐）
- PowerShell
- VS Code 内置 Terminal
- Git Bash
建议装 Windows Terminal（Microsoft Store 搜索安装）。
2. 安装 Claude Code（Windows）
2.1 用 npm 全局安装
在 PowerShell 输入：
npm install -g @anthropic-ai/claude-code
如果你碰到权限问题（常见于公司电脑）：
- 用管理员权限打开 PowerShell 再执行 或
- 改用 npx 临时运行（后面会讲）
安装后验证：
claude --version
2.2 如果 npm 太慢（可跳过）
用国内镜像（可选）：
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
装完你也可以改回官方源：
npm config set registry https://registry.npmjs.org
3. 登录 / 配置 API Key
Claude Code 需要你的 Anthropic 账号和 Key，如果没有可以使用乘丰AI官网（api.cphone.vip。
3.1 获取 API Key
- 打开：api.cphone.vip
- 注册/登录账号
- 左侧 API 令牌 → Create Key
- 复制 Key（长得像
sk-xxxxxxxxx）
3.2 在 Windows 设置环境变量
在 PowerShell 里执行：
setx ANTHROPIC_API_URL "https://api.cphone.vip"
setx ANTHROPIC_API_KEY "你的Key"
或者：
$env:ANTHROPIC_BASE_URL = "https://api.cphone.vip"
$env:ANTHROPIC_AUTH_TOKEN = "你的Key"
注意：
setx设置后需要重新打开终端才生效- 不要带多余空格或引号嵌套
验证：
echo $env:ANTHROPIC_API_KEY
能输出你的 Key 就 OK。
4. 第一次运行 Claude Code
随便进入一个你想让 Claude 操作的目录，比如你的项目文件夹：
cd D:\projects\my-app
然后运行：
claude
第一次会：
- 检测当前目录是不是 Git 仓库
- 询问你是否允许 Claude 读取/改写文件
- 可能让你选默认模型
你照提示选 yes 就行。
5. 在项目里手把手用 Claude 写代码（核心）
进入 Claude CLI 后，你会看到一个类似聊天的界面。
5.1 让 Claude 先理解项目
输入：
先快速浏览项目结构，告诉我它的技术栈、入口文件、主要模块。
Claude 会自动：
- 列目录
- 读
package.json/README - 总结结构
5.2 让 Claude 写一个功能
你可以这样提需求：
在 React 前端里新增一个「用户列表」页面：
- 路由 /users
- 调后端 GET /api/users
- 表格展示 name/email/role
- 失败时显示 toast
请直接改代码并告诉我改了哪些文件。
Claude 会：
- 读现有路由/组件/请求封装
- 修改相关文件
- 给你 diff 和说明
5.3 让 Claude 修 bug
你只要粘贴报错：
我跑
npm test报错如下（贴错误日志）。
请定位原因并修复。
Claude 会：
- 读测试
- 找到失败点
- 修改代码
- 再建议你跑测试
5.4 让 Claude 重构
例子：
现在 src/utils/date.ts 有很多重复逻辑。
请重构成更清晰可维护的版本，保证所有单测仍通过。
6. Claude Code 常用命令/交互技巧
6.1 CLI 内部快捷指令
你在 Claude 的交互中可以用：
-
@file引用文件
例如：请看 @src/app.tsx 帮我加一个 loading
-
6.2 非全局安装的替代运行方式
如果你不想全局安装：
npx @anthropic-ai/claude-code7. Windows 常见坑和解决方案
7.1 claude 不是内部命令
原因：npm 全局 bin 没进 PATH。
解决：
1、找到 npm 全局目录：npm config get prefix2、把
prefix下的node_modules\.bin加进系统 PATH
3、重新打开终端验证。7.2 网络连不上 / 超时
公司网络常见。
-
试试开代理（系统代理/Clash/ZeroTier）
-
或用可访问 Anthropic 的网络环境
-
若你在中国大陆且无可用代理，Claude Code 会无法使用。
-
用管理员 PowerShell
-
或把项目放到你有权限的位置（比如 D 盘用户目录）
7.3 读/写文件权限不足
- 用管理员 PowerShell
- 或把项目放到你有权限的位置（比如 D 盘用户目录）
7.4 中文路径/空格路径异常
少数工具链对中文目录支持不好。
建议把项目放在纯英文路径，例如：D:\projects\my-app
-
@dir引用目录请扫一遍 @src/components 里所有组件 -
diff/show类提示给我展示 diff
8. 进阶玩法（真正提升效率）
8.1 让 Claude 先写计划再动手
你可以这样约束：
先给我一个分步骤计划（不改代码）。
我确认后你再开始改。
这样不容易跑偏。
8.2 结合 Git 做 PR
你可以说：
请按最佳实践新建一个 feature 分支，完成修改后总结变更，并给出 PR 描述。
Claude 会：
- 自动创建分支
- 给 commit 信息建议
- 输出 PR 模板
8.3 让 Claude 自动补测试
提示：
这个功能需要单测覆盖。
请补齐 Jest 测试并保证通过。
8.4 多任务协作
可以让 Claude 同时做几件事但要列优先级：
任务优先级：
修复登录 bug
重构 auth 模块
补测试
逐项完成，每项都先解释原因再改代码。
9. 最推荐的使用习惯
- 需求要写清楚（输入/输出/约束/边界）
- 让 Claude 先理解项目再写
- 每次改动后自己跑测试
- 用 Git 记录/回滚
- 大改动先要计划
10. 你可以直接照抄的「模板指令」
模板 1：启动理解项目
你现在在我的项目根目录。
请快速阅读 README、package.json 和关键入口文件，给出：
技术栈
目录结构说明
我应该从哪个入口理解业务
模板 2：加功能
需求如下：…
约束如下：…
请先给实现计划（不要改代码）。
我确认后你再修改，并展示 diff。
模板 3：修 bug
我遇到 bug：…
复现步骤：…
错误日志：…
请定位原因 → 提供修复 → 补测试 → 给出验证方式。
赶快去试试，1个星期的工作，1小时搞定。
