第 3 章：登录与配置

Claude Code 需要联网调用 Anthropic 的大模型。本章介绍两种认证方式，推荐用方式 A（用公司提供的 API Key）。

3.1 方式 A：使用公司提供的 API Key（推荐）

在扩展里直接登录

1. 在 VS Code 左侧活动栏点击 Claude Code 图标
2. 对话面板顶部会显示 "Sign in" 或 "Use API Key" 的入口
3. 选择 Use API Key
4. 把公司管理员发给你的 API Key（一串以 sk-ant- 开头的字符）粘贴进去，回车

持久化（推荐，一次配好永不再登）

每次都粘贴 Key 太麻烦。直接把 Key 写到配置文件里。

macOS： 在 VS Code 里按 Cmd+O，打开 ~/.claude/settings.json。如果文件 / 文件夹不存在，先打开 VS Code 终端（Terminal → New Terminal）执行：

mkdir -p ~/.claude && touch ~/.claude/settings.json

Windows： 打开 C:\Users\<你的用户名>\.claude\settings.json（不存在就在该目录新建一个）。

文件内容写成：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-公司发给你的Key"
  }
}

保存关闭，下次打开 VS Code 就自动加载，再也不用手动登录。

API Key 安全红线

API Key 等同于公司发给你的工作账号密码：

• ❌ 不要发给同事、不要截图发群
• ❌ 不要贴在任何公开聊天里、不要上传到网盘
• ❌ 不要把 settings.json 文件复制给别人

如果不小心泄露，立即联系公司管理员重置。

3.2 方式 B：使用个人 Claude.ai 订阅账号

如果公司没有发 API Key、你自己开通了 Claude Pro / Max 订阅，可以这样登录：

1. 在 Claude Code 对话面板顶部点击 Sign in with Claude account
2. VS Code 会弹出系统浏览器打开 Anthropic 登录页
3. 在浏览器中登录、确认授权
4. 回到 VS Code，提示 "Login successful" 即完成

3.3 公司内部网关 / 代理

如果公司不能直连 Anthropic，IT 会发给你一个 内部网关地址 和一个 AUTH Token。把 settings.json 改成：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "管理员发给你的 token",
    "ANTHROPIC_BASE_URL": "管理员发给你的网关地址"
  }
}

字段	说明
ANTHROPIC_API_KEY	官方 API Key，用于直连 Anthropic
ANTHROPIC_AUTH_TOKEN	公司内部认证 token，配合企业网关使用
ANTHROPIC_BASE_URL	公司内部网关地址

配置文件长什么样？

完整配置只需要 5 行 JSON 即可，不要画蛇添足：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-xxxxx"
  }
}

3.4 验证一切正常

回到 VS Code，点击左侧活动栏的 Claude Code 图标，在底部输入框打一句：

你好，做一下自我介绍

如果几秒钟之内有正常的中文回复，说明全套环境都通了，下一章开始干活。

下一章：第一次使用 →