Claude Code 基础配置

安装完成后，你需要配置 API Key 才能使用 Claude Code。本教程将引导你完成所有必要的配置。

获取 API Key

Claude Code 需要一个 Anthropic API Key 来工作。你有两种方式获取：

方式一：直接申请 Anthropic API Key

  1. 访问 Anthropic Console
  2. 注册账号并登录
  3. 进入 API Keys 页面
  4. 点击 Create Key 创建一个新的 API Key
  5. 复制保存你的 Key（以 sk-ant- 开头）

注意

Anthropic API 需要在账户中充值后才能使用。新注册账户可能有免费额度。

方式二：使用我们的中转 API Key

如果你希望更便捷地使用，可以申请我们的中转 API Key：

  1. 联系管理员获取中转 API Key
  2. 中转服务提供更稳定的网络连接
  3. 支持多种支付方式

配置 API Key

获取到 API Key 后，通过以下方式配置：

方法一：环境变量配置（推荐）

将 API Key 添加到你的 shell 配置文件中：

~/.bashrc 或 ~/.zshrc
# 添加以下内容到文件末尾
export ANTHROPIC_API_KEY="sk-ant-your-api-key-here"

# 保存后，执行以下命令使其生效
source ~/.zshrc  # 或 source ~/.bashrc

方法二：启动时指定

你也可以在启动 Claude Code 时直接指定 API Key：

bash
ANTHROPIC_API_KEY="sk-ant-your-key" claude

首次启动

配置好 API Key 后，进入你的项目目录启动 Claude Code：

bash
# 进入你的项目目录
cd ~/my-project

# 启动 Claude Code
claude

首次启动时，Claude Code 会：

  1. 验证你的 API Key 是否有效
  2. 显示欢迎信息和使用说明
  3. 等待你输入第一条指令

首次对话测试

启动成功后，试试以下简单指令来验证一切正常：

Claude Code 对话
> 你好！请帮我写一个简单的 Python 脚本，打印当前时间

如果 Claude Code 正常回复并生成代码，说明配置成功！

配置完成！

恭喜你成功配置了 Claude Code！你现在可以开始使用它来辅助开发了。

常用配置项

Claude Code 支持以下常用配置：

配置项环境变量说明
API KeyANTHROPIC_API_KEYAnthropic API 密钥
模型选择CLAUDE_MODEL指定使用的模型
最大 TokenMAX_TOKENS单次回复最大 token 数

下一步

配置完成后，你可以继续阅读以下教程：