Claude Code 使用教程 - 极速安装指南

快速生成配置命令

输入你的 API Key，下面的教程命令将自动更新，可直接复制使用。

你的 API KEY (sk-...)

安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。建议安装 LTS (长期支持) 版本。

官网下载（推荐）

1. 访问 nodejs.org
2. 点击 "LTS" 版本进行下载
3. 运行 .msi 文件按默认引导安装

命令行安装

# 使用 Scoop

scoop install nodejs

# 或使用 Choco

choco install nodejs

Windows 注意事项

建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 Claude Code

打开 PowerShell 或 CMD，运行以下命令：

# 全局安装 Claude Code

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

# 国内镜像（下载慢可用）

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

提示

建议使用 PowerShell 而不是 CMD，功能更强大
如果遇到权限问题，以管理员身份运行 PowerShell

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

修改配置文件

修改 C:/用户/<用户名>/.claude/settings.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://ai.wdcodex.xyz",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.3-codex(low)",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.3-codex(high)",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.3-codex(medium)",
    "ANTHROPIC_MODEL": "gpt-5.3-codex(medium)"
  }
}

再编辑或新增 C:/用户/<用户名>/.claude.json 文件，新增 hasCompletedOnboarding 参数。

.claude.json

{
  "hasCompletedOnboarding": true
}

开始使用

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录

cd C:\path\to\your\project

# 启动 Claude Code

claude

如需在 VSCode 中使用 Claude Code，上述步骤完成后，再在扩展中安装 Claude Code 插件即可。（上面的步骤不能跳过）

安装 Node.js 环境

# 使用 Homebrew 安装

brew install node

或者访问 nodejs.org 下载 .pkg 安装包。

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 Claude Code

打开终端，运行以下命令：

# 使用 sudo 全局安装

sudo npm install -g @anthropic-ai/claude-code

# 国内镜像（下载慢可用）

sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

在 macOS 上，全局安装通常需要管理员权限（sudo）。

提示

如果提示 Enter password，请输入你的 Mac 登录密码（输入时不会显示字符）
建议在安装完成后运行验证命令确保路径已生效

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

修改配置文件

修改 ~/.claude/settings.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://ai.wdcodex.xyz",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.3-codex(low)",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.3-codex(high)",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.3-codex(medium)",
    "ANTHROPIC_MODEL": "gpt-5.3-codex(medium)"
  }
}

再编辑或新增 ~/.claude.json 文件，新增 hasCompletedOnboarding 参数。

.claude.json

{
  "hasCompletedOnboarding": true
}

开始使用

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 Claude Code

claude

如需在 VSCode 中使用 Claude Code，上述步骤完成后，再在扩展中安装 Claude Code 插件即可。（上面的步骤不能跳过）

安装 Node.js

# Ubuntu/Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装是否成功

安装完成后，打开终端，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 Claude Code

在终端中运行以下命令：

# 全局安装 Claude Code

sudo npm install -g @anthropic-ai/claude-code

# 国内镜像（下载慢可用）

sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

Linux 系统通常需要 sudo 权限来安装全局 npm 包。

提示

如果不想使用 sudo，建议配置 npm 全局目录到用户目录下
WSL2 用户请确保 Node.js 环境已在子系统中正确安装

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

修改配置文件

修改 ~/.claude/settings.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://ai.wdcodex.xyz",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.3-codex(low)",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.3-codex(high)",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.3-codex(medium)",
    "ANTHROPIC_MODEL": "gpt-5.3-codex(medium)"
  }
}

再编辑或新增 ~/.claude.json 文件，新增 hasCompletedOnboarding 参数。

.claude.json

{
  "hasCompletedOnboarding": true
}

开始使用

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 Claude Code

claude

如需在 VSCode 中使用 Claude Code，上述步骤完成后，再在扩展中安装 Claude Code 插件即可。（上面的步骤不能跳过）

🎉 恭喜你！安装配置完成后，即可享受 AI 编程助手带来的便利。