feat: add DEBUG_PRINT_PAYLOAD config option

Add a config option to control whether to print request/response payloads.
Default is false (no printing), set to true for debugging/learning.

Usage:
  DEBUG_PRINT_PAYLOAD=true  # print payloads
  DEBUG_PRINT_PAYLOAD=false # default, silent mode

Author: arrayadd

src/main/java/learn/claude/code/common/AnthropicClient.java

@@ -60,6 +60,9 @@ public class AnthropicClient {
     /** 模型 ID，如 "claude-sonnet-4-20250514"，决定了使用哪个版本的 Claude */
     private final String model;
 
+    /** 是否打印请求/响应报文，用于调试，默认 false */
+    private final boolean debugPrintPayload;
+
     /**
      * Gson 实例，开启 PrettyPrinting 是为了调试时日志可读性更好。
      * 设为 static final 是因为 Gson 是线程安全的，全局共享一个实例即可。
@@ -136,13 +139,16 @@ public AnthropicClient() {
         this.apiKey = getConfig("ANTHROPIC_API_KEY",
                 getConfig("ANTHROPIC_AUTH_TOKEN", ""));
         this.model = getConfig("MODEL_ID", "");
+        // 读取调试开关，默认不打印报文
+        this.debugPrintPayload = Boolean.parseBoolean(getConfig("DEBUG_PRINT_PAYLOAD", "false"));
 
         // 启动时打印配置来源，方便调试 —— 生产环境中应该用日志框架替代 System.out
         // 注意：API Key 只打印前 8 位，这是安全最佳实践，防止密钥泄露到日志中
         System.out.println("[AnthropicClient] base_url = " + baseUrl);
         System.out.println("[AnthropicClient] model    = " + model);
         System.out.println("[AnthropicClient] api_key  = " +
                 (apiKey.isEmpty() ? "(NOT SET!)" : apiKey.substring(0, Math.min(8, apiKey.length())) + "..."));
+        System.out.println("[AnthropicClient] debug    = " + debugPrintPayload);
     }
 
     public String getModel() {
@@ -236,7 +242,9 @@ private String doPost(String path, String jsonBody) {
             }
 
             // ===== 发送请求体 =====
-            System.out.println("=====请求报文=====\n"+jsonBody.toString());
+            if (debugPrintPayload) {
+                System.out.println("=====请求报文=====\n" + jsonBody);
+            }
             byte[] bodyBytes = jsonBody.getBytes(StandardCharsets.UTF_8);
             conn.setRequestProperty("Content-Length", String.valueOf(bodyBytes.length));
             try (OutputStream os = conn.getOutputStream()) {
@@ -263,14 +271,16 @@ private String doPost(String path, String jsonBody) {
             if (status < 200 || status >= 300) {
                 throw new RuntimeException("API Error (HTTP " + status + "): " + sb.toString());
             }
-            // 格式化 JSON 响应报文
+            // 格式化 JSON 响应报文（仅在调试模式下打印）
             String responseStr = sb.toString();
-            try {
-                JsonObject responseJson = JsonParser.parseString(responseStr).getAsJsonObject();
-                System.out.println("=====响应报文=====\n" + GSON.toJson(responseJson));
-            } catch (Exception e) {
-                // JSON 解析失败时直接输出原始字符串
-                System.out.println("=====响应报文=====\n" + responseStr);
+            if (debugPrintPayload) {
+                try {
+                    JsonObject responseJson = JsonParser.parseString(responseStr).getAsJsonObject();
+                    System.out.println("=====响应报文=====\n" + GSON.toJson(responseJson));
+                } catch (Exception e) {
+                    // JSON 解析失败时直接输出原始字符串
+                    System.out.println("=====响应报文=====\n" + responseStr);
+                }
             }
             return responseStr;
 

src/main/resources/claude.properties.example

@@ -13,3 +13,7 @@ ANTHROPIC_API_KEY=your-api-key-here
 # 模型 ID（必填）
 # 推荐: claude-sonnet-4-20250514
 # MODEL_ID=claude-sonnet-4-20250514
+
+# 是否打印请求/响应报文（可选，默认 false）
+# 设为 true 可用于调试和学习 API 交互过程
+DEBUG_PRINT_PAYLOAD=false