Claude Code 安装

Claude Code 是 Anthropic 官方推出的命令行工具，让你可以在终端中直接与 Claude 交互，完成代码编写、调试、重构等任务。

系统要求

• 操作系统：macOS 10.15+、Windows 10/11、Linux、WSL
• Node.js：18.0 或更高版本
• 内存：建议 4GB 以上

一键安装（推荐）

macOS / Linux / WSL

source <(curl -fsSL https://claude-zh.cn/scripts/install.sh)

Windows PowerShell

& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))

脚本功能

一键安装脚本会自动检测 Node.js、安装 Claude Code、写入基础设置，并引导你选择官方 Anthropic、自定义 Provider/OpenRouter，或暂时跳过 API 配置。

手动安装

1. 安装 Node.js

macOS

brew install node

Windows

winget install OpenJS.NodeJS.LTS

Linux/WSL

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 Claude Code

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

国内网络如果 npm 官方源较慢，可以临时使用镜像安装，安装后再切回官方源：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
npm config set registry https://registry.npmjs.org

配置 API

Claude Code 需要可用的 Claude API。你可以选择三种方式：

方式	适合谁	配置思路
Anthropic 官方服务	能直接使用官方 API 的用户	设置 ANTHROPIC_API_KEY
OpenRouter	想使用聚合平台或 OpenAI-compatible 接口的用户	按 OpenRouter 文档配置 base URL 和 key
自定义 Provider / cc switch	已有自己的服务商或需要多服务商切换的用户	使用对应工具或服务商提供的环境变量

官方 Anthropic

将下面内容加入 ~/.bashrc 或 ~/.zshrc：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxx"

Windows PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxx", "User")

OpenRouter 或自定义 Provider

如果你的服务商提供 OpenAI-compatible 或 Anthropic-compatible 接口，请按它的文档填写 base URL、token 和模型名。常见形式如下：

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_AUTH_TOKEN="你的-provider-key"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.5"

注意

不同 provider 对 URL、鉴权字段和模型名的要求不同。上面只是 OpenRouter 风格示例；如果你使用 cc switch 或其他切换工具，以工具生成的配置为准。

Claude Code 设置

创建或编辑 ~/.claude/settings.json：

{
  "hasCompletedOnboarding": true,
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "includeCoAuthoredBy": false
}

启动 Claude Code

claude

常用命令：

命令	说明
claude	启动交互式会话
claude "你的问题"	直接提问
claude --help	查看帮助信息

Shift+Tab 切换模式

在 Claude Code 中按 Shift+Tab 可切换权限确认模式。

Windows 用户须知

Claude Code 支持 Windows 原生环境。建议使用 PowerShell 或 Windows Terminal。如果脚本执行受限，可以运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

常见问题

Q: 提示 API key not found？

检查你是否已经设置官方 ANTHROPIC_API_KEY，或按自定义 provider 文档设置了对应 token/base URL。

Q: 连接超时？

检查网络连接、base URL 是否可访问、模型名是否存在，以及当前 provider 是否支持 Claude 模型。

Q: 我应该选哪个 provider？

能使用官方服务就优先使用官方服务；需要聚合平台可以考虑 OpenRouter；已有服务商或多服务商需求则使用自定义 provider 或 cc switch 类工具。

---

如需更多工具配置，请继续查看本站 Codex、OpenCode、VS Code 插件和 OpenClaw 教程。