Claude Code 安装与配置最详细指南

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手CLI它被开发者形象地称为“能直接操作仓库的 AI 同事”。它允许你在终端直接让 Claude 阅读、修改项目代码运行测试以及生成 Git 提交信息等。一、环境准备在安装之前请确保您的系统满足以下条件Node.js必需版本为 18推荐使用 LTS 20。可以通过node -v命令验证安装情况。wingetinstall--idOpenJS.NodeJS.LTS-e--sourcewingetGit强烈推荐安装。Claude Code 需要利用 Git 来读取项目历史、生成 diff 差异、以及管理 PR 和分支。wingetinstall--idGit.Git-e--sourcewinget二、安装 Claude Code您可以根据操作系统选择官方提供的一键安装脚本或使用包管理器进行安装macOS、Linux、WSLcurl -fsSL https://claude.ai/install.sh | bashWindows PowerShellirm https://claude.ai/install.ps1 | iexWindows CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmd包管理器方式Homebrew (macOS)brew install --cask claude-codeWinGet (Windows)winget install Anthropic.ClaudeCodenpm (全局安装)npm install -g anthropic-ai/claude-code验证安装安装完成后在终端输入以下命令claude--version如果输出版本号如2.1.81 (Claude Code)则说明安装成功。三、登录与配置 API KeyClaude Code 需要你的 Anthropic 账号和 Key如果没有可以使用 LX API : https://www.lxtech.icu。配置步骤获取 Key打开 www.lxtech.icu登录注册账号左侧 API 令牌 - 添加令牌选择 Freeclaude 分组复制 Key长得像 sk-xxxxxxxxx注如果有安装 CC Switch可一键导入 CC Switch。设置环境变量在终端如 PowerShell中配置对应的环境变量。$env:ANTHROPIC_BASE_URLhttps://www.lxtech.icu$env:ANTHROPIC_AUTH_TOKEN你的 Key四、快速上手使用进入项目使用cd命令进入你的项目根目录。启动输入claude即可进入交互界面。常用指令示例理解项目输入“请快速浏览项目结构告诉我技术栈和主要模块”。编写功能例如“在 React 前端新增一个用户列表页面调用 GET /api/users 接口”。调试修复直接粘贴报错日志让 Claude 定位原因并提供修复 diff。引用上下文在对话中使用file引用具体文件或dir引用目录如“请看src/app.tsx帮我加一个 loading”。五、进阶使用建议进阶小贴士提升成功率的秘诀先计划再动手对于涉及多个文件的复杂任务建议要求 Claude“请先给我一个分步骤计划不改代码我确认后再开始执行”。这样可以有效防止 AI 在理解复杂业务逻辑时产生偏差。上下文引用在提问时善用file如src/app.tsx来手动指定上下文能让 Claude 的定位更加快准稳。工程化协作你还可以要求它在改完代码后“按最佳实践新建一个 feature 分支并给出 PR 描述”实现从开发到提交的完全自动化。