📖 入门指南

Claude Code 安装指南

将 Claude 的强大能力带入终端，几分钟内完成安装配置。

系统要求

项目要求
操作系统macOS 10.15+、Windows 10/11、Linux (Ubuntu 20.04+ / Debian 10+)
Node.js18.0 及以上版本
内存建议 4GB 及以上
网络可访问 LuckyAPI 或 Anthropic API

一键安装（推荐）

适用于 macOS / Linux，自动检测 Node.js 环境、安装 Claude Code 并完成 API 配置：

bash curl -fsSL https://code.claudexai.com/install.sh | bash

Windows PowerShell 一键安装：

powershell $tmp="$env:TEMP\cc.ps1";[Net.WebClient]::new().DownloadFile('https://code.claudexai.com/install.ps1',$tmp);powershell -NoProfile -ExecutionPolicy Bypass -File $tmp;del $tmp
提示 一键脚本会自动检测 Node.js 是否已安装，若未安装会引导你完成安装，无需手动操作。

手动安装

  1. 安装 Node.js

    访问 nodejs.org 下载 LTS 版本，或通过包管理器安装：

    bash # macOS (Homebrew) brew install node # Ubuntu / Debian curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs

  2. 配置 npm 镜像并安装 Claude Code

    bash npm config set registry https://registry.npmmirror.com npm install -g @anthropic-ai/claude-code@2.1.112

  3. 获取 API 密钥

    前往 LuckyAPI 注册并获取 API Key，仅需官方价格的 6%。

  4. 配置环境变量

    bash # 添加到 ~/.bashrc 或 ~/.zshrc export ANTHROPIC_BASE_URL="https://api.claudexai.com" export ANTHROPIC_AUTH_TOKEN="你的API密钥" unset ANTHROPIC_API_KEY

settings.json 配置

在项目根目录或 ~/.claude/ 下创建 settings.json：

json { "onboarding": false, "telemetry": false, "coauthoredBy": false, "model": "claude-opus-4-6" }

常用命令

命令说明
claude启动交互式会话
claude "描述需求"直接执行单次任务
claude --model claude-sonnet-4-6指定使用的模型
claude --help查看帮助信息
claude doctor检查环境配置状态

Windows 专项说明

推荐方案 Windows 用户推荐使用 VS Code 插件方案，体验更稳定。详见 VS Code 插件页面。

若需在 Windows 原生终端使用，请在 PowerShell 中设置环境变量：

powershell $env:ANTHROPIC_BASE_URL = "https://api.claudexai.com" $env:ANTHROPIC_AUTH_TOKEN = "你的API密钥" Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue

卸载与重装

bash # 卸载 npm uninstall -g @anthropic-ai/claude-code # 重装指定版本 npm install -g @anthropic-ai/claude-code@2.1.112

常见问题

Q：提示 API key 无效怎么办？

请确认 ANTHROPIC_AUTH_TOKEN 已正确设置，且 ANTHROPIC_API_KEY 已清除。可运行 claude doctor 检查配置状态。

Q：连接超时或网络错误？

建议直接使用 LuckyAPI 地址，无需配置代理，国内直连速度更快，代理可能导致 SSL 握手失败。

Q：如何升级到最新版本？

npm update -g @anthropic-ai/claude-code