Claude Code 使用指南
一、安装 Claude Code（支持 macOS / Linux / Windows）
根据你的系统选择对应方式👇
🟢 macOS / Linux / WSL
在终端执行：
curl -fsSL https://claude.ai/install.sh | bash
🔵 Windows PowerShell
打开 PowerShell，执行：
irm https://claude.ai/install.ps1 | iex
🟡 Windows 命令提示符（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
1️⃣ 安装过程说明
以上命令会自动完成：
- 下载 Claude Code CLI
- 安装到本地用户目录
- 配置基础运行环境
- 后续自动更新（无需手动升级）
2️⃣ 必备依赖（重要）
所有平台建议提前安装：
- Git
否则可能出现：
- 安装失败
- 无法正常运行 CLI
3️⃣ 验证安装是否成功
执行：
claude
如果出现 CLI 界面或提示登录，说明安装成功。
二、配置环境变量（Windows 常见问题）
👉 macOS / Linux 一般无需配置
👉 Windows 有概率需要手动处理
1️⃣ 出现以下报错才需要配置
'claude' 不是内部或外部命令
2️⃣ 添加 Path
将以下路径加入系统环境变量：
C:\Users\你的用户名\.local\bin
例如：
C:\Users\Acer\.local\bin
3️⃣ 配置步骤
- 右键「此电脑」
- 属性 → 高级系统设置
- 环境变量
- 编辑 Path
- 新增路径
- 保存
4️⃣ 必须注意
- 修改后必须重新打开终端
- 或直接重启电脑（最稳）
三、登录 Claude Code
1️⃣ 启动 CLI
claude
2️⃣ 登录方式
首次运行会提示登录：
- 自动打开浏览器
- 登录 Claude 账号
- 授权 CLI
3️⃣ 手动登录命令（可选）
/login
4️⃣ 登录成功标志
终端显示：
You're now logged in as xxx
5️⃣ 说明
- 登录信息会保存在本地
- 下次无需重复登录
- 可用
/login切换账号
四、进入项目目录（必须）
Claude Code 是基于项目上下文工作的 AI，必须进入工程目录。
1️⃣ 示例（Unity 项目）
cd D:\UnityProject\YourGame
2️⃣ 验证是否正确
dir
Unity 项目必须包含：
- Assets
- Packages
- ProjectSettings
3️⃣ 常见错误
❌ 在桌面运行
👉 Claude 无法理解项目
❌ 在子目录运行（如 Assets）
👉 分析不完整
五、初始化项目（核心步骤）
1️⃣ 执行命令
/init
2️⃣ 作用说明
该命令会：
- 扫描项目结构
- 识别技术栈（Unity / C#）
- 生成规则文件（CLAUDE.md）
3️⃣ CLAUDE.md 是什么
👉 Claude 的“项目记忆”
包含：
- 项目结构
- 编码风格
- 技术约束
4️⃣ 为什么必须执行
不执行 /init 会导致：
- 代码偏 Demo
- 不符合项目架构
- 需要大量人工修改
六、补充项目规则（决定效果上限）
👉 这是最关键的一步
1️⃣ 打开 CLAUDE.md
在项目根目录找到该文件并编辑
2️⃣ 推荐补充（Unity 高性能项目）
# Project Rules
## UI系统
- 使用 UGUI
- 列表必须使用 OSA
- 禁止手写 ScrollRect 复用
## 资源管理
- 使用 ResmgrNative
- 禁止 Resources.Load
- 必须支持资源释放
## 下载系统
- 使用 DownTask + DownTaskRunner
- 支持断点续传
## 输入系统
- 支持 PC + Mobile
- 必须记录 fingerId
## 性能规范
- 禁止 LINQ
- 禁止 Update 中 new
- 必须无GC Alloc
## 数学系统
- 使用定点数
- 禁止 float 参与核心逻辑
3️⃣ 强烈建议增加一句
生成代码前必须优先考虑性能和GC问题
4️⃣ 为什么这一步最重要
Claude Code 的效果取决于：
模型能力 × 项目上下文 × 规则质量
👉 你唯一能控制的是：规则质量
✅ 总结
1. 安装 Claude Code（跨平台）
2. 配置环境变量（Windows）
3. 登录账号
4. 进入项目目录
5. 执行 /init
6. 补充 CLAUDE.md 规则（最关键）
浙公网安备 33010602011771号