ClaudeCode 本地安装配置部署完整指南（2026 最新）

本文提供 官方 ClaudeCode CLI/Desktop App 与 开源本地代理方案 两种路径的详细步骤，涵盖全平台（Windows/macOS/Linux），可直接复制命令执行，兼容国内网络环境优化配置Claude Code 中文站

一、安装前准备

1.1 基础环境要求

表格

组件	最低版本	检查命令	下载地址
Node.js	18.x LTS	`node -v`	nodejs.org
npm	8.x+	`npm -v`	随 Node.js 安装
Git	2.0+（推荐）	`git --version`	git-scm.com
Docker	20.10+（Docker 部署用）	`docker -v`	docker.com
Ollama	0.1.38+（本地模型用）	`ollama -v`	ollama.com

1.2 必备账号与密钥

Anthropic 账号（需开通 API 权限）
API Key（从Anthropic 控制台获取，仅显示一次，请妥善保存）
可选：Claude Pro 订阅（解锁高级功能与更低费率）

二、官方 ClaudeCode 安装部署（推荐）

方案 A：ClaudeCode CLI（全平台通用）

步骤 1：安装官方 CLI（三种方式）

方式 1：一键脚本安装（推荐）

bash

运行

# macOS/Linux/WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell（管理员权限）
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```{insert\_element\_1\_}

**方式2：npm安装（国内加速）**
```bash
# 切换国内npm镜像
npm config set registry https://registry.npmmirror.com

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version  # 应显示版本号，如1.2.0
```{insert\_element\_2\_}

**方式3：包管理器安装**
```bash
# macOS Homebrew
brew tap anthropic/claude
brew install claude-code

# Windows WinGet
winget install Anthropic.ClaudeCode
```{insert\_element\_3\_}

#### 步骤2：配置认证（三种方式）

**方式1：交互式登录（推荐）**
```bash
claude auth login
# 浏览器自动打开，用Anthropic账号登录授权
```{insert\_element\_4\_}

**方式2：环境变量配置（临时/永久）**
```bash
# 临时设置（仅当前会话生效）
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"  # Linux/macOS
$env:ANTHROPIC_API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"  # Windows PowerShell

# 永久设置（用户级）
# Linux/macOS：添加到~/.bashrc或~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# Windows：PowerShell永久设置
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "User")
```{insert\_element\_5\_}

**方式3：配置文件设置（全局/项目级）**
```bash
# 全局配置（~/.claude/settings.json）
mkdir -p ~/.claude  # Linux/macOS
mkdir -p %USERPROFILE%\.claude  # Windows

# 创建settings.json
echo '{
  "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
  "DEFAULT_MODEL": "claude-3-opus-20240229"
}' > ~/.claude/settings.json

# 项目级配置（在项目根目录）
mkdir -p .claude
echo '{
  "DEFAULT_MODEL": "claude-3-sonnet-20240229",
  "temperature": 0.3
}' > .claude/settings.json

步骤 3：基本使用示例

bash

运行

# 代码生成
claude code "写一个Python快速排序算法，带详细注释"

# 代码解释
claude explain "这段JavaScript代码的作用是什么？" --file app.js

# 代码重构
claude refactor "优化这段Java代码的性能" --file UserService.java

# 项目上下文分析
claude project analyze  # 分析当前项目结构与依赖

方案 B：ClaudeCode Desktop App（图形界面）

安装步骤

bash

运行

# macOS
open -a "App Store" && echo "搜索Claude Code并安装"
# 或Homebrew
brew install --cask claude-code

# Windows
start ms-windows-store://pdp/?productid=9nblggh6h7nd
# 或手动下载
start https://apps.microsoft.com/detail/9nblggh6h7nd

首次启动配置

打开 ClaudeCode App
选择 "Sign in with Anthropic"
浏览器自动弹出登录页面，完成授权
授予文件访问、网络访问权限
配置默认模型与代码生成偏好

三、本地模型代理部署方案（离线 / 隐私保护）

ClaudeCode 无官方本地模型，此方案通过Ollama 部署开源代码模型 + 代理服务实现本地调用，代码不出本地。

方案 A：Ollama + DeepSeek-Coder（推荐）

步骤 1：安装 Ollama

bash

运行

# Linux/macOS
curl -fsSL https://ollama.com/install.sh | sh

# Windows
irm https://ollama.com/install.ps1 | iex

步骤 2：拉取并运行代码模型

bash

运行

# 推荐DeepSeek-Coder（代码能力强，支持FIM）
ollama run deepseek-coder:6.7b-instruct

# 可选：CodeLlama（Meta官方代码模型）
ollama run codellama:7b-code

步骤 3：部署 ClaudeCode 兼容代理

bash

运行

# 克隆代理仓库
git clone https://github.com/anthropics/anthropic-sdk-python.git
cd anthropic-sdk-python/examples/proxy-server

# 安装依赖
pip install -r requirements.txt

# 启动代理（对接本地Ollama）
python proxy_server.py --model deepseek-coder:6.7b-instruct --host 0.0.0.0 --port 8080

步骤 4：配置 ClaudeCode 使用本地代理

bash

运行

# 临时设置
export ANTHROPIC_BASE_URL="http://localhost:8080/v1"
export ANTHROPIC_API_KEY="sk-local-placeholder"  # 本地代理无需真实密钥

# 永久设置（Linux/macOS）
echo 'export ANTHROPIC_BASE_URL="http://localhost:8080/v1"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-local-placeholder"' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell永久设置
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "http://localhost:8080/v1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-local-placeholder", "User")

方案 B：Docker 部署代理服务

bash

运行

# 克隆代理仓库
git clone https://github.com/ymichael/open-claude.git
cd open-claude

# 构建Docker镜像
docker build -t claude-proxy .

# 启动容器（对接本地Ollama）
docker run -d \
  --name claude-proxy \
  -p 3000:3000 \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -e DEFAULT_MODEL=deepseek-coder:6.7b-instruct \
  claude-proxy

# 配置ClaudeCode使用Docker代理
export ANTHROPIC_BASE_URL="http://localhost:3000/v1"
export ANTHROPIC_API_KEY="sk-local-placeholder"

四、高级配置与国内优化

4.1 配置文件详解（~/.claude/settings.json）

json

{
  "ANTHROPIC_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
  "DEFAULT_MODEL": "claude-3-sonnet-20240229",  // 模型选择
  "temperature": 0.3,  // 0-1，越低越稳定
  "max_tokens": 4096,  // 最大生成tokens
  "top_p": 0.9,  // 采样参数
  "system_prompt": "你是一个资深程序员，生成代码必须符合行业最佳实践",  // 自定义系统提示
  "editor": "code",  // 默认编辑器：code/vim/nano
  "save_history": true,  // 保存历史记录
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": true  // 禁用非必要流量（国内优化）
}

4.2 国内网络优化

bash

运行

# 1. 使用国内API中转服务（如letai.cc）
export ANTHROPIC_BASE_URL="https://api.letai.cc/v1/anthropic"

# 2. 配置网络代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 3. 禁用自动更新（避免网络问题）
export CLAUDE_CODE_DISABLE_AUTO_UPDATE=true

4.3 系统服务部署（Linux）

bash

运行

# 创建systemd服务文件
sudo nano /etc/systemd/system/claude-proxy.service

# 粘贴以下内容
[Unit]
Description=ClaudeCode Local Proxy Service
After=network.target

[Service]
User=your_username
WorkingDirectory=/home/your_username/open-claude
ExecStart=python proxy_server.py --model deepseek-coder:6.7b-instruct --host 0.0.0.0 --port 8080
Restart=always

[Install]
WantedBy=multi-user.target

# 启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable claude-proxy
sudo systemctl start claude-proxy

五、VS Code 集成配置

安装Claude Code插件（Anthropic 官方）
打开设置 → 扩展 → Claude Code
配置以下参数：
- Anthropic: Api Key：填入你的 API 密钥
- Anthropic: Base Url：国内用户可设置中转地址
- Claude Code: Default Model：选择 claude-3-sonnet（平衡速度与质量）
重启 VS Code，使用快捷键Ctrl+Shift+P → "Claude Code: Start Session" 开始使用

六、常见问题解决

表格

问题	解决方法
安装失败	1. 升级 Node.js 到 18+；2. 使用管理员权限；3. 清理 npm 缓存：`npm cache clean --force`；4. 切换国内镜像
认证失败	1. 检查 API Key 是否正确；2. 重新登录：`claude auth logout && claude auth login`；3. 检查网络连接
响应缓慢	1. 切换到 claude-3-sonnet 模型；2. 降低 temperature 值；3. 使用国内中转 API；4. 配置代理
本地模型性能差	1. 确保 GPU 显存≥16GB；2. 关闭其他占用资源的程序；3. 使用量化版模型（如:q4_K_M）
国内无法访问	1. 使用中转服务；2. 配置网络代理；3. 检查防火墙设置

七、总结与下一步

官方方案：适合需要完整 ClaudeCode 功能、接受联网调用的用户，配置简单，功能全面（代码生成、解释、重构、项目分析）
开源代理方案：适合需要离线使用、保护代码隐私的用户，需一定技术基础，代码能力接近原版

ClaudeCode 本地安装配置部署完整指南（2026 最新）

一、安装前准备

1.1 基础环境要求

1.2 必备账号与密钥

二、官方 ClaudeCode 安装部署（推荐）

方案 A：ClaudeCode CLI（全平台通用）

步骤 1：安装官方 CLI（三种方式）

步骤 3：基本使用示例

方案 B：ClaudeCode Desktop App（图形界面）

安装步骤

首次启动配置

三、本地模型代理部署方案（离线 / 隐私保护）

方案 A：Ollama + DeepSeek-Coder（推荐）

步骤 1：安装 Ollama

步骤 2：拉取并运行代码模型

步骤 3：部署 ClaudeCode 兼容代理

步骤 4：配置 ClaudeCode 使用本地代理

方案 B：Docker 部署代理服务

四、高级配置与国内优化

4.1 配置文件详解（~/.claude/settings.json）

4.2 国内网络优化

4.3 系统服务部署（Linux）

五、VS Code 集成配置

六、常见问题解决

七、总结与下一步

评论区

ClaudeCode 本地安装配置部署完整指南（2026 最新）