• 适用系统：Rocky Linux 8/9 (以及 RHEL 系列发行版)

• 核心工具：Claude Code, ccswitch, DeepSeek API

• 最后更新：2026-06-17

• 状态：✅ 已验证可用

---

1. 概述与架构

1.1 工作原理

本方案通过 ccswitch 作为配置管理工具，在 Claude Code 和 DeepSeek API 之间建立一个本地路由服务。架构如下：

text

[Claude Code] → [ccswitch 本地路由 :15721] → [DeepSeek API]

1.2 关键组件

组件	作用
Claude Code	AI 编程助手终端工具
ccswitch	管理和切换 Claude Code 的模型供应商配置，提供本地路由服务
DeepSeek API	提供模型推理能力的后端服务

---

2. 前提条件

2.1 系统要求

• Rocky Linux 8 或 9

• Root 或 sudo 权限

• 稳定的网络连接（需能访问 DeepSeek API）

2.2 必需账户

• DeepSeek 平台账号

• 有效的 DeepSeek API Key（以 sk- 开头）

2.3 软件依赖

# 安装 Node.js (Claude Code 需要)
sudo dnf install -y nodejs

# 验证安装
node --version  # 应显示 v16 或更高版本
npm --version

---

3. 安装步骤

3.1 安装 Claude Code

方法一：使用 npm 安装（推荐）

sudo npm install -g @anthropic-ai/claude-code@2.1.179
方法二：使用官方脚本（需网络通畅）
bash

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

验证安装：

claude --version
# 应显示类似: 2.1.179

3.2 安装 ccswitch

访问 ccswitch GitHub Releases 下载对应版本。

# 示例：下载 Linux x64 版本
wget https://github.com/ccswitch/ccswitch/releases/latest/download/ccswitch-linux-x64.AppImage
chmod +x ccswitch-linux-x64.AppImage
./ccswitch-linux-x64.AppImage

3.3 配置 DeepSeek API Key

# 将 API Key 设置为环境变量（永久生效）
echo 'export ANTHROPIC_API_KEY="你的DeepSeek_API_Key"' >> ~/.bashrc
source ~/.bashrc

# 验证
echo $ANTHROPIC_API_KEY | head -c 10

---

4. 核心配置（最关键步骤）

4.1 启动 ccswitch 路由服务

1. 打开 ccswitch 应用

2. 进入 路由 (Route) 标签页

3. 开启 总开关

4. 确认状态显示为 "运行中"，端口为 15721

5. 在路由设置中配置 DeepSeek 的 API 信息：

   • Base URL: https://api.deepseek.com/anthropic

   • API Key: 你的 DeepSeek API Key

4.2 配置 Claude Code 配置文件

创建或编辑 ~/.claude/settings.json：

json

{
  "model_providers": {
    "deepseek": {
      "name": "DeepSeek",
      "base_url": "http://127.0.0.1:15721/v1",
      "env_key": "ANTHROPIC_API_KEY",
      "requires_openai_auth": false
    }
  },
  "model": "deepseek-chat",
  "theme": "dark"
}

重要说明：

• base_url 必须指向 ccswitch 本地路由地址

• 模型名称根据路由服务支持的情况调整（详见第 6 节）

4.3 设置必需的环境变量

# 添加到 ~/.bashrc（永久生效）
cat >> ~/.bashrc << 'EOF'
export ANTHROPIC_AUTH_TOKEN="PROXY_MANAGED"
export ANTHROPIC_BASE_URL="http://127.0.0.1:15721/v1"
export ANTHROPIC_API_KEY="你的DeepSeek_API_Key"
EOF

source ~/.bashrc

⚠️ 关键点：ANTHROPIC_AUTH_TOKEN="PROXY_MANAGED" 是必须的，它告诉 Claude Code 跳过官方登录，使用本地代理模式。

---

5. 验证与测试

5.1 验证路由服务

curl -v http://127.0.0.1:15721/health
# 应返回 HTTP 200

5.2 验证环境变量

env | grep ANTHROPIC
# 应显示所有三个环境变量

5.3 测试 API 连接

curl -X POST http://127.0.0.1:15721/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "deepseek-chat",
    "max_tokens": 20,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

5.4 启动 Claude Code

claude

成功标志：

• 界面顶部显示 deepseek · API Usage Billing

• 显示 Using deepseek (from .claude/settings.json)

• 可以正常提问并收到回复

---

6. 常见问题与故障排除

问题 1：ConnectionRefused 错误

原因：ccswitch 路由服务未启动或地址配置错误

解决：

# 检查路由服务状态
netstat -tulpn | grep 15721

# 确保配置中的 base_url 是 http://127.0.0.1:15721/v1

问题 2：Not logged in · Please run /login

原因：ANTHROPIC_AUTH_TOKEN="PROXY_MANAGED" 环境变量未设置

解决：

export ANTHROPIC_AUTH_TOKEN="PROXY_MANAGED"
claude

问题 3：模型不存在错误

原因：模型名称配置不正确

解决：

# 查看路由服务支持的模型列表
curl http://127.0.0.1:15721/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY"

# 常用模型名称：
# - deepseek-chat (V3)
# - deepseek-reasoner (R1)

在配置文件中将 "model" 字段改为正确的名称。

问题 4：配置文件未生效

原因：JSON 格式错误或文件路径不正确

解决：

# 验证 JSON 格式
python3 -c "import json; json.load(open('/root/.claude/settings.json'))"

# 使用 --config 参数强制指定
claude --config ~/.claude/settings.json

---

7. 最佳实践与优化建议

7.1 使用别名简化启动

alias claude-ds='ANTHROPIC_AUTH_TOKEN="PROXY_MANAGED" ANTHROPIC_BASE_URL="http://127.0.0.1:15721/v1" ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" claude'

7.2 配置文件完整示例

{
  "model_providers": {
    "deepseek": {
      "name": "DeepSeek",
      "base_url": "http://127.0.0.1:15721/v1",
      "env_key": "ANTHROPIC_API_KEY",
      "requires_openai_auth": false,
      "models": [
        {"id": "deepseek-chat", "name": "DeepSeek V3"},
        {"id": "deepseek-reasoner", "name": "DeepSeek R1"}
      ],
      "default_model": "deepseek-chat"
    }
  },
  "model": "deepseek-chat",
  "theme": "dark"
}

7.3 性能优化

• 使用 claude --model deepseek-chat 绕过配置文件中的模型选择

• 定期更新 Claude Code 和 ccswitch 到最新版本

---

8. 总结

核心要点

1. ccswitch 路由服务必须运行在 127.0.0.1:15721

2. 三个环境变量缺一不可：ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY

3. 配置文件中的 base_url 必须指向本地路由

4. 模型名称需与路由服务支持的名称匹配

成功标志

claude
# 输出应包含：
# deepseek · API Usage Billing
# Using deepseek (from .claude/settings.json)

---

9. 参考资料

• Claude Code 官方文档

• DeepSeek API 文档

• ccswitch GitHub 仓库

• Windows 安装和使用 CC Switch 完整指南-CSDN博客

---

本文档基于实际部署经验编写，所有步骤均已在 Rocky Linux 9 环境验证通过。