Claude Code 安装、配置、使用与认证指南

Claude Code 是 Anthropic 的 AI 编程助手，可读取代码库、编辑文件、执行命令，并与终端、IDE、桌面端、网页等环境集成。本文介绍其安装、配置、使用、认证与订阅方案，以及通过 OpenRouter 接入的使用方式。

一、简介与特点

• 多环境：终端 CLI、VS Code / Cursor、JetBrains、桌面应用、浏览器 claude.ai/code、Slack、iOS 等
• Agent 能力：多文件编辑、执行命令、与 Git 协作（提交、分支、PR）、计划审查后再应用变更
• CLAUDE.md：项目根目录或 .claude/ 下的说明文件，每轮会话会读取，用于约定规范、架构与偏好
• MCP：支持 Model Context Protocol，可接 Google Drive、Jira、Slack 等外部数据与工具
• 子 Agent / 自定义命令：可配置多 Agent 协作、自定义技能（如 /review-pr）
• 第三方后端：终端与 VS Code 支持通过环境变量使用 OpenRouter 等第三方 API，绕过地域或订阅限制

二、安装

系统要求

• 操作系统：macOS 13+、Ubuntu 20.04+ / Debian 10+、Windows 10 1809+（建议 WSL）、Alpine 3.19+
• 内存：建议 4GB+ RAM
• Windows 需先安装 Git for Windows

安装方式

# 推荐：原生安装（自动后台更新）
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# Homebrew（需手动升级）
brew install --cask claude-code

# WinGet（需手动升级）
winget install Anthropic.ClaudeCode

安装后可运行 claude doctor 检查环境与安装状态。

三、认证方式

方式一：Claude 订阅（推荐个人）

• 使用 Claude Pro 或 Max 订阅，在终端或 App 内执行 claude 或 /login，按提示完成 OAuth 登录
• 与网页版 Claude 共享同一订阅额度（每 5 小时滚动窗口）
• 适合日常开发，无需单独管理 API Key

方式二：Anthropic Console（API Key）

• 在 Anthropic Console 创建 API Key，配置到环境变量或 Claude Code 设置
• 按 API 定价 按量计费，不占用订阅额度池
• 适合脚本、CI 或需要固定模型/配额时使用

方式三：团队 / 企业

• Claude for Teams 或 Enterprise：通过 Claude 管理端配置团队账单、SSO、合规等
• 云厂商：可对接 Amazon Bedrock、Google Vertex AI、Microsoft Foundry 等（需相应配置）

四、基本使用

交互模式

# 进入项目目录后启动
cd your-project
claude

# 带初始提示启动
claude "解释这个项目的结构并列出入口文件"

# 继续最近一次对话
claude -c

# 按会话 ID 或名称恢复
claude -r auth-refactor
claude -r ""   # 弹出会话选择器

非交互模式（管道 / 脚本）

# 单次提问后退出，输出到 stdout
claude -p "列出 src 下所有 TypeScript 文件并简要说明"

# 管道输入
cat logs.txt | claude -p "总结错误类型"
git diff main --name-only | claude -p "审查这些变更是否有安全风险"

# 输出 JSON 便于脚本解析
claude -p "分析依赖" --output-format json

常用命令速览

常用命令行参数

交互界面内输入 /help 可查看斜杠命令，/config 打开设置界面。

五、配置

配置作用域

优先级：User < Project < Local < 命令行 < Managed。

配置文件示例（节选）

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": ["Bash(npm run *)", "Read(~/.zshrc)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  }
}

• permissions：控制允许/拒绝的工具与路径（如 Bash 命令、Read 路径）
• 其他常见项：模型偏好、MCP、插件、hooks 等，详见 Settings 文档

MCP 服务器可在 User 的 ~/.claude.json 或 Project 的 .mcp.json 中配置；交互内通过 /config 也可查看与修改部分设置。

CLAUDE.md

在项目根或 .claude/ 下放置 CLAUDE.md（或 CLAUDE.local.md 仅本机），用于编写项目规范、构建命令、架构说明等，Claude Code 每次会话会读取。

六、订阅方案与价格（参考）

价格与额度以 Claude 定价页 为准，下表为常见参考：

• 5 小时滚动窗口：从第一条消息起算，5 小时后额度重置，非自然日/月
• 网页 Claude 与 Claude Code 共享同一额度池
• Pro 在 IDE 插件中只能用 Sonnet；若需在 IDE 中使用 Opus，需 Max

七、使用 OpenRouter 接入

通过设置环境变量，可将 Claude Code 的请求转发到 OpenRouter，使用 OpenRouter 的 API Key 与模型（如 Claude、GPT、Gemini 等），常用于绕过地域限制或统一走 OpenRouter 计费与路由。

1. 获取 OpenRouter API Key

在 OpenRouter Keys 注册并创建 API Key（形如 sk-or-v1-...）。

2. 设置环境变量

设置 ~/.claude/settings.json 文件，使用 OpenRouter 模型提供商。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-xxxxxx",
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-4.6"
  },
  "includeCoAuthoredBy": false
}

也可以使用 cc-switch 的图形化界面进行设置。

3. 启动与验证

claude

若此前已用 Anthropic 账号登录，建议先执行 /logout 或 claude auth logout 清除本地凭据，再重新运行 claude。在会话内输入 /status 可查看当前 API 地址与模型信息；也可在 OpenRouter 后台的 Activity 中确认是否有请求。

八、参考链接

• Claude Code 概览与安装
• Claude Code 设置
• Claude Code CLI 参考
• Claude 定价
• OpenRouter：多模型统一 API