跳到主要内容

Claude Code 接入指南

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

安装​

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

打开 PowerShell（管理员模式），下载并安装 nvm-windows：

# 下载 nvm-windows 安装包
# 访问 https://github.com/coreybutler/nvm-windows/releases
# 下载最新的 nvm-setup.exe 并运行安装

或使用 Chocolatey 安装：

choco install nvm

步骤 2：安装 Node.js

# 安装最新 LTS 版本
nvm install lts

# 使用该版本
nvm use lts

# 验证安装
node --version
npm --version

步骤 3：安装 Claude Code

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

步骤 4：验证安装

claude --version

配置 weelinking​

方式一：环境变量

在系统环境变量中添加：

# 临时设置（当前会话）
$env:ANTHROPIC_BASE_URL="https://api.weelinking.com"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

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

方式二：配置文件

创建配置目录和文件：

# 创建配置目录
New-Item -Path "$env:USERPROFILE\.claude" -ItemType Directory -Force

# 创建配置文件
@"
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.weelinking.com"
  },
  "enabledPlugins": {
    "gopls-lsp@claude-plugins-official": true
  }
}
"@ | Out-File -FilePath "$env:USERPROFILE\.claude\settings.json" -Encoding UTF8

方式三：命令行参数

claude --api-base https://api.weelinking.com --api-key YOUR_API_KEY

推荐模型​

模型特点适用场景
claude-sonnet-4-5-20250929世界最强编码模型复杂代码生成
claude-haiku-4-5-20251001高性价比日常编程
claude-opus-4-5-20251101最强推理架构设计

使用示例​

启动交互模式​

claude

直接执行任务​

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

在项目中使用​

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

功能特色​

  • 代码生成：根据描述生成完整代码
  • 代码解释：解释复杂代码逻辑
  • 代码重构：优化现有代码结构
  • Bug 修复：分析并修复代码问题
  • 文档生成：自动生成代码文档

常见问题​

命令找不到​

确保 npm 全局安装路径在系统 PATH 中：

# 查看 npm 全局路径
npm config get prefix

# 如需添加到 PATH，在系统环境变量中添加：
# %APPDATA%\npm

API 连接失败​

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

模型不可用​

确保使用 Claude 系列模型名称。

Node.js 版本问题​

Claude Code 需要 Node.js 18 或更高版本：

# 检查版本
node --version

# 如果版本过低，使用 nvm 升级
nvm install --lts
nvm use --lts