Other
Claude Code使用方法
08-12 11:521、必要的条件
- Node.js 已安装，版本 >= 18
- npm 已安装
- Git 已安装并完成基本配置（user.name 和 user.email）
- 已创建工作目录并初始化 Git
2、安装 Claude Code
2.1 安装方式说明
Claude Code 官方提供原生安装器和 npm 等安装方式。
由于目前被各种封锁的原因，在国内使用官方原生安装器，大概率会失败，Claude Code 对大陆地区的 ip 以及代理严防死，即使科学上网也未必能成功。
虽然 npm 也可以进行安装，不过目前官方已不推荐通过 npm 管理 Claude Code，但由于没有其它方式，所以 npm 更换国内源后安装 Claude Code 仍是目前比较便捷的选择。
2.2 方式一：原生安装器（可选）
官网地址：https://claude.com/
原生安装器命令（原生安装器安装命令和支持系统可能变化，使用前请以 Claude Code 官方 setup 文档为准）：
curl -fsSL https://claude.ai/install.sh | bash
2.3 方式二：npm 安装
npm get registry #查看镜像源
npm config set registry https://registry.npmmirror.com #更换阿里镜像
npm install -g @anthropic-ai/claude-code
Windows 提醒：Claude Code 对 Windows 的支持方式会随版本变化。若官方文档提示通过 WSL 使用，请在 WSL 的 Linux 终端里执行安装和环境变量配置；如果当前版本支持原生 Windows，再按官方 Windows 说明操作。
2.4 验证安装：
claude --version
预期输出：
3、配置文件和参数说明
安装好 Claude Code 后，需要配置 API 密钥或登录方式才能使用。
3.1 配置文件路径说明
- 全局：`~/.claude/settings.json`（Windows：`C:\Users\<用户名>\.claude\settings.json`）
- 项目级（团队共享）：`项目根目录/.claude/settings.json`（可提交 Git）
- 项目级（个人私有）：`项目根目录/.claude/settings.local.json`（加入 .gitignore）
3.2 三种配置方式对比
| 配置方式 | 持久性 | 作用范围 | 推荐场景 |
|---|---|---|---|
| 临时环境变量 | 关闭终端即失效 | 当前终端窗口 | 快速测试、临时切换 |
| 永久环境变量 | 永久生效 | 所有终端和项目 | 日常一台电脑固定使用 |
配置文件 settings.json |
永久生效 | 全局或特定项目 | 多项目/多模型切换、团队共享 |
3.3 核心配置参数速查表
| 参数（环境变量） | 作用 | 何时使用 |
|---|---|---|
| ANTHROPIC_API_KEY | Anthropic 官方 API Key | 直接使用官方服务时 |
| ANTHROPIC_AUTH_TOKEN | 第三方平台的 API Key | 使用中转/第三方模型时 |
| ANTHROPIC_BASE_URL | API 端点地址（覆盖默认地址） | 使用中转/第三方服务时 |
| ANTHROPIC_MODEL | 默认使用的模型名称或别名 | 持久指定默认模型 |
| ANTHROPIC_DEFAULT_OPUS_MODEL | opus 槽位映射的具体模型 | 自定义三级槽位映射 |
| ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet 槽位映射的具体模型 | 自定义三级槽位映射 |
| ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku 槽位映射的具体模型 | 自定义三级槽位映射 |
| API_TIMEOUT_MS | API 请求超时时间（毫秒） | 网络慢或模型推理耗时长时 |
| CLAUDE_CODE_SUBAGENT_MODEL | 为子Agent指定经济高效的模型 | 大量低成本子任务 （扫描、搜索、简单分析） |
| CLAUDE_CODE_EFFORT_LEVEL | 控制全局推理深度（low～max） | 复杂设计/调试时用 max 常规任务用 high 或 medium |
提示：参数关系说明：`ANTHROPIC_API_KEY` 用于官方直连，`ANTHROPIC_AUTH_TOKEN` 用于第三方服务。两者不要同时设置，否则会冲突。`ANTHROPIC_BASE_URL` 只在使用非官方端点时需要设置。
4、 配置 API 密钥或登录方式
4.1 使用 Anthropic 官方 API（推荐海外用户）
这是最直接的配置方式，适合能稳定访问 Anthropic 服务、具备合规支付方式的用户。国内用户可能会遇到注册、支付、访问稳定性等问题，建议按自己的网络和合规条件谨慎选择。
⑴ 设置环境变量：需要将 API Key 设置为系统环境变量，这样 Claude Code 启动时就能自动读取。
① Windows 用户（PowerShell）
方法一：临时设置（仅当前终端窗口有效，关闭后失效）
$env:ANTHROPIC_API_KEY = "sk-ant-api03-你的实际API-Key"
方法二：永久设置（推荐，一次设置永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-你的实际API-Key", "User")
注意：永久设置后需要重新打开终端才能生效。
② macOS / Linux 用户
编辑 shell 配置文件（根据使用的 shell 选择），如果用 zsh（macOS 默认）：
$ echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的实际API-Key"' >~/.zshrc
如果用 bash：
$ echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的实际API-Key"' >~/.bashrc
使配置立即生效：
$ source ~/.zshrc 或 source ~/.bashrc
4.2 使用第三方API中转服务（国内用户）
如果在国内无法直接访问 Anthropic 的服务，这个方案大概是最佳选择。
注意：很多个人搭建的中转平台，溢价严重，甚至有作假的情况，请仔细甄别。而且避免封号的情况也无法保证，这里不做推荐。
⑴ 主流中转服务对比
| 服务商 | 价格倍率 | 支持模型 | 注册门槛 | 特点 |
|---|---|---|---|---|
| OpenRouter | 1.0-1.1x | Claude全系列 + GPT + 开源 | 低 | 模型最全，国际化 |
| API2D | 1.2-1.5x | Claude + GPT | 低 | 中文界面，支持支付宝 |
| OhMyGPT | 1.1-1.3x | Claude + GPT + 多种 | 低 | 价格较优 |
| CloseAI | 1.2-1.5x | Claude + GPT | 低 | 国内老牌服务 |
⑵ 设置环境变量：Claude Code 通过 `ANTHROPIC_BASE_URL` 环境变量来指定API地址。
① Windows 用户（PowerShell）
临时设置（当前窗口有效）
$env:ANTHROPIC_BASE_URL = "https://openrouter.ai/api/v1"
$env:ANTHROPIC_API_KEY = "sk-or-v1-你的中转服务Key"
永久设置（推荐）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://openrouter.ai/api/v1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-or-v1-你的中转服务Key", "User")
② macOS / Linux 用户
编辑 shell 配置文件
vim ~/.zshrc #或你喜欢的编辑器
在文件末尾添加以下两行
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-你的中转服务Key"
保存后使配置生效
$ source ~/.zshrc
4.3 接入其他模型（DeepSeek/千问/GLM）
Claude Code 不仅可以使用 Claude 模型，还可以通过配置接入其他AI模型。这对国内用户特别有价值 —— 你可以使用国内直连的模型服务，不需要任何代理。
⑴ 接入第三方模型有两种方式：
| 方式 | 原理 | 优点 | 适用场景 |
|---|---|---|---|
| Anthropic 兼容接口（推荐） | 模型厂商提供 Anthropic Messages API 格式的接口，三个槽位自动映射 | 配置简单，无需逐个指定模型名 | 智谱 GLM 等已提供兼容接口的厂商 |
| 直接指定模型 | 通过 --model 或环境变量指定具体模型名称 |
灵活，适用任何 OpenAI 兼容接口 | DeepSeek、通义千问、Ollama 等 |
⑵ 接入 DeepSeek 的完整步骤为例
DeepSeek 是国内极具性价比的 AI 模型，代码能力强。官方为 Claude Code 专门提供了 Anthropic 兼容端点，不需要走 OpenAI 兼容接口。
① 官方文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code。下面的配置与模型名与该文档一致，后续以官方文档为准。
Step 1：在 https://platform.deepseek.com/ 注册并获取 API Key。
Step 2：设置环境变量（注意 Base URL 是 `/anthropic` 端点，不是 `/v1`）
② 方法一：临时设置（仅当前终端窗口生效）
a. Windows 用户（PowerShell）
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
b. macOS / Linux 用户
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
③ 方法二：使用配置文件（推荐，不需重启终端）：
打开/创建配置文件 ~/.claude/settings.json，加入以下配置，保存即可
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}
5、启动 Claude Code
进入项目目录，输入 claude code，启动 Claude Code
