设备初始化与环境配置

好的工具配置是一次性投入——5 分钟的初始设置，换来此后每天顺畅的工作流。

完整配置架构

自动化配置脚本

"""
Claude 工具链配置检查与向导
"""
import subprocess
import sys
import os
from dataclasses import dataclass, field
@dataclass
class CheckResult:
name: str
status: str      # ok / missing / outdated
version: str = ""
fix_cmd: str = ""
note: str = ""
class ClaudeSetupChecker:
"""Claude 开发环境配置检查器"""
REQUIRED_TOOLS = {
"node": {
"check": "node --version",
"min_version": "18",
"install_mac": "brew install node",
"install_linux": "curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs",
},
"npm": {
"check": "npm --version",
"min_version": "8",
"install_mac": "brew install node",
"install_linux": "sudo apt-get install -y npm",
},
"git": {
"check": "git --version",
"min_version": "2",
"install_mac": "brew install git",
"install_linux": "sudo apt-get install -y git",
},
"claude": {
"check": "claude --version",
"min_version": "1",
"install_mac": "npm install -g @anthropic-ai/claude-code",
"install_linux": "npm install -g @anthropic-ai/claude-code",
},
"python3": {
"check": "python3 --version",
"min_version": "3.10",
"install_mac": "brew install python",
"install_linux": "sudo apt-get install -y python3",
},
}
@classmethod
def check_tool(cls, tool_name: str, config: dict) -> CheckResult:
try:
result = subprocess.run(
config["check"].split(),
capture_output=True, text=True, timeout=5,
)
if result.returncode == 0:
version = result.stdout.strip().split("\n")[0]
return CheckResult(
name=tool_name,
status="ok",
version=version,
note="✅ 已安装",
)
except (FileNotFoundError, subprocess.TimeoutExpired):
pass
platform = "mac" if sys.platform == "darwin" else "linux"
fix_cmd = config.get(f"install_{platform}", "手动安装")
return CheckResult(
name=tool_name,
status="missing",
fix_cmd=fix_cmd,
note="❌ 未安装",
)
@classmethod
def check_api_key(cls) -> CheckResult:
key = os.environ.get("ANTHROPIC_API_KEY", "")
if key and key.startswith("sk-ant-"):
return CheckResult("ANTHROPIC_API_KEY", "ok", note="✅ 已配置")
return CheckResult(
"ANTHROPIC_API_KEY",
"missing",
fix_cmd="export ANTHROPIC_API_KEY='sk-ant-...' (加入 ~/.zshrc 或 ~/.bashrc)",
note="❌ 未设置",
)
@classmethod
def full_check(cls) -> list[CheckResult]:
results = []
for tool, config in cls.REQUIRED_TOOLS.items():
results.append(cls.check_tool(tool, config))
results.append(cls.check_api_key())
return results
@staticmethod
def print_report(results: list[CheckResult]):
print("=== Claude 开发环境检查报告 ===\n")
ok_count = sum(1 for r in results if r.status == "ok")
print(f"通过: {ok_count}/{len(results)}\n")
for r in results:
print(f"  {r.note} {r.name}")
if r.version:
print(f"       版本: {r.version}")
if r.fix_cmd:
print(f"       修复: {r.fix_cmd}")
if ok_count == len(results):
print("\n🎉 环境配置完整！可以开始使用 Claude Code。")
else:
missing = [r for r in results if r.status == "missing"]
print(f"\n⚠️  {len(missing)} 项需要配置，按上方命令依次执行即可。")
checker = ClaudeSetupChecker()
results = checker.full_check()
checker.print_report(results)

各平台快速配置命令

macOS (推荐)

# 1. 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装基础工具
brew install node git python
# 3. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 4. 配置 API Key（加入 ~/.zshrc）
echo 'export ANTHROPIC_API_KEY="sk-ant-YOUR_KEY"' >> ~/.zshrc
source ~/.zshrc
# 5. 验证安装
claude --version

Windows (WSL2)

# PowerShell 管理员模式运行
wsl --install -d Ubuntu
# 进入 WSL2 后执行
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs git python3 python3-pip
npm install -g @anthropic-ai/claude-code
# 配置 API Key
echo 'export ANTHROPIC_API_KEY="sk-ant-YOUR_KEY"' >> ~/.bashrc
source ~/.bashrc

Shell 别名配置（提效神器）

# 加入 ~/.zshrc 或 ~/.bashrc
# Claude Code 快捷命令
alias cc="claude"
alias ccr="claude --resume"                    # 恢复上次会话
alias ccc="claude --continue"                  # 继续最近任务
# 常用工作流别名
alias review="claude 'review this code for bugs and improvements:'"
alias explain="claude 'explain this in simple terms:'"
alias draft="claude 'write a professional email for:'"
alias summarize="claude 'summarize the key points of:'"
# Git 集成
alias gcommit='git diff --staged | claude "write a concise git commit message for these changes"'

平台对比

行动清单

• [ ] 运行配置检查脚本，确认 node、git、claude CLI 全部 ✅
• [ ] 在 Anthropic Console 生成 API Key，加入 shell 配置文件（.zshrc 或 .bashrc）
• [ ] 配置 5–8 个常用 shell 别名（review/explain/draft/summarize），立即提升使用频率
• [ ] Windows 用户：安装 WSL2 + Ubuntu，Claude Code 在 Linux 环境下体验远优于 Windows 原生
• [ ] 手机安装官方 Claude App（iOS/Android），作为浏览器的移动端补充入口
• [ ] 测试：在项目目录运行 claude，确认能正常启动并感知代码库上下文

下一章：02-Claude-Chat深度工作流/01-Projects与知识库管理 — 深入 Claude Chat 最被低估的功能：Projects 知识库。