一、安装（三选一，不要叠加）
方式 A：官方原生安装（推荐）
Mac / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
方式 B：包管理器安装
Mac（稳定版）
brew install --cask claude-code
Mac（最新版，尝鲜用）
brew install --cask claude-code@latest
Windows
winget install Anthropic.ClaudeCode
方式 C：npm 备用安装（需 Node.js 18+）
npm install -g @anthropic-ai/claude-code
⚠️ 三种方式任选其一，不要叠加，避免 PATH 冲突。新用户优先选 A 或 B。
二、前置依赖
Mac：若走 Homebrew 路线，先装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
出现 Press RETURN/ENTER to continue 时按回车，会自动安装 Xcode Command Line Tools。
Windows（原生环境推荐）：装 Git for Windows，让 Claude Code 可调用 Git Bash
winget install Git.Git
在 WSL2 里运行 Claude Code 则不需要装 Git for Windows。
三、验证安装
claude --version
claude doctor
能输出版本号和诊断结果即安装成功。
四、接入模型
Claude Code 官方登录需要 Claude Pro / Max / Team / Enterprise 订阅，或 Claude Console API 账号；免费 Claude.ai 账号通常不可用。国内用户可通过兼容 Anthropic API 的中转服务接入，根据中转服务认证方式选一种。
⚠️ 如果你打算使用官方账号登录（
/login），请不要设置ANTHROPIC_BASE_URL/ANTHROPIC_API_KEY/ANTHROPIC_AUTH_TOKEN这三个变量，否则 Claude Code 会优先走中转、跳过官方登录流程。已设置过的请先unset或在系统环境变量里删除，再重启终端。
方式 A：Bearer Token 认证（Authorization: Bearer 头）
export ANTHROPIC_BASE_URL="https://你的中转地址"
export ANTHROPIC_AUTH_TOKEN="你的Key"
方式 B：标准 API Key 认证（X-Api-Key 头）
export ANTHROPIC_BASE_URL="https://你的中转地址"
export ANTHROPIC_API_KEY="你的Key"
Mac / Linux 持久化（按 shell 选 ~/.zshrc 或 ~/.bashrc）
API Key 方式（X-Api-Key）：
echo 'export ANTHROPIC_BASE_URL="https://你的中转地址"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的Key"' >> ~/.zshrc
source ~/.zshrc
Bearer Token 方式：
echo 'export ANTHROPIC_BASE_URL="https://你的中转地址"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的Key"' >> ~/.zshrc
source ~/.zshrc
bash 用户把 ~/.zshrc 换成 ~/.bashrc 即可。
Windows PowerShell 持久化
API Key 方式（X-Api-Key）：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://你的中转地址", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的Key", "User")
Bearer Token 方式：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://你的中转地址", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的Key", "User")
设置后重启终端生效。
不同中转服务对模型名、beta header、tool use、streaming 的支持不同。若遇
400/model not found/tool_use等报错，请按中转服务文档调整，必要时设置ANTHROPIC_MODEL等变量。
五、写好 CLAUDE.md
进入项目根目录新建 CLAUDE.md：
## 关于我
[姓名 / 身份 / 职业背景]
## 项目用途
我用 Claude Code 做 [用途1] 和 [用途2]。
## 思维原则
- 回到问题本质，不要谄媚、不要敷衍、不要用"这是个好问题"开场
- 方案有问题直接指出，更优做法直接说
## 工作约束
- 新项目先写 CLAUDE.md，新目录先定结构约定
- 已有规范严格遵守，要改先改文档再改代码
## 沟通方式
- 默认中文，代码 / 命令 / 变量名用英文
- 结论先行，再讲理由
## 红线操作：必须先问我
- 删除文件或目录
- 修改 git 历史
- 修改 .env / token / CI/CD 配置
- 数据库 schema 变更或迁移
- git push / rebase / reset --hard / 强推
- 安装全局依赖或修改系统配置
- 公开发布（npm publish、生产部署、发文章等）
## 工程纪律
- 改完主动跑验证
- 密钥 / token 不进代码、不进 commit、不进日志
- 大改动先用 Plan Mode 出方案，确认后再执行
⚠️ CLAUDE.md 是行为指令，不是强制安全策略。Claude 会尽量遵守但不保证 100%。关键项目请配合 Claude Code 的 permissions、hooks，以及 Git 分支保护和 CI 权限控制。
六、启动
在项目根目录执行：
claude
首次启动按提示登录，或使用已配置好的 API 环境变量。
完成，开干。