Claude Code 完全实战指南 - 第一章：安装配置与本地大模型

文章目录第一章安装配置与本地大模型1.1 安装 Claude Code1.2 配置本地大模型1.3 项目级配置2.2 安装方法2.2.1 方法一官方安装脚本推荐2.2.2 方法二包管理器安装2.2.3 方法三手动安装2.2.4 安装方法对比2.3 安装验证2.3.1 基础验证清单第一章安装配置与本地大模型1.1 安装 Claude CodeClaude Code 是 Anthropic 出品的 CLI 工具让你在终端里直接与 Claude 对话执行代码、操作文件、调用工具。系统要求macOS 12 / Linux / WSL2Node.js 18Git安装命令# 使用 npm 全局安装npminstall-ganthropic-ai/claude-code# 验证安装claude--version# 首次启动按提示登录 Anthropic 账号claude国内网络加速如果 npm 安装慢换国内源npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-code1.2 配置本地大模型Claude Code 默认调用 Anthropic 的云端 APIClaude 3.5/4 Sonnet 等。但如果你希望节省 API 费用保护代码隐私离线使用可以配置本地大模型。支持方式OpenAI 兼容 APIClaude Code 通过 OpenAI 兼容接口支持本地模型。常见选择本地模型方案特点推荐场景Ollama一键运行模型丰富个人开发、快速验证vLLM高性能生产级团队共享、高并发LM Studio图形界面易用新手入门以 Ollama 为例配置# 1. 安装 Ollamabrewinstallollama# macOScurl-fsSLhttps://ollama.com/install.sh|sh# Linux# 2. 拉取模型推荐 Qwen2.5-Coder-32B代码能力强ollama pull qwen2.5-coder:32b# 3. 启动 Ollama 服务默认端口 11434ollama serve# 4. 测试模型是否正常工作curlhttp://localhost:11434/api/generate-d{ model: qwen2.5-coder:32b, prompt: Hello }配置 Claude Code 使用本地模型# 设置环境变量指向本地 OllamaexportANTHROPIC_BASE_URLhttp://localhost:11434/v1exportANTHROPIC_MODELqwen2.5-coder:32b# 启动 Claude Codeclaude# 或者在 .zshrc / .bashrc 中永久配置echoexport ANTHROPIC_BASE_URLhttp://localhost:11434/v1~/.zshrcechoexport ANTHROPIC_MODELqwen2.5-coder:32b~/.zshrc⚠️注意: 本地模型能力通常弱于 Claude 3.5 Sonnet复杂任务建议切回云端unset ANTHROPIC_BASE_URL配置多个模型快速切换# 在 ~/.zshrc 中定义快捷命令aliasclaude-localANTHROPIC_BASE_URLhttp://localhost:11434/v1 ANTHROPIC_MODELqwen2.5-coder:32b claudealiasclaude-cloudunset ANTHROPIC_BASE_URL unset ANTHROPIC_MODEL claude1.3 项目级配置进入项目目录后Claude Code 会读取项目配置# 进入项目目录cdmy-project# 启动自动加载项目配置claude# 查看当前配置claude config# 设置权限模式见第二章详解claude configsetpermission default项目配置文件位置my-project/ ├── .claude/ │ ├── settings.json # 项目级设置 │ ├── skills/ # Skill 目录核心 │ │ └── *.md │ └── CLAUDE.md # 项目记忆文件 ├── src/ └── ...2.2 安装方法Claude Code 提供了三种安装方式你可以根据自己的偏好选择。2.2.1 方法一官方安装脚本推荐这是最简单、最推荐的安装方式。官方脚本会自动检测你的操作系统下载正确的二进制文件并将其安装到合适的位置。# 使用 curl 运行官方安装脚本curl-sSLhttps://claude.ai/install|sh这个脚本会执行以下操作检测你的操作系统和架构x64 / ARM64从 Anthropic 服务器下载最新版本的 Claude Code将可执行文件安装到~/.local/bin/claudeLinux或/usr/local/bin/claudemacOS如果必要将安装目录添加到你的 PATH 环境变量验证安装claude--version预期输出claude version 0.2.x如果看到版本号说明安装成功。2.2.2 方法二包管理器安装如果你更喜欢使用系统的包管理器可以通过以下方式安装。macOS使用 Homebrew# 添加 Anthropic 的 Homebrew 仓库如果官方提供brewinstallclaude-code注意截至本书写作时Claude Code 可能尚未进入官方 Homebrew 核心仓库。如果上述命令失败请使用官方安装脚本或者通过以下方式安装# 下载最新 releasecurl-L-oclaude https://github.com/anthropics/claude-code/releases/latest/download/claude-darwin-$(uname-m)chmodx claudesudomvclaude /usr/local/bin/Linux使用 npm虽然 Claude Code 本身不是 Node.js 应用但你可以通过 npm 安装它的封装包npminstall-ganthropic-ai/claude-codeArch Linux使用 AURArch 用户可以通过 AUR 安装yay-Sclaude-code# 或者paru-Sclaude-code2.2.3 方法三手动安装如果你需要精确控制安装过程或者处于没有网络访问权限的环境可以选择手动安装。步骤 1下载二进制文件访问官方发布页面下载适合你系统的版本# macOS Apple Siliconcurl-L-oclaude https://github.com/anthropics/claude-code/releases/latest/download/claude-darwin-arm64# macOS Intelcurl-L-oclaude https://github.com/anthropics/claude-code/releases/latest/download/claude-darwin-x64# Linux x64curl-L-oclaude https://github.com/anthropics/claude-code/releases/latest/download/claude-linux-x64# Linux ARM64curl-L-oclaude https://github.com/anthropics/claude-code/releases/latest/download/claude-linux-arm64步骤 2设置可执行权限chmodx claude步骤 3移动到 PATH 目录# 用户级安装mkdir-p~/.local/binmvclaude ~/.local/bin/# 确保 ~/.local/bin 在 PATH 中exportPATH$HOME/.local/bin:$PATH# 将上述 export 添加到 ~/.bashrc 或 ~/.zshrc 以持久化echoexport PATH$HOME/.local/bin:$PATH~/.bashrc步骤 4验证whichclaude claude--version2.2.4 安装方法对比安装方式难度适用场景更新方式离线可用官方脚本简单大多数用户重新运行脚本否包管理器中等喜欢系统管理的用户包管理器更新否手动安装复杂受限环境、精确控制手动下载新版本是下载后2.3 安装验证安装完成后建议进行一系列验证确保 Claude Code 能正常工作。2.3.1 基础验证清单# 1. 检查版本claude--version# 2. 查看帮助信息claude--help# 3. 检查更新claude update# 4. 验证自动补全如果支持claude--completionbash/dev/nullecho补全脚本生成成功