一、参考资料【超详细】Claude Code Ubuntu平台完整部署指南-CSDN博客二、安装Claude Code温馨提示Ubuntu系统下安装Claude Code其步骤与Windows平台类似本文仅记录关键步骤。详细步骤请参考Windows系统下快速体验Claude code-CSDN博客1. 更新系统环境sudoapt-getupdatesudoapt-getupgrade2. 安装node.js下载地址NodeSource根据系统版本选择合适的Node.js版本。sudoapt-getinstall-ycurlcurl-fsSLhttps://deb.nodesource.com/setup_26.x|sudo-Ebash-sudoapt-getinstall-ynodejs检查是否安装成功node--versionnpm--version输出示例yoyoyoyo:/media/sda3/workspace$node--versionv26.3.0 yoyoyoyo:/media/sda3/workspace$npm--version11.16.03. 安装Claude Code Clisudonpminstall-ganthropic-ai/claude-code输出示例yoyoyoyo:/media/sda3/workspace$sudonpminstall-ganthropic-ai/claude-code changed2packagesin2mnpmwarn allow-scripts1package hasinstallscripts not yet covered by allowScripts:npmwarn allow-scripts anthropic-ai/claude-code2.1.160(postinstall:nodeinstall.cjs)npmwarn allow-scriptsnpmwarn allow-scripts Runnpmapprove-scripts --allow-scripts-pendingto review, ornpmapprove-scriptspkgto allow.如果安装失败则切换为国内镜像源sudonpmconfigsetregistry https://registry.npmmirror.com检查是否安装成功claude--version4. 配置环境变量sudomkdir-p~/.claudesudogedit ~/.claude/settings.json添加以下内容以deepseek-v4-pro模型为例接入 Claude Code | DeepSeek API Docs{env:{ANTHROPIC_API_KEY:sk-你的真实APIKey,ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_MODEL:deepseek-v4-pro[1m],ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-pro[1m],ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-pro[1m],ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-v4-flash,CLAUDE_CODE_SUBAGENT_MODEL:deepseek-v4-flash,CLAUDE_CODE_EFFORT_LEVEL:max},model:deepseek-v4-pro[1m]}解释说明参数名示例值作用说明ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic指定 API 网关地址将 Anthropic SDK 请求转发到 DeepSeekANTHROPIC_AUTH_TOKEN你的 DeepSeek API KeyAPI 鉴权 Token用于访问 DeepSeek 服务ANTHROPIC_MODELdeepseek-v4-pro默认使用的主模型ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro映射 Claude Opus 模型ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro映射 Claude Sonnet 模型ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash映射 Claude Haiku 模型轻量快速CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash子 Agent 使用的模型通常用于快速任务CLAUDE_CODE_EFFORT_LEVELmax控制推理强度和思考深度5. 启动 Claude# 创建工作空间mkdir~/claude_codecd~/claude_code# 启动claude三、FAQQNote: Claude Code might not be available in your country. Check supported countries at https://anthropic.com/supported-countriesWelcome to Claude Code v2.1.160..........................................................* █████▓▓░ * ███▓░ ░░ ░░░░░░ ███▓░ ░░░ ░░░░░░░░░░ ███▓░ ░░░░░░░░░░░░░░░░░░░ * ██▓░░ ▓ ░▓▓███▓▓░ * ░░░░ ░░░░░░░░ ░░░░░░░░░░░░░░░░ █████████ * ██▄█████▄██ * █████████ *.......█ █ █ █..........................................Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST Please check your internet connection and network settings. Note: Claude Code might not be availableinyour country. Check supported countries at https://anthropic.com/supported-countries解决方法修改~/.claude.json文件末尾添加一行hasCompletedOnboarding:true