跳到主要内容

Claude Code 接入指南

Claude Code 是 Anthropic 官方推出的 AI 编程助手，通过命令行界面提供强大的代码生成、调试和重构能力。

安装​

步骤 1：安装 NVM（Node 版本管理器）

NVM 是用来管理 Node.js 版本的工具，安装它之后才能安装 Node.js。

  1. 打开浏览器，访问 https://github.com/coreybutler/nvm-windows/releases
  2. 找到最新版本，下载 nvm-setup.exe 文件
  3. 双击运行安装，一路点「下一步」即可完成

步骤 2：安装 Node.js

打开 PowerShell（在开始菜单搜索「PowerShell」，右键选择「以管理员身份运行」），依次输入以下命令：

# 安装最新 LTS 版本
nvm install lts

# 使用该版本
nvm use lts

# 验证安装，会显示版本号
node --version
npm --version

步骤 3：安装 Claude Code

继续在 PowerShell 中输入：

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

步骤 4：验证安装

安装完成后，输入以下命令，如果显示版本号说明安装成功：

claude --version

配置 weelinking​

推荐新手使用方式二（配置文件），只需创建一个文件即可，简单不易出错。

方式一：环境变量

通过图形界面设置（永久生效，推荐）：

  1. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「用户变量」中点击「新建」，分别添加以下两个变量：
    • 变量名：ANTHROPIC_BASE_URL，变量值：https://api.weelinking.com
    • 变量名：ANTHROPIC_AUTH_TOKEN，变量值：YOUR_API_KEY（替换为你的实际 API Key）
  3. 点击「确定」保存，重新打开终端即可生效

或者通过 PowerShell 命令设置：

# 永久设置
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.weelinking.com', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'YOUR_API_KEY', 'User')

方式二：配置文件

  1. 打开文件资源管理器，在地址栏输入 %USERPROFILE% 并回车，进入你的用户目录（一般是 C:\Users\你的用户名\）
  2. 查看是否有 .claude 文件夹，如果没有，新建一个文件夹并命名为 .claude
  3. 在 .claude 文件夹内，新建一个文本文件，将文件名改为 settings.json（注意去掉 .txt 后缀）
  4. 用记事本或其他编辑器打开 settings.json，粘贴以下内容并保存：
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.weelinking.com"
  }
}

将 YOUR_API_KEY 替换为你的实际 API Key。

方式三：启动时临时指定

在当前会话中设置环境变量后启动 Claude Code（关闭窗口后失效）：

$env:ANTHROPIC_BASE_URL="https://api.weelinking.com"; $env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"; claude

推荐模型​

模型特点适用场景
claude-opus-4-6最强推理与编码能力架构设计、复杂代码生成
claude-sonnet-4-6均衡性能，速度快日常编程、代码重构
claude-haiku-4-5-20251001高性价比，响应极快轻量任务、快速问答

使用示例​

启动交互模式​

直接输入 claude 进入对话模式，可以连续提问：

claude

直接执行任务​

在 claude 后面加上引号和你的需求，一次性获得结果：

claude "创建一个 Express.js REST API"

在项目中使用​

先用终端进入你的项目文件夹，再启动 Claude Code，它会自动读取项目代码：

cd your-project
claude "重构这个项目的数据库访问层"

将 your-project 替换为你实际的项目文件夹路径。

功能特色​

  • 代码生成：用自然语言描述需求，自动生成完整代码
  • 代码解释：看不懂的代码丢给它，帮你逐行解释
  • 代码重构：自动优化现有代码结构，提升可读性
  • Bug 修复：描述问题现象，帮你定位原因并修复
  • 文档生成：自动为代码添加注释和文档

常见问题​

命令找不到​

输入 claude 提示"不是内部或外部命令"时，说明系统找不到 Claude Code 的安装位置，需要手动添加：

  1. 在 PowerShell 中输入 npm config get prefix，记下显示的路径
  2. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  3. 在「用户变量」中找到 Path，双击打开，点击「新建」
  4. 将上面记下的路径粘贴进去，末尾加上 \bin（例如 C:\Users\你的用户名\AppData\Roaming\npm）
  5. 点击「确定」保存，重新打开 PowerShell 再试

API 连接失败​

  1. 确认 API 地址正确（不需要 /v1 后缀）
  2. 检查 API Key 是否有效
  3. 验证网络连接

模型不可用​

确保使用 Claude 系列模型名称，参考上方「推荐模型」表格。

Node.js 版本问题​

Claude Code 需要 Node.js 18 或更高版本。在终端中输入以下命令检查：

node --version

如果显示的版本号低于 18（例如 v16.x.x），需要升级：

nvm install --lts
nvm use --lts