news 2026/6/30 14:42:01

Rocky Linux 安装与配置 Claude Code + DeepSeek 完整指南文档信息

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Rocky Linux 安装与配置 Claude Code + DeepSeek 完整指南文档信息

  • 适用系统：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 或 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 环境验证通过。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/30 14:41:49

LightRAG+Ollama实战：比 GraphRAG更快更便宜的知识图谱RAG

在RAG这个领域过去半年最大的变化不是 embedding 或检索算法&#xff0c;而是从向量 RAG 进化到了知识图谱 RAG&#xff08;GraphRAG&#xff09;。微软 2024 年发了 GraphRAG&#xff0c;能解决传统向量 RAG 解决不了的"全局问答"和"跨文档推理"问题&…

作者头像 李华
网站建设 2026/6/30 14:33:51

RPG Maker Decrypter：三步解锁RPG游戏加密资源的革命性解决方案

RPG Maker Decrypter&#xff1a;三步解锁RPG游戏加密资源的革命性解决方案 【免费下载链接】RPGMakerDecrypter Tool for decrypting and extracting RPG Maker XP, VX and VX Ace encrypted archives and MV and MZ encrypted files. 项目地址: https://gitcode.com/gh_mir…

作者头像 李华
网站建设 2026/6/30 14:31:09

企业生产环境下的 AI 模型调用通道：六大主流大模型API中转聚合平台横向对比选型指南

在大模型应用加速渗透到业务核心的当下&#xff0c;一个稳定、可观测、易于治理的 API 聚合通道&#xff0c;已经成为技术团队绕不开的基础设施议题。海外模型访问链路不稳、多厂商模型集成成本高、服务等级难以量化、计费明细不透明——这几项是架构师和运维侧普遍反馈的痛点。…

作者头像 李华
网站建设 2026/6/30 14:26:55

VHDL状态机实战：从ASM图到交通灯控制器的完整设计

1. 从红绿灯到VHDL状态机&#xff1a;为什么需要ASM图&#xff1f; 每次开车经过十字路口时&#xff0c;你有没有想过那些红绿灯是怎么工作的&#xff1f;作为一个硬件工程师&#xff0c;我经常被朋友问到这个问题。其实背后的核心就是一个状态机&#xff0c;而用VHDL实现它的最…

作者头像 李华
网站建设 2026/6/30 14:23:38

Godot4 2D游戏开发实战：从零构建像素地牢冒险

1. 为什么选择Godot4开发像素地牢游戏 第一次接触Godot引擎是在2020年&#xff0c;当时被它轻量级的特性和友好的2D工作流吸引。作为一个独立开发者&#xff0c;我最看重的就是快速原型开发能力。Godot4在保留这些优势的同时&#xff0c;还带来了全新的渲染管线、改进的TileMap…

作者头像 李华