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