Claude Code 安装与配置指南

本文将带你从零开始安装 Claude Code，配置 API Key，并与 Wishmere 集成，让你快速上手 AI 辅助编程。

安装前提

在安装 Claude Code 之前，请确保你的环境满足以下条件：

• Node.js 20+ — Claude Code 基于 Node.js 运行，推荐使用 LTS 版本
• Anthropic API Key — 前往 Anthropic Console 获取 API Key
• Git — 用于版本控制和项目协作

检查 Node.js 版本：

node --version
# 应输出 v20.x.x 或更高

安装步骤

全局安装

使用 npm 全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

验证安装

安装完成后，验证是否安装成功：

claude --version
# 应输出 claude-code/x.x.x

首次认证

运行 Claude Code 并完成认证：

claude
# 首次运行会提示输入 API Key 或通过浏览器登录

你也可以直接通过环境变量设置 API Key：

export ANTHROPIC_API_KEY=sk-ant-xxxxx

配置详解

API Key 配置

Claude Code 支持多种方式配置 API Key：

• 环境变量 — ANTHROPIC_API_KEY，推荐在 .env 文件或 shell 配置中设置
• 交互式登录 — 首次运行时通过浏览器 OAuth 登录
• 配置文件 — ~/.claude/config.json 中设置

自定义 Base URL

如果你使用代理或自定义端点，可以设置 Base URL：

export ANTHROPIC_BASE_URL=https://your-proxy.example.com/anthropic

模型选择

Claude Code 默认使用 claude-sonnet-4-20250514，你可以通过参数切换模型：

claude --model claude-opus-4-20250514

或在 CLAUDE.md 中配置默认模型：

# CLAUDE.md
model: claude-sonnet-4-20250514

推理努力级别

通过 --thinking-budget 控制推理深度：

claude --thinking-budget high    # 深度思考，适合复杂任务
claude --thinking-budget medium  # 平衡模式（默认）
claude --thinking-budget low     # 快速响应，适合简单任务

与 Wishmere 集成

自动检测

Wishmere 会自动检测已安装的 Claude Code，无需额外配置。

模型配置

在 Wishmere 的项目设置中，你可以为不同任务配置不同的模型：

• 代码生成任务 — 使用 Sonnet（速度与质量平衡）
• 架构设计任务 — 使用 Opus（深度推理）
• 简单修改任务 — 使用 Haiku（快速响应）

运行时模型切换

在对话过程中，你可以通过 Wishmere 的命令面板快速切换模型，无需重启会话：

常见问题

1. 安装时报权限错误

如果全局安装时遇到权限问题，使用以下方式之一：

# 方式1：使用 sudo
sudo npm install -g @anthropic-ai/claude-code

# 方式2：使用 nvm 管理 Node.js（推荐）
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code

2. API Key 无效

确认 API Key 格式正确（以 sk-ant- 开头），并且账户有足够的额度。你可以在 Anthropic Console 查看 API Key 状态和用量。

3. 上下文窗口不足

如果项目较大，Claude Code 可能提示上下文窗口不足。解决方案：

• 使用 .claudeignore 排除不需要的文件
• 将大任务拆分为小任务
• 使用 CLAUDE.md 精简上下文

下一步

• Claude Code 常见 10 个坑及解决方案 — 了解使用中的常见问题
• Codex CLI 使用指南 — 对比另一个 AI 编程工具
• Codex CLI 安装与配置指南 — 了解 OpenAI 的替代方案

使用 Wishmere 可以自动管理 Claude Code 的配置和上下文，让你专注于产品本身。

← 返回文章列表