配置到 Claude Code CLI 中

Updated: 2026-06-11

本文说明如何将 Claude Code CLI 接入 Cubicspaces 的 Anthropic 兼容接口。

开始前请先在 Cubicspaces 控制台获取：

• API Key
• API 端点

Claude Code 的 ANTHROPIC_BASE_URL 默认可使用：

https://cubicspaces.cloud

如果控制台的 Use Key / 导出配置弹窗展示了专用 API 端点，请以弹窗展示为准。

如需提升长上下文缓存命中和请求稳定性，请参考 缓存与请求亲和。

---

macOS / Linux / WSL 临时生效

export ANTHROPIC_BASE_URL="https://cubicspaces.cloud"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

---

macOS / Linux / WSL 永久生效

如果你使用 zsh，将下面内容写入 ~/.zshrc：

export ANTHROPIC_BASE_URL="https://cubicspaces.cloud"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

加载配置：

source ~/.zshrc

如果你使用 bash，可以写入 ~/.bash_profile 或 ~/.bashrc。

---

使用 settings.json

也可以将配置写入 Claude Code 配置文件。

macOS / Linux / WSL 路径：

~/.claude/settings.json

Windows 路径：

%USERPROFILE%\.claude\settings.json

示例：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cubicspaces.cloud",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

环境变量和 settings.json 任选一种即可。

---

Windows 临时生效

在 PowerShell 中执行：

$env:ANTHROPIC_BASE_URL="https://cubicspaces.cloud"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows CMD 临时生效：

set ANTHROPIC_BASE_URL=https://cubicspaces.cloud
set ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

如需永久生效，可以在 Windows 系统环境变量中新增：

ANTHROPIC_BASE_URL=https://cubicspaces.cloud
ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

---

检查项

• 确认 ANTHROPIC_AUTH_TOKEN 填的是 Cubicspaces API Key。
• 确认 ANTHROPIC_BASE_URL 填的是 API 端点，不是控制台页面地址。
• Claude Code 的 Base URL 不要手动追加 /v1，客户端会请求 /v1/messages。
• 修改配置后重启终端会话。
• 如果本机存在旧环境变量，可能会覆盖配置文件。