一、Claude Code 是什么
Claude Code 是 Anthropic 推出的终端原生 AI 编程助手，基于 Claude 4 系列大模型，支持 200k+ 超长上下文，可理解整个代码库、跨文件修改、执行命令、调试与提交代码，适合个人开发、项目重构、全栈生成与自动化脚本编写Anthropic。
简单说：你用自然语言说需求，它直接在你项目里写代码、改配置、跑命令、提交 Git。
二、前置环境要求（必须满足）
1）系统支持
macOS 10.15+
Linux（Ubuntu 18.04+、Debian 9+）
Windows 推荐 WSL2（原生支持有限）
2）软件依赖
Node.js 18+（必须）
Git（推荐）
终端：iTerm2 / Warp / Windows Terminal（WSL）
检查环境：
bash
运行
node --version
git --version
三、安装 Claude Code（三种方式任选）
方式 1：macOS / Linux 一键安装（推荐）
bash
运行
curl -fsSL https://claude.ai/install.sh | bash
自动下载二进制到 ~/.local/bin/claude
自动配置 PATH
安装完重启终端或：
bash
运行
source ~/.zshrc
或
source ~/.bashrc
方式 2：npm 全局安装（跨平台）
bash
运行
npm install -g @anthropic-ai/claude-code
方式 3：macOS Homebrew
bash
运行
brew install --cask claude-code
验证安装
bash
运行
claude --version
输出版本号即成功。
四、账号与认证（关键）
1）注册 Claude 账号
注册需：海外邮箱 + 海外手机号（接码平台可解决）
登录后升级 Claude Pro（$20 / 月） 解锁完整 Claude Code 功能。
2）本地认证（两种）
方案 A：账号登录（推荐，按订阅计费）
bash
运行
claude login
按提示输入邮箱密码，或直接浏览器授权。
方案 B：API Key（按量计费）
控制台创建 API Key（sk - 开头）
配置到本地：
bash
运行
claude config set api.key sk-xxxxxxxxxxxxxxxxxxxxxxxx
五、项目中启动 Claude Code
1）进入你的项目目录
bash
运行
mkdir my-demo && cd my-demo
2）启动会话
bash
运行
claude
首次启动会做初始化：
选择模型（Sonnet 4.5 / Opus 4.1）
确认权限（文件读写、命令执行）
生成 .claude/ 配置目录
启动成功界面：
六、基础使用（直接复制就能用）
1）创建一个 Python 接口
plaintext
帮我创建一个 FastAPI 项目，包含：
-
用户注册/登录接口
-
JWT 认证
-
SQLite 数据库
-
目录结构规范
2）重构整个项目
plaintext
把当前项目重构为：
-
分层架构：controller / service / mapper / config
-
统一异常处理
-
增加参数校验
-
保留原有功能
3）调试与修复 Bug
plaintext
运行项目，定位并修复启动时报的 500 错误，输出修复说明。
4）生成单元测试
plaintext
为 service 层所有类生成 JUnit5 单元测试，覆盖率 80% 以上。
5）执行 Git 流程
plaintext
创建 feature/login 分支，实现登录功能，写完后提交并推送到远程。
七、常用命令（速查）
bash
运行
启动会话
claude
查看配置
claude config list
设置参数
claude config set <key> <value>
模型测试
claude model test
清空会话
claude clear
升级版本
claude update
八、安全与权限（非常重要）
Claude Code 可读写文件、执行命令、访问网络，建议：
不要在生产服务器直接运行
重要项目先提交 Git，再让 AI 修改
开启沙箱模式（高危操作前询问）
bash
运行
claude config set sandbox_mode true
九、常见问题排查
1）command not found: claude
原因：PATH 未生效
解决：
bash
运行
source ~/.zshrc
which claude
2）认证失败 / 401
检查账号是否为 Claude Pro
或 API Key 是否正确、是否有额度
3）模型调用慢 / 超时
网络问题（需可访问 Anthropic 官方）
切换模型：claude config set model claude-sonnet-4-5
4）Windows 原生安装失败
推荐改用 WSL2 + Linux 安装方式
十、总结
Claude Code 是真正的项目级 AI 编程代理，部署只需：
准备 Node.js 18+
一行命令安装
登录 Claude Pro
项目目录执行 claude 开始开发
适合：快速原型、全栈生成、大型重构、自动化脚本、学习新框架。