Skip to main content

Claude code配置

一、安装 Claude Code​

步骤 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

二、配置 NUWA API_KEY​

方式一：环境变量​

在系统环境变量中添加：

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

# 永久设置（推荐）
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.nuwaapi.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.nuwaapi.com"
  },
  "enabledPlugins": {
    "gopls-lsp@claude-plugins-official": true
  }
}
"@ | Out-File -FilePath "$env:USERPROFILE\.claude\settings.json" -Encoding UTF8
Claude Code/NUWA API_KEY

三、模型配置（可选）​

推荐模型​

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

配置模型设置​

Claude Code 默认会使用 Claude 系列模型。如果您想使用 NUWA 提供的其他模型（如 DeepSeek、GPT-code 等），可以通过以下方式配置。

方式一：通过 settings.json 配置​

在 ~/.claude/settings.json 的 env 部分添加模型配置：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.nuwaapi.com",
    "ANTHROPIC_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "moonshotai/kimi-k2-thinking",
    "ANTHROPIC_SMALL_FAST_MODEL": "moonshotai/kimi-k2-thinking"
  }
}

方式二：通过环境变量配置​

在 shell 配置文件中添加：

export ANTHROPIC_MODEL="moonshotai/kimi-k2-thinking"
export ANTHROPIC_DEFAULT_SONNET_MODEL="moonshotai/kimi-k2-thinking"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="moonshotai/kimi-k2-thinking"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-thinking"

四、验证配置​

启动 Claude Code 并使用 /status 命令验证配置：

claude
# 在 Claude Code 中输入
/status
Claude Code /status 示例

检查以下配置项：

  • ✅ Base URL 显示为 https://api.nuwaapi.com
  • ✅ API Key 已正确配置（显示为已设置状态）
  • ✅ 模型配置正确（如已配置）

五、常见问题​

1. 认证失败​

问题：提示 “Authentication failed” 或 “Invalid API key”

解决方案：

  • 检查 API Key 是否正确复制（没有多余空格）
  • 确认 API Key 在 NUWA 控制台是否有效
  • 验证 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY 只配置了一个
  • 检查 Base URL 是否正确设置为 https://api.nuwaapi.com

2. 模型不可用​

问题：提示 “Model not found” 或模型调用失败

解决方案：

  • 访问 NUWA 模型列表确认模型名称正确
  • 检查账号是否有该模型的使用权限
  • 尝试使用默认模型测试
  • 使用 /status 命令查看当前配置

3. 配置未生效​

问题：修改配置后没有变化

解决方案：

  • 重新启动 Claude Code
  • 检查配置文件 JSON 格式是否正确（使用 JSON 验证工具）
  • 确认配置文件路径正确（~/.claude/settings.json）
  • 环境变量配置需要 source ~/.zshrc 后重启终端

4. 权限被拒绝​

问题：Claude Code 无法读取文件或执行命令

解决方案：

  • 检查 permissions.deny 是否过于严格
  • 使用 /config 命令查看当前权限设置
  • 调整 defaultMode 为 "ask" 以临时允许操作
  • 在 permissions.allow 中明确添加需要的权限

5. 网络连接问题​

问题：无法连接到 API 服务

解决方案：

  • 检查网络连接是否正常
  • 确认防火墙没有阻止 https://api.nuwaapi.com
  • 尝试 curl https://api.nuwaapi.com 测试连接
  • 检查是否需要配置代理