Claude Code AGENTS.md 网络代理配置教程（Claude Code 代理设置）

在本地开发环境中使用 Claude Code 时，许多开发者会遇到网络连接不稳定或 API 调用受限的问题。这通常是因为需要配置特定的网络代理以访问 Anthropic 的服务。本文将通过步骤清单的形式，指导你如何正确编辑 AGENTS.md 文件来配置网络代理，确保开发流程顺畅。

准备工作：定位配置文件

首先，你需要找到项目根目录下的 AGENTS.md 文件。这个文件是 Claude Code 读取自定义指令和配置的核心入口。如果项目中不存在该文件，你可以手动创建一个名为 AGENTS.md 的文件，并将其放置在项目的最顶层目录中。确保你有权限编辑此文件，因为后续的修改将直接影响 Claude Code 的行为。

打开终端或命令行工具，导航到你的项目目录。使用文本编辑器（如 VS Code、Vim 或 Nano）打开 AGENTS.md。如果文件为空，可以直接开始编写；如果已有内容，请在保持原有结构的基础上添加代理配置部分。注意，不要破坏现有的 Markdown 格式，以免导致解析错误。

核心步骤：写入代理配置指令

在 AGENTS.md 文件中，你需要明确指示 Claude Code 使用特定的代理服务器。这主要通过环境变量或直接在指令中指定代理地址来实现。以下是推荐的配置方式：

第一步，确定你的代理类型。常见的代理协议包括 HTTP、HTTPS 和 SOCKS5。根据你的网络环境选择正确的协议。例如，如果你使用的是常见的代理软件，通常提供 HTTP/HTTPS 代理端口。

第二步，在 AGENTS.md 中添加如下格式的指令：

# Network Proxy Configuration

When making external API calls or fetching resources, use the following proxy settings:

- Protocol: http (or https/socks5)

- Host: 127.0.0.1

- Port: 7890

Ensure all requests respect these settings to maintain connectivity.

请将 Host 和 Port 替换为你实际使用的代理地址和端口号。如果你的代理需要认证，还需添加用户名和密码信息，但出于安全考虑，建议通过环境变量传递敏感信息，而非直接写在文件中。

验证与调试：确保配置生效

保存 AGENTS.md 文件后，重新启动 Claude Code 实例。为了验证配置是否生效，你可以尝试执行一个简单的代码生成任务，并观察日志输出。如果配置正确，Claude Code 应该能够通过代理正常连接至 Anthropic 的 API 服务器。

如果遇到连接超时或拒绝访问的错误，请检查以下几点：

1. 确认代理服务器正在运行且可访问。你可以在浏览器或其他应用中测试同一代理设置。

2. 检查防火墙设置，确保没有阻止 Claude Code 进程通过指定端口出站连接。

3. 查看 Claude Code 的详细日志，寻找关于代理连接的错误信息，以便进一步排查。

此外，建议在配置完成后，清理本地的缓存数据，以避免旧的网络设置干扰新的代理配置。这样，你就能在一个稳定、高效的环境中利用 Claude Code 进行开发工作，无需再为网络问题分心。

本文链接：https://masoncountygrowth.com/sanjiaozhou/claude-code-agents-md-wmdlpzjc-claude-code-dlsz/