Claude Code 部署指南

Claude Code 是 Anthropic 官方推出的 CLI 编程助手。本章介绍如何让它走NassaApi 中转站。

⚡ 首次安装必读：跳过初始化报错

使用中转渠道时，Claude Code 首次启动会出现以下报错：

Welcome to Claude Code
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

这是因为 Claude Code 首次启动会尝试连接官方 API 进行初始化确认，中转渠道无法通过此步骤。安装完成后、首次启动前，请先执行以下任一方法跳过：

方法一：使用 CC-Switch 跳过（推荐）

打开 CC-Switch 配置工具，进入 设置 → 通用，开启「跳过 Claude Code 初次安装确认」选项即可。

方法二：手动修改配置文件

在用户主目录下找到 ~/.claude.json 文件，在末尾添加 "hasCompletedOnboarding": true 字段：

⚠️ 注意 JSON 格式

添加字段前，需要在上一个字段末尾补一个英文逗号，否则 JSON 格式错误会导致 Claude Code 无法启动。

{
  "installMethod": "unknown",
  "autoUpdates": true,
  "firstStartTime": "2025-07-14T06:11:03.877Z",
  "userID": "xxxx",
  "projects": {
    "/home/your-user": {
      "allowedTools": [],
      "history": [],
      "mcpServers": {},
      "hasTrustDialogAccepted": false,
      "projectOnboardingSeenCount": 0
    }
  },
  "hasCompletedOnboarding": true
}

修改保存后，重新运行 claude 即可正常使用。

🚀 使用 CC-Switch 快速配置（推荐）

如果您已安装 CC-Switch 快速配置工具，可以通过图形界面轻松管理 Claude Code 的配置，无需手动编辑配置文件和环境变量。

CC-Switch 优势

• 图形化界面，操作简单直观
• 一键切换不同提供商配置
• 自动管理环境变量和配置文件
• 支持配置备份与恢复
• 无需重启终端即可切换配置

配置步骤

1. 启动 CC-Switch 并添加 Claude Code 配置
   • 打开 CC-Switch 应用程序
   • 点击顶部的「Claude」标签页
   • 点击右上角橙色「+」按钮添加新配置
2. 填写提供商配置信息
   • 提供商名称：自定义名称（如 my-proxy）
   • API Base URL：https://api.nassaapi.xyz（通常不带 /v1）
   • API Key：粘贴您从本站获取的密钥（sk-xxxx）
   • 模型选择：根据需求选择可用的 Claude 模型
   • 点击「保存」按钮
3. 启用配置并使用
   • 在配置列表中找到刚创建的配置
   • 点击配置右侧的「当前使用」按钮
   • 重启 Claude Code，新配置即可生效
4. 系统托盘快速切换
   • 右键点击系统托盘中的 CC-Switch 图标
   • 在菜单中选择 Claude 分类
   • 直接选择要切换到的配置，立即生效

💡 提示

• CC-Switch 会自动修改 ~/.claude/settings.json 配置文件
• 切换配置后，关闭并重启 Claude Code 即可生效

⌨️ 手动命令行配置

如果您不使用 CC-Switch，也可以通过命令行手动配置。

🖥️ Windows 平台

系统要求

Windows 10、11。

安装步骤

方法一：Native Install（推荐）

PowerShell：

irm https://claude.ai/install.ps1 | iex

CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方法二：NPM 安装（不推荐）

⚠️ 不建议使用 npm 安装

npm 渠道更新滞后，安装的版本通常较旧，建议优先使用上方的 Native 方式。

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

验证安装：

claude --version

配置环境变量

PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.nassaapi.xyz", "User")

CMD：

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://api.nassaapi.xyz"

💡 提示

请将 sk-xxx 替换为你自己的专属 Key！设置好后重启终端以让环境变量生效。

启动 Claude

在终端进入项目目录或任意目录，输入 claude 即可启动。

🍏 macOS 平台

系统要求

macOS 10.15 (Catalina) 或更高版本。

安装步骤

方法一：Homebrew（推荐）

brew install --cask claude-code

方法二：Curl Script

curl -fsSL https://claude.ai/install.sh | bash

方法三：NPM 安装（不推荐，同上）

验证安装

claude -v
# 正常输出：1.0.108 (Claude Code)

配置环境变量

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.nassaapi.xyz"' >> ~/.zshrc
source ~/.zshrc

重启终端后输入 claude 即可启动。

🐧 Linux 平台

系统要求

Ubuntu 18.04+ / CentOS 7+ / Debian 9+ 等主流发行版。

安装步骤

方法一：Curl Script（推荐）

curl -fsSL https://claude.ai/install.sh | bash

方法二：NPM 安装（不推荐，同上）

配置环境变量

Ubuntu / Debian（Bash）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://api.nassaapi.xyz"' >> ~/.bash_profile
source ~/.bash_profile

Fedora / CentOS（Zsh）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.nassaapi.xyz"' >> ~/.zshrc
source ~/.zshrc

常见问题

提示找不到命令？

确保安装完成后已重启终端，或者检查 PATH 是否包含 Claude Code 的安装目录。

连接失败？

• 确认 Key 正确（sk- 开头）
• 确认 ANTHROPIC_BASE_URL 为 https://api.nassaapi.xyz（不要带 /v1）
• 确认已跳过初始化报错（见本页第一节）

更多问题

请查阅 疑难杂症 或 常见问题 (FAQ)。