适用系统Windows / macOS / Linux预计耗时10 分钟目录Claude Code 是什么第一步安装 Node.js已有可跳过WindowsmacOSLinuxUbuntu/Debian第二步安装 Claude Code第三步配置 API Key二选一方案 A官方 Anthropic API需要付费订阅方案 B第三方兼容 API推荐国内用户1. 创建配置文件2. 验证配置第四步基本功——三条必学命令1. 一问一答模式最常用2. 进入项目干活3. 代码审查4. 交互模式多轮对话第五步常用参数速查常见问题排查claude命令找不到安装报EACCES权限错误运行时提示未设置ANTHROPIC_API_KEYnpm 安装太慢 / 卡住用 DeepSeek 等第三方 API 时提示权限错误Windows 终端乱码进阶CLAUDE.md 项目记忆文件总结Claude Code 是什么Claude Code是 Anthropic 推出的命令行 AI 编程助手。你只需要在终端里用自然语言描述你要做什么它就会自动读文件、写代码、跑命令、修 bug——像一个不知疲倦的程序员副手。第一步安装 Node.js已有可跳过Claude Code 通过npm分发npm 随 Node.js 一起安装。打开终端先检查你装过没有node--versionnpm--version看到类似v20.x.x就说明已经有了直接跳到第二步。Windows浏览器打开nodejs.org点击左边绿色的LTS按钮下载双击.msi安装包一路Next → Install → Finish按Win R输入cmd回车输入上面两条验证命令macOS官网安装同 Windows去 nodejs.org 下 LTS 版.pkg。Homebrew 安装推荐# 没装过 Homebrew 的话先装/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 装 Node.jsbrewinstallnodeLinuxUbuntu/Debiancurl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-sudoapt-getinstall-ynodejs第二步安装 Claude Code打开终端一行命令搞定npminstall-ganthropic-ai/claude-code验证安装claude--version看到版本号如v2.x.x说明装好了 ✅第三步配置 API Key二选一方案 A官方 Anthropic API需要付费订阅如果你有 Anthropic 的Pro / Max / Enterprise订阅直接运行claude第一次会弹浏览器让你登录 Anthropic 账号登录完终端就进交互界面了。方案 B第三方兼容 API推荐国内用户如果你用的是DeepSeek、OpenRouter等兼容 Anthropic API 的服务需要创建配置文件。api-key获取方式deepseek api-key: 点击进入deepseek平台注册账号进入到看到左边导航栏有api-key点击创建即可。1. 创建配置文件Mac / Linuxmkdir-p~/.claude创建文件~/.claude/settings.json写入{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:sk-你的API密钥,ANTHROPIC_MODEL:deepseek-v4-pro,ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-v4-flash,ANTHROPIC_DEFAULT_SONNET_MODEL:DeepSeek-V4-pro,ANTHROPIC_DEFAULT_OPUS_MODEL:DeepSeek-V4-pro}}Windows在文件资源管理器地址栏输入%USERPROFILE%进入用户目录新建文件夹.claude在里面新建文件settings.json内容同上。2. 验证配置claude-phello如果能正常返回一段问候语配置成功了。第四步基本功——三条必学命令1. 一问一答模式最常用claude-p你的问题-p是print 模式问一个问题Claude 回答完就退出干净利落。试试看claude-p用 Python 写一个计算斐波那契数列的函数2. 进入项目干活cd/你的项目路径 claude-p帮我看看这个项目在做什么--max-turns5--max-turns 5限制最多执行 5 轮操作防止跑飞烧钱。3. 代码审查cd/你的项目路径gitdiff|claude-p帮我审查这些改动重点看有没有 bug 和安全问题--max-turns1把git diff的输出直接通过管道传给 Claude它就帮你审查。4. 交互模式多轮对话claude直接输入claude回车进入一个完整的聊天界面。在里面你可以连续多轮对话改代码用/model opus切换模型用/compact压缩上下文省 token用/review审查当前改动用/help查看所有命令 交互模式是一个 TUI终端用户界面有完整的按键操作。按CtrlD退出。第五步常用参数速查参数作用示例-p 内容一问一答模式claude -p 修 bug--max-turns N限制最多 N 轮操作--max-turns 5--allowedTools限制可用工具--allowedTools Read,Edit--model指定模型--model haiku--output-format json输出 JSON 格式自动化脚本用-c继续上次对话claude -c--dangerously-skip-permissions跳过所有确认弹窗CI/自动化用--bare极速启动跳过插件等CI 环境用常见问题排查claude命令找不到关掉终端重新打开。如果还不行检查 npm 全局安装路径是否在PATH里npmconfig get prefix确保输出路径在系统环境变量中。安装报EACCES权限错误Mac / Linuxsudonpminstall-ganthropic-ai/claude-code或者改 npm 全局目录一劳永逸mkdir~/.npm-globalnpmconfigsetprefix~/.npm-globalechoexport PATH~/.npm-global/bin:$PATH~/.bashrcsource~/.bashrc运行时提示未设置ANTHROPIC_API_KEY你还没配 API Key回第三步方案 B 创建~/.claude/settings.json。npm 安装太慢 / 卡住用国内镜像加速npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com用 DeepSeek 等第三方 API 时提示权限错误如果以 root 用户运行权限跳过参数写法不同claude-phello--dangerously-skip-permissionstrue注意是true不是只写--dangerously-skip-permissionsWindows 终端乱码推荐使用Windows TerminalMicrosoft Store 免费下载替代系统自带的命令提示符。进阶CLAUDE.md 项目记忆文件在项目根目录新建CLAUDE.mdClaude Code 每次进入这个项目都会自动读取。你可以提前告诉它项目规范# 我的项目 ## 技术栈 - Python 3.12 FastAPI SQLAlchemy - PostgreSQL 数据库 ## 常用命令 - pytest 跑测试 - ruff check . 做代码检查 ## 代码规范 - Python 用 4 空格缩进 - 所有公开函数必须有类型标注 - 测试文件命名 test_*.py以后 Claude 写代码会自动遵守这些规则不用每次都重复说明。总结装 Node.js → npm install -g → 配 API Key → claude -p hello ✅整个流程不超过 10 分钟。装好之后多用claude -p模式熟悉基本用法慢慢进阶到交互模式、项目级开发。更多用法官方 CLI 文档遇到问题把报错信息丢给 Claude 自己它也能帮你排查