在本教程中我会一步步带你从零开始安装 Claude Code配置好 API跑通第一个命令。教程基于 2026 最新版特点是图文结合文字描述清晰关键步骤配模拟图或示意文字格式限制无法插入图片但你执行时可截图。踩坑提醒包括常见问题和解决方法。完整流程从环境检查到第一个命令成功运行。一、前言为什么要装 Claude Code最近有朋友问我在 VS Code 里装 Copilot 不是挺好吗为啥还要折腾命令行版的 Claude Code其实Claude Code 和 Copilot不是替代关系而是互补关系。下面是我使用后发现的真香理由对比一目了然维度Claude CodeCLICopilotIDE 插件工作方式终端里直接对话可读写整个项目IDE 内联补全适用场景重构项目、写脚本、批量处理单文件快速补全上下文整个仓库级当前文件为主自动化适合接 CI / 脚本流水线主要靠人触发模型支持 Opus/Sonnet/HaikuGitHub 模型简单说Claude Code适合大范围工程任务比如让 AI 帮我重构整个项目。Copilot适合编写时的精细化补全。两者结合生产力 double 。二、系统要求先确认再动手动手前先查环境确保达标✅ 必选项操作系统macOS / Linux / WindowsWSL不推荐原生 Windows兼容差。Node.js 版本 ≥$18.0$必须旧版会报错。网络稳定能稳定访问 Anthropic API 或转发服务。磁盘空间 ≥ $200 , \text{MB}$安装包和应用缓存。 提示Windows 用户建议用WSLUbuntu 子系统避免 PowerShell 兼容问题。macOS/Linux 用户开箱即用可跳过烦琐步骤。三、安装 Node.js步骤验证或安装。如果已有 Node.js 18跳过本节。(1) 验证安装node --version输出应是v18.x.x或更高确保版本数 $≥ 18.0$。若不达标按系统安装(2) Ubuntu / Debian 安装# 1. 添加最新 LTS 源 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash - # 2. 安装 sudo apt-get install -y nodejs # 3. 验证版本输出 ≥ v18.0 node --version(3) macOS 安装# 1. 装 Xcode 工具确保已装 sudo xcode-select --install # 2. Homebrew若未装 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 3. 通过 Homebrew 装 brew install node # 4. 验证 node --version(4) Windows 安装下载Node.js LTS 版安装包官网链接。运行安装程序一路点 Next。完成后开 PowerShell 跑node --version四、安装 Claude Code4种官方方式挑一种顺手的就行我推荐方式一。方式一官方脚本Linux/macOScurl -fsSL https://claude.ai/install.sh | bash方式二官方脚本Windows PowerShellirm https://claude.ai/install.ps1 | iex方式三Homebrew 安装只限 macOSbrew install --cask claude-code方式四Winget 安装只限 Windowswinget install Anthropic.ClaudeCode⚠️ 安装后 fix PATH如果终端报claude: command not found说明 PATH 异常。手动加路径Linux / macOSbash/zsh# 加到 .bashrc或 .zshrc echo export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrc验证安装claude --version # 输出应类似claude v2.0.02026五、获取 API 令牌最关键步骤易踩坑API 令牌是核心没它就跑不起来。你需要两个东西配置项说明备注ANTHROPIC_AUTH_TOKENAPI 认证令牌以sk-开头ANTHROPIC_BASE_URLAPI 服务地址查你的服务商地址5.1 创建令牌步骤进入令牌管理页面点「添加令牌」。设置关键选项名称方便自己识别如claude-code-mac。额度设为无限额度否则长任务会被截断。分组选以下之一Claude Code 专属特价 Claude Code官转克劳德 1 及以上建议值优先 Claude Code 专属。 踩坑警告不要选这些分组default分组不支持通工具调用会卡死。逆向分组API 响应慢。原因Claude Code 依赖工具调用读写文件错选分组将报错Function not permitted。复制令牌粘贴到安全文本页面关闭后它不可见。六、配置 settings.json最易出错处配置文件路径按系统不同系统路径Linux / macOS~/.claude/settings.jsonWindows (PowerShell)%USERPROFILE%\.claude\settings.jsonWindows (WSL)~/.claude/settings.json项目级项目目录/.claude/settings.json优先级更高6.1 完整配置示例{ env: { ANTHROPIC_BASE_URL: https://selltoken.top/, ANTHROPIC_AUTH_TOKEN: sk-粘贴令牌定值, ANTHROPIC_MODEL: claude-opus-4-6, ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-opus-4-6, ANTHROPIC_DEFAULT_SONNET_MODEL: claude-opus-4-6, ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4-6, API_TIMEOUT_MS: 300000, CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 1 } }6.2 配置项说明每个都很重要配置键作用建议值ANTHROPIC_BASE_URLAPI 接入点你的服务商提供的地址ANTHROPIC_AUTH_TOKEN认证令牌sk-xxx一步获取的值ANTHROPIC_MODEL主对话模型claude-opus-4-6效果好ANTHROPIC_DEFAULT_HAIKU_MODEL轻任务模型claude-haiku-4-5或claude-opus-4-6ANTHROPIC_DEFAULT_SONNET_MODEL执行阶段模型claude-sonnet-4-6或claude-opus-4-6ANTHROPIC_DEFAULT_OPUS_MODEL规划阶段模型claude-opus-4-6API_TIMEOUT_MS请求超时毫秒设置为 $300000$5分钟CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS关闭 beta 协议1防崩溃6.3 一行命令快速生成配置Linux/macOS/WSL# 新建配置文件替换占位符 cat ~/.claude/settings.json EOF { env: { ANTHROPIC_BASE_URL: https://selltoken.top/, ANTHROPIC_AUTH_TOKEN: sk-粘贴令牌, ANTHROPIC_MODEL: claude-opus-4-6, ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-opus-4-6, ANTHROPIC_DEFAULT_SONNET_MODEL: claude-opus-4-6, ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4-6, API_TIMEOUT_MS: 300000, CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 1 } } EOF Windows 用户注意PowerShell 不支持 EOF语法直接用 VSCode 或记事本打开%USERPROFILE%\.claude\settings.json。粘贴 JSON 模板。保存后重启终端。七、初次启动和跑第一个命令配置好后启动 Claude Code(1) 初次启动向导claude跟着提示一步步选推荐设置选主题Dark / Light我选 Dark然后 Enter。读安全须知读完确认Enter。Terminal 配置默认就行Enter。工作目录信任选 Yes ✅。(2) 跑第一个命令试手初始界面中输入帮我写一个 Python 快速排序等待几秒看到输出包括Python 代码。测试结果解释如图示。体验超顺滑八、常见问题 FAQ踩坑合集❓ Q1启动报Invalid API Key · Please run /loginA环境变量没生效排查步骤重启终端环境变量修改后必须关闭再打开。检查配置文件cat ~/.claude/settings.json确保 JSON 无额外逗号/引号。确认令牌有效换工具测试sk-xxx。❓ Q2安装时报权限不足错误Linux/macOSA加sudosudo curl -fsSL https://claude.ai/install.sh | sudo bash❓ Q3Windows WSL 中无法识别claude命令APATH 未同步# WSL 中运行 echo $PATH # 查看是否包含 ~/.local/bin export PATH$PATH:$HOME/.local/bin # 临时加 # 长期解决加到 .bashrc结语恭喜至此你已经从零配通了 Claude Code。记住配 API 令牌是关键千万别选错分组。配置文件中数值如超时设置 $300000$确保精度。进阶用 AI 处理复杂项目如claude predict流水线。