Claude Code 本地部署指南

确保你的系统满足 Claude Code 的运行要求。Claude Code 需要 Node.js 18+ 以及一个兼容的终端环境。

检查 Node.js 版本：

node --version
# 输出应为 v18.0.0 或更高

npm --version
# 建议 9+

如果 Node.js 版本过低，推荐使用 nvm 安装最新 LTS 版本：

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
nvm use --lts

# Windows 用户可使用 nvm-windows 或直接从 nodejs.org 下载安装包

通过 npm 全局安装 @anthropic-ai/claude-code 包。该命令会在系统中注册 claude 命令。

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

安装完成后验证 CLI 是否可用：

claude --version
# 应显示版本号，如 0.x.x

首次启动 Claude Code 需要进行身份认证。你有两种方式配置 API 密钥：

方式一：交互式登录（推荐）

claude login

该命令会在浏览器中打开 Anthropic Console 的授权页面，完成 OAuth 流程后自动保存凭证。

方式二：手动设置 API 密钥

# 从 Anthropic Console 获取 API Key
# 然后设置为环境变量
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

# 也可以写入 shell 配置文件（~/.bashrc / ~/.zshrc）
echo 'export ANTHROPIC_API_KEY=你的密钥' >> ~/.zshrc
source ~/.zshrc

进入你的项目目录，初始化 Claude Code 配置文件。Claude Code 会在项目根目录生成 CLAUDE.md，用于记录项目上下文和指令。

cd /path/to/your-project

# 初始化 CLAUDE.md（如果尚未存在）
claude init

你还可以在项目中使用 .claude/settings.json 进行更精细的配置：

// .claude/settings.json
{
  "permissions": {
    "allow": ["bash", "read", "edit", "glob", "grep"]
  },
  "hooks": {
    "preToolCall": "echo '准备执行工具调用…'",
    "postToolCall": "echo '工具调用完成'"
  }
}

配置完成后，在项目目录中直接运行 claude 即可启动交互式会话：

# 启动交互式会话
claude

# 直接执行一次性指令
claude -p "解释这个项目的架构"

# 将文件内容作为上下文传入
claude -f src/main.py -p "审查这个文件的代码质量"

# 指定输出格式
claude -p "列出所有 API 端点" --output-format json

常用启动选项一览：

完成上述步骤后，通过几个快速测试来确认 Claude Code 已正确部署并可用：

1. 版本检查

claude --version
# 确认输出版本号且无错误信息

2. 简单问答测试

claude -p "用一句话介绍你自己"

3. 代码理解测试

claude -p "读取当前目录的 package.json，总结项目依赖"

4. 文件操作测试

claude -p "在当前目录创建一个 hello.md 文件，内容为 '# Hello Claude Code'"