> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-claude-api-zhong-shi-yong-ipwo-dai-li.md).

# 如何在 Claude API 中使用 IPWO 代理

在部分网络环境下，开发者可能需要通过代理服务器访问 Claude API。通过配置 IPWO 住宅代理，您可以为 Claude API 请求提供稳定的网络连接，并根据业务需求选择不同国家或地区的出口 IP。

本文将介绍如何在 Python 和 Node.js 环境中为 Claude API 配置 IPWO 代理。

***

### 环境准备

开始之前，请确保您已经：

* 拥有 [IPWO 住宅代理账号](/readme/zhu-ce-deng-lu.md)
* [获取代理用户名和密码](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* 获取代理服务器地址和端口
* 拥有 Claude API Key

示例代理信息：

```
Proxy Host: us.ipwo.net
Proxy Port: 7878

Username: username
Password: password
```

***

### 安装 Claude SDK

#### Python

```bash
pip install anthropic httpx
```

#### Node.js

```bash
npm install @anthropic-ai/sdk https-proxy-agent
```

***

### Python 示例

Claude 官方 Python SDK 基于 HTTP 请求运行，可通过 httpx 配置代理。

```python
from anthropic import Anthropic
import httpx

proxy_url = "http://username:password@us.ipwo.net:7878"

http_client = httpx.Client(
    proxy=proxy_url
)

client = Anthropic(
    api_key="YOUR_CLAUDE_API_KEY",
    http_client=http_client
)

response = client.messages.create(
    model="claude-sonnet-4-0",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Hello Claude"
        }
    ]
)

print(response.content[0].text)
```

***

### Python 异步示例

```python
import asyncio
import httpx
from anthropic import AsyncAnthropic

proxy_url = "http://username:password@us.ipwo.net:7878"

async def main():
    http_client = httpx.AsyncClient(
        proxy=proxy_url
    )

    client = AsyncAnthropic(
        api_key="YOUR_CLAUDE_API_KEY",
        http_client=http_client
    )

    response = await client.messages.create(
        model="claude-sonnet-4-0",
        max_tokens=1024,
        messages=[
            {
                "role": "user",
                "content": "Hello Claude"
            }
        ]
    )

    print(response.content[0].text)

asyncio.run(main())
```

***

### Node.js 示例

通过 https-proxy-agent 将 Claude API 请求转发至代理服务器。

```javascript
import Anthropic from "@anthropic-ai/sdk";
import { HttpsProxyAgent } from "https-proxy-agent";

const proxyAgent = new HttpsProxyAgent(
  "http://username:password@us.ipwo.net:7878"
);

const anthropic = new Anthropic({
  apiKey: process.env.CLAUDE_API_KEY,
  httpAgent: proxyAgent
});

const response = await anthropic.messages.create({
  model: "claude-sonnet-4-0",
  max_tokens: 1024,
  messages: [
    {
      role: "user",
      content: "Hello Claude"
    }
  ]
});

console.log(response.content[0].text);
```

***

### 使用环境变量配置代理

部分程序和框架会自动读取系统代理配置。

#### Linux/macOS

```bash
export HTTP_PROXY=http://username:password@us.ipwo.net:7878
export HTTPS_PROXY=http://username:password@us.ipwo.net:7878
```

#### Windows

```cmd
set HTTP_PROXY=http://username:password@us.ipwo.net:7878
set HTTPS_PROXY=http://username:password@us.ipwo.net:7878
```

***

### 验证代理是否生效

在调用 Claude API 前，建议先验证代理连接是否正常。

```bash
curl -x "us.ipwo.net:7878" \
-U "username:password" \
ipinfo.io
```

如果返回代理出口 IP 信息，说明代理连接正常。

***

### 常见问题

#### Connection Timeout

可能原因：

* 网络无法访问代理节点
* 代理账号已过期
* 防火墙限制连接

解决方案：

* 检查代理账户状态
* 测试其他节点
* 使用 curl 验证代理连接

***

#### Proxy Authentication Failed

可能原因：

* 用户名错误
* 密码错误
* 代理认证格式错误

请检查：

```
username
password
host
port
```

是否与控制台显示的信息一致。

***

#### Claude API 返回 401 Unauthorized

此错误通常与 Claude API Key 有关，而非代理配置问题。

建议检查：

* API Key 是否有效
* API Key 是否正确加载
* 账户额度是否正常

***

### 最佳实践

* 长时间运行的 AI 应用建议使用 Sticky Session，减少连接波动。
* 在生产环境中使用环境变量管理 API Key 和代理凭证。
* 高并发场景建议控制请求速率，避免频繁建立连接。
* Docker、云服务器和自动化工作流环境建议统一配置系统代理。

***

### 相关阅读

完成 Claude API 代理配置后，您可能还需要：

* [OpenAI SDK 使用代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-openai-sdk-zhong-shi-yong-ipwo-dai-li.md)
* [Gemini API 使用代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-gemini-api-zhong-shi-yong-ipwo-dai-li.md)
* [LangChain 使用住宅代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-langchain-xiang-mu-zhong-pei-zhi-ipwo-dai-li.md)
* [Browser Use 使用住宅代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-browser-use-zhong-pei-zhi-ipwo-dai-li.md)
* [MCP 工具代理配置指南](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-wei-mcp-gong-ju-he-mcp-server-pei-zhi-ipwo-zhu-zhai-dai-li.md)
* [获取和配置住宅代理](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)

> 提示：如果您正在开发 AI Agent、自动化工作流或多模型应用，建议统一使用代理配置管理 OpenAI、Claude、Gemini 等模型服务，以简化部署和维护流程。