Claude Code系列教程6：如何认证-浏览器登录与手动配置 API Key

认证流程：浏览器登录与手动配置 API Key

安装完 Claude Code 之后，还需要认证完成才能使用。你需要把工具跟你的 Anthropic 账号绑在一起。绑定方式有两种：浏览器登录和手动配置 API Key。两种方式最终效果一样，挑你觉得方便的来。

方式一：浏览器登录（推荐）

Claude Code 提供了一个自动认证命令 claude login，它会打开浏览器，让你在网页上授权，然后自动把凭证写回终端。

操作步骤：

1. 在终端输入：

bash claude login

1. 系统会输出一串提示，并自动在你的默认浏览器中打开 Anthropic 的授权页面。
   如果没有自动打开，终端上会打印一个链接，手动复制到浏览器里打开也行。

2. 在浏览器中登录你的 Anthropic 账号（如果已经登录，这个页面会直接请求授权）。

3. 点击“允许”或“授权”，浏览器页面会显示“授权成功，可以关闭此页面”。

4. 回到终端，你会看到认证完成的提示。此时再运行 claude 命令，就已经和你的账号关联上了。

方式二：手动配置 API Key

如果你用的是无图形界面的服务器、容器，或者不想走浏览器授权，可以直接从 Anthropic 控制台获取 API Key，然后配到 Claude Code 里。

步骤：

1. 打开浏览器，访问 https://console.anthropic.com，登录你的 Anthropic 账号。

2. 进到 API Keys 页面（通常在设置或开发者选项下），点击“创建 API Key”。

3. 给 Key 取个名字（比如 claude-code-local），生成后立刻复制下来。
   注意：这个 Key 只显示一次，关掉页面就看不到了。如果忘记保存，删掉旧的重新生成即可。

4. 回到终端，有两种方式把 Key 喂给 Claude Code：

A. 环境变量法：

bash export ANTHROPIC_API_KEY=你的-api-key

把这行加到你的 ~/.bashrc 或 ~/.zshrc 里，以后每次都自动生效。

B. 配置写入文件：

Claude Code 也会读取它自己的配置文件。手动编辑 ~/.claude/config.json（如果没有就新建），写入：

json { "apiKey": "你的-api-key" }

注意：这个文件的权限建议设成 600（chmod 600 ~/.claude/config.json），防止其他用户读取。

1. 测试连接：

bash claude "你好，请回复一个'OK'"

如果能收到正常回复，说明 Key 配好了。

手动配置常见的失误：

• Key 不要以 sk-ant- 或 sk- 开头？不，Anthropic 的 API Key 确实是 sk-ant-api03- 开头的长字符串。复制时别漏掉字符。
• 如果你同时设置了环境变量和文件，环境变量优先级更高。只保留一种就好，避免混乱。
• Key 是收费凭证，不要提交到 Git 仓库。建议配合 .gitignore 忽略整个 ~/.claude 目录或配置文件。

切换账号或登出

想换个账号，或者清理掉本地凭证：

• 如果用的是 claude login：执行 claude logout，然后重新 claude login 即可。
• 如果手动配了 Key：删掉环境变量或配置文件里的旧 Key，用新 Key 代替。

测试认证是否正常

claude "解释一下当前目录是做什么的"

如果它能读出你的项目概况，说明环境已就绪。