Claude Code 配置

BitCloud API 兼容 Anthropic 协议，支持 Claude Code CLI 和 IDE 插件，可参考本文进行配置与使用。

前置工作

获取凭证

使用 Claude Code CLI

安装 Claude Code CLI

Claude Code 需要 Node.js 18 或更新版本。

• Linux/macOS： 不需要额外操作，默认环境即可。
• Windows： 需要安装 WSL 或安装 Git for Windows，然后在 WSL 或 Git Bash 中执行以下命令。

安装命令：

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

验证安装（如有版本号输出，则表示安装成功）：

bashclaude --version

安装完成后不要立即执行 claude 命令，请先完成下方的配置步骤。

配置基本信息

配置前请确保已清除以下 Anthropic 官方环境变量，以免干扰 API：ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。

1. 创建或编辑 settings.json

如果 .claude 目录不存在，请手动创建。

• macOS/Linux： ~/.claude/settings.json
• Windows： 用户目录/.claude/settings.json

按需替换 BASE_URL 和 API_KEY。

对于支持长上下文的模型，可在模型 ID 后追加 [1m] 后缀来扩展上下文。配置完成后重启 Claude Code，执行 /context 命令验证长上下文是否生效。

json{
  "env": {
    "ANTHROPIC_BASE_URL": "BASE_URL",
    "ANTHROPIC_AUTH_TOKEN": "API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-20250514"
  }
}

2. 创建或编辑 .claude.json

• macOS/Linux： ~/.claude.json
• Windows： 用户目录/.claude.json

json{
  "hasCompletedOnboarding": true
}

3. 应用配置

配置完成后，重新打开终端窗口以使更改生效。

使用 Claude Code CLI

进入项目目录并运行：

bashclaude

首次启动时，需选择 "Trust This Folder" 以允许 Claude Code 访问项目文件。启动后，使用 /status 命令确认当前配置和模型状态。

使用 Claude Code IDE 插件

Claude Code 提供 VS Code IDE 插件。也可参考官方文档了解在 VS Code 中使用 Claude Code 的更多指引。

安装插件

在 VS Code 扩展市场搜索并安装 Claude Code for VS Code 扩展。

配置模型

打开 VS Code 设置，搜索 Claude Code: Environment Variables，然后在 settings.json 中手动配置以下内容：

json{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.selectedModel": "claude-sonnet-4-20250514",
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "BASE_URL"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "API_KEY"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "claude-sonnet-4-20250514"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "claude-sonnet-4-20250514"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "claude-sonnet-4-20250514"
    }
  ]
}

如果已安装 Claude Code CLI，VS Code 插件会自动复用 CLI 的配置。如需独立配置，可在插件设置中按上述方式指定环境变量。

常见问题

Windows 上安装报错？

请确保已安装以下依赖：

• Node.js 18+
• Git for Windows

如果遇到 npm 权限问题，可尝试以管理员身份运行终端，或使用 nvm 管理 Node.js 版本。