Claude Code

Claude Code 是 Anthropic 推出的终端 AI 编程助手。本文介绍如何将其配置为使用 SwixCode 转发请求。

配置方式

Claude Code 支持两种配置方式：环境变量 和 settings.json。

方式一：环境变量（推荐）

bash

export ANTHROPIC_BASE_URL="https://www.swixcode.com"
export ANTHROPIC_API_KEY="sk-你的SwixCode令牌"
claude

bash

export ANTHROPIC_BASE_URL="https://www.swixcode.com"
export ANTHROPIC_API_KEY="sk-你的SwixCode令牌"
claude

powershell

$env:ANTHROPIC_BASE_URL = "https://www.swixcode.com"
$env:ANTHROPIC_API_KEY = "sk-你的SwixCode令牌"
claude

cmd

set ANTHROPIC_BASE_URL=https://www.swixcode.com
set ANTHROPIC_API_KEY=sk-你的SwixCode令牌
claude

持久化配置

将环境变量写入 Shell 配置文件，避免每次手动设置。

bash

echo 'export ANTHROPIC_BASE_URL="https://www.swixcode.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-你的SwixCode令牌"' >> ~/.zshrc
source ~/.zshrc

bash

echo 'export ANTHROPIC_BASE_URL="https://www.swixcode.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-你的SwixCode令牌"' >> ~/.bashrc
source ~/.bashrc

powershell

# 写入用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://www.swixcode.com', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-你的SwixCode令牌', 'User')
# 重新打开终端生效

方式二：settings.json

Claude Code 支持通过 JSON 配置文件设置环境变量。

全局配置

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.swixcode.com",
    "ANTHROPIC_API_KEY": "sk-你的SwixCode令牌"
  }
}

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.swixcode.com",
    "ANTHROPIC_API_KEY": "sk-你的SwixCode令牌"
  }
}

项目级配置

在项目根目录创建 .claude/settings.json（所有平台通用）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.swixcode.com",
    "ANTHROPIC_API_KEY": "sk-你的SwixCode令牌"
  }
}

安全提示

项目级配置文件可能被提交到 Git。务必在 .gitignore 中添加：

.claude/settings.json

注意事项

API 协议兼容性

Claude Code 使用 Anthropic 原生协议（/v1/messages），而非 OpenAI 格式。

SwixCode 同时支持 Anthropic 和 OpenAI 格式，通常 无需额外配置。如果遇到问题，请确认你的 SwixCode 渠道中已正确添加了 Anthropic 格式的渠道。

Tool Search 功能

当 ANTHROPIC_BASE_URL 设置为非官方地址时，Claude Code 默认会 禁用 MCP Tool Search 功能。

如需重新启用：

bash

export ENABLE_TOOL_SEARCH=true

powershell

$env:ENABLE_TOOL_SEARCH = "true"

自定义请求头

如果你的 SwixCode 网关需要额外的认证头：

bash

export ANTHROPIC_CUSTOM_HEADERS="X-Custom-Header: value"

powershell

$env:ANTHROPIC_CUSTOM_HEADERS = "X-Custom-Header: value"

验证

# 启动 Claude Code 并测试
claude "说 hello"

如果返回了正常回复，说明配置成功 🎉

VSCode 扩展强制登录解决方案

如果 Claude Code 的 VSCode 扩展要求强制登录，可以通过以下方式解决：

1. 创建配置文件

在 ~/.claude/ 目录下创建 config.json 文件：

bash

mkdir -p ~/.claude
touch ~/.claude/config.json

powershell

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.claude\config.json"

2. 添加配置内容

编辑 config.json，写入以下内容：

{
  "primaryApiKey": "swixcode"
}

3. 重启 VSCode

重启 VSCode 使配置生效。重启后扩展将不再要求登录，直接使用 SwixCode 提供的 API。

注意

此方法同时需要配合 ANTHROPIC_BASE_URL 环境变量使用，确保请求发送到 SwixCode 而非 Anthropic 官方服务器。

常见问题

问题	原因	解决方案
401 Unauthorized	API Key 错误	检查令牌是否正确复制
404 Not Found	Base URL 错误	确认地址末尾不要加 /v1
Connection refused	网络不通	检查 SwixCode 服务是否在线
模型不可用	令牌权限不足	在 SwixCode 后台检查令牌的模型范围
VSCode 扩展要求登录	未配置 config.json	参考上方VSCode 扩展强制登录解决方案

进阶

如果你需要在 Claude Code 中使用多个模型提供商（如同时使用 Claude 和 GPT），推荐使用 Claude Code Router。