Claude Code (CLI & VS Code) 完整配置指南

Claude Code 是 Anthropic 官方推出的全自动自主编程 Agent 工具。支持在终端命令行（CLI）执行，也可以作为 VS Code 官方插件使用。通过接入 BBToken（https://bbtoken.boywe.cn），国内开发者无需海外网络环境即可直接调用。

💡 接入原则：优先推荐通过 CC Switch 的 OpenAI 格式代理

IMPORTANT

兼容性核心建议：
由于 Claude Code 官方版本更新频繁，经常夹带实验性 Beta Header 与特定的 Token 计量参数，容易与第三方服务发生协议冲突。最稳妥、兼容性最好的方案是通过 CC Switch 将渠道配置为 OpenAI Chat Completions 格式，由本地代理自动消除协议差异。

---

📖 方案一：通过 CC Switch 一键接管（极力推荐）

按照 CC Switch 配置指南将渠道设置为 OpenAI 格式（Base URL 填 https://bbtoken.boywe.cn/v1，模型指定为 deepSeek-V4-flash）。
在 CC Switch 中启动本地代理服务（默认端口 http://127.0.0.1:8080）并设为当前激活。

在终端中直接运行：

bash

export ANTHROPIC_BASE_URL=http://127.0.0.1:8080
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_MODEL=deepSeek-V4-flash
claude --dangerously-skip-permissions

(Windows PowerShell 将 export 替换为 $env:KEY="VALUE")

📖 方案二：终端原生环境变量直连

如果你偏好不借助 CC Switch 客户端直接在终端中跑脚本，请在终端中声明以下经过全面兼容性调优的环境变量：

macOS / Linux (写入 `~/.zshrc` 或 `~/.bashrc`)

bash

# 基础连接与鉴权（使用平台支持的 deepSeek-V4-flash 或 bbqwen3.8-flash-next）
export ANTHROPIC_BASE_URL=https://bbtoken.boywe.cn
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxx
export ANTHROPIC_MODEL=deepSeek-V4-flash
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepSeek-V4-flash
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepSeek-V4-flash
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepSeek-V4-flash

# 稳定性关键参数（规避协议不兼容与超时中断）
export API_TIMEOUT_MS=9000000
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export hasCompletedOnboarding=true

# 免去每次安全确认提示，直接启动：
IS_SANDBOX=1 claude --dangerously-skip-permissions

Windows PowerShell

powershell

$env:ANTHROPIC_BASE_URL="https://bbtoken.boywe.cn"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="deepSeek-V4-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepSeek-V4-flash"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepSeek-V4-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepSeek-V4-flash"

# 稳定性关键参数
$env:API_TIMEOUT_MS="9000000"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
$env:hasCompletedOnboarding="true"

claude --dangerously-skip-permissions

WARNING

直连避坑关键项：

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1：务必配置，禁用 Claude 官方未经标准化的 Beta Header，防止服务端报错；
ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL：三档必须统一指向同一个可用模型（如 deepSeek-V4-flash），否则客户端会回退至官方未开放模型直接断开；
API_TIMEOUT_MS=9000000：调大超时时间，防止复杂代码重构任务在 30 秒内被系统提前掐断。

---

📖 方案三：Claude Code for VS Code 插件配置

在 VS Code 用户设置文件 settings.json（快捷键 Ctrl+Shift+P ➔ 输入 Preferences: Open User Settings (JSON)）中追加如下配置：

json

{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-xxxxxxxxxxxxxxxxxxxxxxxx" },
    { "name": "ANTHROPIC_BASE_URL", "value": "https://bbtoken.boywe.cn" },
    { "name": "ANTHROPIC_MODEL", "value": "deepSeek-V4-flash" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "deepSeek-V4-flash" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "deepSeek-V4-flash" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "deepSeek-V4-flash" },
    { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "deepSeek-V4-flash" },
    { "name": "API_TIMEOUT_MS", "value": "9000000" },
    { "name": "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS", "value": "1" }
  ],
  "claudeCode.selectedModel": "deepSeek-V4-flash"
}

保存后使用快捷键 Ctrl+Shift+P ➔ 执行 Developer: Reload Window 重载窗口，即可在侧边栏直接唤醒使用。