最强AI编程工具Claude Code安装及使用方法

本文涵盖 Node.js 安装、Claude Code CLI 部署、官方 Node SDK 调用示例等内容。

一、准备工作

1. 注册 Anthropic 或 Claude 账号
   访问 console.anthropic.com 开通计费，在 Settings → API keys 生成 sk-ant-… 密钥。也可以开通Claude Pro或者Max订阅使用。
   
   
   
2. 准备终端
   macOS / Linux 建议 zsh 或 bash；Windows 推荐 PowerShell 或 WSL。

二、安装 Node.js

Claude Code 与官方 SDK 需 Node 18+（建议 LTS 20 或更高）。

2.1 使用 nvm（macOS / Linux 首选）^[5]

# 安装 nvm（一次性脚本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载 shell
source ~/.bashrc   # 或 ~/.zshrc
# 安装最新 LTS Node（含 npm）
nvm install --lts
# 如需切换版本：
# nvm install 22
# nvm use 22

2.2 官方安装包（Windows / macOS 图形界面）^[4]

1. 访问 Node 官网下载页，选择 LTS 版本（x64 / ARM64）。
2. 双击安装，并勾选 Automatically install the necessary tools。

2.3 验证版本

node -v   # v20.12.2（示例）
npm -v    # 10.x

三、安装 Claude Code CLI

Claude Code 是在终端运行的智能编程助手，可理解本地代码库并提供实时帮助^[1]。

# 全局安装
npm install -g @anthropic-ai/claude-code

3.1 首次启动与登录

claude      # 首次运行会打开浏览器完成 OAuth 登录

若无法打开浏览器，可先设置环境变量：

export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxx
claude

四、Claude CLI 快速用法^[2]

命令示例	作用
claude -p "Explain quicksort"	非交互模式，直接输出答案
claude -p "请用 Go 写冒泡排序" --model claude-sonnet-4	指定模型
claude --resume abc123	恢复指定会话
claude --output-format json -p "给出 JSON 接口文档"	机器可解析输出

五、使用官方 Node SDK 调用 Claude API^[3]

5.1 初始化项目

mkdir my-claude-app && cd $_
npm init -y
npm install @anthropic-ai/sdk dotenv

在项目根目录创建 .env：

ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx

5.2 完整示例 index.js

// index.js
import Anthropic from "@anthropic-ai/sdk";
import dotenv from "dotenv";
dotenv.config();            // 读取 .env 文件

async function main() {
  const anthropic = new Anthropic();   // 默认从环境变量读取密钥

  const response = await anthropic.messages.create({
    model: "claude-3-sonnet-20250514",  // 最新通用模型
    max_tokens: 1024,
    messages: [
      { role: "user", content: "用 JavaScript 写一个快速排序，并解释复杂度" }
    ],
    stream: false
  });

  console.log(response.content[0].text);
}

main().catch(console.error);

5.3 流式输出（可选）

// 仅展示调用核心，其余同上
const stream = await anthropic.messages.create({
  model: "claude-3-opus-20250603",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Stream me a poem" }],
  stream: true
});
for await (const chunk of stream) {
  process.stdout.write(chunk.delta.text || "");
}

六、常见问题 & 提示

场景	解决方案
代理 / 公司网络无法直连	设置环境变量 HTTPS_PROXY，CLI 与 SDK 会自动读取
切换模型	CLI: --model claude-opus-4 SDK: model 字段填完整模型名
令牌配额	登录控制台查看 Usage；SDK 错误码 429 表示限流
在 VS Code 里用	项目根目录执行 claude，会自动读取本地代码
多 Node 版本	用 nvm install 18 && nvm use 18 等命令切换

参考文献

1. Claude Code Overview – Anthropic. docs.anthropic.com
2. Claude Code CLI Reference – Anthropic. docs.anthropic.com
3. @anthropic-ai/sdk – npm. npmjs.com
4. Node.js Download. nodejs.org
5. nvm – Node Version Manager GitHub. github.com