Claude Code 配置
什么是 Claude Code
Claude Code 是 Anthropic 推出的 AI 编程命令行工具,可在终端中进行代码编写、调试、重构等操作。
系统要求
- Node.js 版本 ≥ 18.0
- 操作系统:macOS、Linux、Windows (WSL)
Windows 用户请确保安装了 WSL,请勿使用 Windows 自带的 cmd。
快速开始
1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
2. 获取配置信息
| 配置项 | 说明 | 获取方式 |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | API 认证令牌 | 注册后在「令牌」页面创建(以 sk- 开头) |
| ANTHROPIC_BASE_URL | API 服务地址 | 使用 https://laogouapi.com |
3. 配置并启动
# 设置环境变量
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://laogouapi.com"
# 进入项目目录并启动
cd your-project
claude
启动后按照引导完成初始设置(选择主题 → 确认安全须知 → 信任工作目录)。
永久配置(推荐)
为避免每次手动设置环境变量,将配置写入 shell 配置文件:
# 写入配置
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://laogouapi.com"' >> ~/.zshrc
# 使配置生效
source ~/.zshrc
如果使用 bash,将 ~/.zshrc 替换为 ~/.bashrc。
指定模型
claude --model claude-sonnet-4-20250514
切换回 Anthropic 官方
取消环境变量即可恢复使用官方接口:
unset ANTHROPIC_BASE_URL
常见问题
遇到 "Invalid API Key · Please run /login" 错误?
请检查:
- 是否正确设置了
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL - 令牌是否以
sk-开头 - 使用永久配置后是否重启了终端
为什么显示 "offline" 状态?
Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用,仅表示无法连接到 Google。
请求总是显示 "fetch failed"?
可能是网络环境导致的问题,建议:
- 尝试使用代理工具
- 退出 Claude Code(Ctrl+C)后重新运行
claude命令 - 如果问题持续,请稍后再试
Claude Code 使用 Anthropic Messages 协议(
/v1/messages),本平台已完整支持。