适用系统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 CodeAI 编程助手终端工具ccswitch管理和切换 Claude Code 的模型供应商配置提供本地路由服务DeepSeek API提供模型推理能力的后端服务2. 前提条件2.1 系统要求Rocky Linux 8 或 9Root 或 sudo 权限稳定的网络连接需能访问 DeepSeek API2.2 必需账户DeepSeek 平台账号有效的 DeepSeek API Key以sk-开头2.3 软件依赖# 安装 Node.js (Claude Code 需要) sudo dnf install -y nodejs # 验证安装 node --version # 应显示 v16 或更高版本 npm --version3. 安装步骤3.1 安装 Claude Code方法一使用 npm 安装推荐sudo npm install -g anthropic-ai/claude-code2.1.179 方法二使用官方脚本需网络通畅 bash curl -fsSL https://claude.ai/install.sh | bash验证安装claude --version # 应显示类似: 2.1.1793.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.AppImage3.3 配置 DeepSeek API Key# 将 API Key 设置为环境变量永久生效 echo export ANTHROPIC_API_KEY你的DeepSeek_API_Key ~/.bashrc source ~/.bashrc # 验证 echo $ANTHROPIC_API_KEY | head -c 104. 核心配置最关键步骤4.1 启动 ccswitch 路由服务打开 ccswitch 应用进入路由 (Route)标签页开启总开关确认状态显示为运行中端口为15721在路由设置中配置 DeepSeek 的 API 信息Base URL:https://api.deepseek.com/anthropicAPI Key: 你的 DeepSeek API Key4.2 配置 Claude Code 配置文件创建或编辑~/.claude/settings.jsonjson { 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_TOKENPROXY_MANAGED export ANTHROPIC_BASE_URLhttp://127.0.0.1:15721/v1 export ANTHROPIC_API_KEY你的DeepSeek_API_Key EOF source ~/.bashrc⚠️ 关键点ANTHROPIC_AUTH_TOKENPROXY_MANAGED是必须的它告诉 Claude Code 跳过官方登录使用本地代理模式。5. 验证与测试5.1 验证路由服务curl -v http://127.0.0.1:15721/health # 应返回 HTTP 2005.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 Codeclaude成功标志界面顶部显示deepseek · API Usage Billing显示Using deepseek (from .claude/settings.json)可以正常提问并收到回复6. 常见问题与故障排除问题 1ConnectionRefused错误原因ccswitch 路由服务未启动或地址配置错误解决# 检查路由服务状态 netstat -tulpn | grep 15721 # 确保配置中的 base_url 是 http://127.0.0.1:15721/v1问题 2Not logged in · Please run /login原因ANTHROPIC_AUTH_TOKENPROXY_MANAGED环境变量未设置解决export ANTHROPIC_AUTH_TOKENPROXY_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.json7. 最佳实践与优化建议7.1 使用别名简化启动alias claude-dsANTHROPIC_AUTH_TOKENPROXY_MANAGED ANTHROPIC_BASE_URLhttp://127.0.0.1:15721/v1 ANTHROPIC_API_KEY$ANTHROPIC_API_KEY claude7.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. 总结核心要点ccswitch 路由服务必须运行在127.0.0.1:15721三个环境变量缺一不可ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY配置文件中的base_url必须指向本地路由模型名称需与路由服务支持的名称匹配成功标志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 环境验证通过。