Claude Code 接入指引

Claude Code 是 Anthropic 官方推出的一款运行在终端（CLI）的智能编程 Agent 工具。它拥有强大的代码理解、全仓库检索、编辑文件、执行命令和自动化排错能力。

通过 GWLLM，您无需官方境外信用卡订阅，即可在本地直接运行 Claude Code，并享受毫秒级低延迟的顶级代码生成体验。

---

快速安装

在安装 Claude Code 之前，请确保本地已安装 Node.js（推荐 18 及以上版本）。

通过 npm 或 bun 全局安装：

# 使用 npm 全局安装
npm install -g @anthropic-ai/claude-code

# 或使用 bun
bun add -g @anthropic-ai/claude-code

安装完成后，可以在终端运行 claude --version 验证安装成功。

---

配置 GWLLM 接口凭证

GWLLM 原生支持 Anthropic 标准协议规范（/v1/messages）。配置非常简单，只需设置以下两个环境变量：

1. 临时运行（单次会话生效）

在终端进入您的项目目录，执行：

# 设置 Base URL（指向 GWLLM，不要带 /v1，SDK 会自动寻址）
export ANTHROPIC_BASE_URL="https://gwllm.com"

# 设置您的 GWLLM 令牌
export ANTHROPIC_API_KEY="sk-您的GWLLM令牌"

# 启动 Claude Code
claude

2. 永久生效（推荐）

将环境变量写入终端配置文件，每次打开终端均可直接使用：

macOS / Linux (Zsh / Bash):

# 如果使用 zsh（macOS 默认）
echo 'export ANTHROPIC_BASE_URL="https://gwllm.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-您的GWLLM令牌"' >> ~/.zshrc
source ~/.zshrc

# 如果使用 bash
echo 'export ANTHROPIC_BASE_URL="https://gwllm.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-您的GWLLM令牌"' >> ~/.bashrc
source ~/.bashrc

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://gwllm.com', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-您的GWLLM令牌', 'User')

---

常用操作与使用技巧

启动 claude 进入交互终端后，您可以像与高级工程师结对编程一样使用它：

• 阅读并理解代码库：

  > 帮我梳理当前项目的整体架构和核心模块职责

• 定位与修复 Bug：

  > 运行单元测试，如果有报错，帮我找出原因并直接修复

• 开发新功能：

  > 在 /src/auth 模块中增加对 JWT 过期自动刷新的支持，并编写对应测试

• 自动 Git 提交：

  > 检查当前 git diff，按照 Conventional Commits 规范生成提交信息并执行 commit

---

常见问题排查

避坑提醒：Base URL 结尾格式

• ANTHROPIC_BASE_URL 请填写 https://gwllm.com（末尾切勿加 /v1）。Anthropic 官方 Node SDK 会自动在请求路径后追加 /v1/messages。如果填写为 https://gwllm.com/v1，会导致路径重叠报错 404 Not Found。

• 提示 API Key 无效或未设置？
  请在终端输入 echo $ANTHROPIC_API_KEY，确认该环境变量已正确输出您的令牌。
• 提示连接超时或网络错误？
  GWLLM 采用高可用海外专线，直连即可访问，无需开启任何代理软件。如果您本地开启了系统全局代理，建议将 gwllm.com 加入直连白名单。