How to 5x Your Communication Effectiveness with Claude Code

如何通过 Claude Code 将沟通效率提升 5 倍

A substantial issue I’ve noticed when interacting with Claude Code, Codex, or any other coding agent is that I sometimes find it hard to read all of the information they present inline in the terminal window. 在与 Claude Code、Codex 或任何其他编程智能体交互时，我发现一个主要问题：有时很难阅读它们在终端窗口中直接呈现的所有信息。

I think this issue is not as significant if you’re using a platform such as the ChatGPT app or the Claude Code application, though I still think it’s a very relevant issue simply because reading a bunch of text that’s not particularly formatted makes it difficult to pick up on the important points that the coding agent is presenting to you, thus, making it difficult for the coding agent to transfer important information to you so you can make the best possible decisions. 我认为如果你使用的是 ChatGPT 应用或 Claude Code 应用程序，这个问题可能没那么严重。但我依然认为这是一个非常现实的问题，因为阅读大量未经格式化的文本，很难捕捉到智能体想要传达的重点，这导致智能体难以将关键信息传递给你，从而影响你做出最佳决策。

That’s why I’ve developed a technique that I use probably up to 100 times per day, where I make my coding agents present me their findings and information in a more understandable and easier-to-process format. In this article, I discuss this format and how I use it actively for essentially all my coding sessions to better align with my coding agents and understand what they mean. 因此，我开发了一种每天使用次数高达 100 次的技术：让编程智能体以一种更易于理解和处理的格式向我展示其发现和信息。在本文中，我将讨论这种格式，以及我如何在几乎所有的编程会话中积极使用它，以便与智能体更好地对齐并理解它们的意图。

This infographic highlights the main contents of this article. I’ll discuss how to make the communication flow between you and your coding agents, such as Claude Code and Codex, more effective to increase your coding speed. Image by ChatGPT. 这张信息图突出了本文的主要内容。我将讨论如何使你与 Claude Code 和 Codex 等编程智能体之间的沟通流程更高效，从而提高你的编码速度。（图片由 ChatGPT 生成）

Why is communication with coding agents hard

为什么与编程智能体的沟通很困难

First of all, I’d like to cover the reason for my article and the thought behind it. Basically, the main reason I came up with the topic for this article is that I noticed whenever I was interacting with my coding agent, whether it be Claude Code or Codex or any other coding agent for that matter, open code, for example, I had a hard time reading all the output tokens the coding agent presented to me. 首先，我想说明写这篇文章的原因及其背后的思考。基本上，我提出这个话题的主要原因是，我注意到每当与编程智能体（无论是 Claude Code、Codex 还是其他任何智能体，例如 open code）交互时，我很难阅读它们呈现给我的所有输出标记（tokens）。

First of all, I noticed that the agent might put a bunch of information in hard-to-find places. For example, I might ask it to perform a task; it presents me with some important information midway through the thread, and then some more important information at the bottom of that thread. The quick fix for this issue, which is also something I’ve discussed in previous articles, is that I asked the coding agent to present all relevant information to me at the bottom of the thread. 首先，我注意到智能体可能会把大量信息放在难以发现的地方。例如，我要求它执行一项任务，它会在对话中途提供一些重要信息，然后在对话底部又提供一些重要信息。针对这个问题，我在之前的文章中讨论过一个快速解决方法：要求智能体将所有相关信息汇总在对话底部。

This helped a lot by making sure I actually had the opportunity to pick up all of the relevant context. However, immediately another issue appeared to me. 这确实很有帮助，确保了我能够获取所有相关的上下文。然而，另一个问题随之而来。

When I started to read the information the agent was presenting to me at the bottom of the thread, I found myself having a hard time actually reading the information. Both because I have to do it many times during the day. I probably read the bottom of the thread hundreds of times per day, but also because the text was not formatted, and of course, sometimes the coding agents would include information that is not relevant, which I of course don’t want to spend time reading. 当我开始阅读智能体在对话底部呈现的信息时，我发现自己很难真正读进去。这不仅是因为我每天要重复多次（可能每天要读几百次对话底部），还因为文本没有经过格式化。当然，有时智能体还会包含一些无关紧要的信息，我并不想浪费时间去阅读这些内容。

Thus, I knew I had to come up with a better way for me to communicate with my coding agents to ensure that I could pick up all the relevant information that they wanted to give me so that I could make the best possible decisions. This is why I came up with the techniques that I’m presenting in this article, which will vastly improve how effective your communication is with your coding agents. 因此，我知道必须找到一种更好的方式与编程智能体沟通，以确保我能获取它们想要传达的所有相关信息，从而做出最佳决策。这就是我提出本文中这些技术的原因，它们将极大地提高你与编程智能体沟通的效率。

This image shows an archify diagram that I’ve created. This is an extremely effective way of quickly communicating between you and the coding agent because the visual presentation of information makes it easier for the human brain to understand. Image by author. 这张图片展示了我创建的一个架构图。这是一种在人类与编程智能体之间进行快速沟通的极其有效的方式，因为信息的视觉化呈现使人类大脑更容易理解。（图片由作者提供）

How to communicate better with coding agents: HTML files

如何与编程智能体更好地沟通：HTML 文件

Now, the main technique I want to present in this article is to have coding agents present the results to you in HTML instead of just presenting them inline in the terminal. 现在，我想在本文中介绍的核心技术是：让编程智能体以 HTML 格式向你呈现结果，而不是仅仅在终端中直接输出。

I would say that roughly 90-95% of the time that I have coding agents present me with some information, I have it presented to me in HTML. There are a few instances where I read the coding agent and what it says inline if it’s super simple, and I know that I’m just picking up some quick pieces of information. However, in most cases, there’s more information and more nuanced information that I want to pick up; thus, I asked the coding agent to present it to me in an HTML file. 可以说，我大约 90-95% 的时间都会要求智能体以 HTML 格式呈现信息。只有在极少数情况下，如果内容非常简单且我只需要获取一些快速信息时，我才会直接阅读终端内的输出。但在大多数情况下，我需要获取更多且更细致的信息，因此我会要求智能体将其呈现在 HTML 文件中。

HTML files are awesome because they’re so much more expressive than TXT files, which is basically the file type that you have whenever an agent talks to you in the terminal. So if an agent talks to you in the terminal, there’s no text parsing, it just writes out plain text, and it can make new lines, and that’s about it. This is, of course, okay if an agent or a robot is reading it; it just needs to read the text, but for the human eye, it makes it very hard to pick up all the important information. HTML 文件非常棒，因为它们比 TXT 文件（智能体在终端中与你对话时默认的文件类型）具有更强的表现力。当智能体在终端中与你对话时，没有文本解析，它只是输出纯文本，顶多能换行。如果是由智能体或机器人来读取，这当然没问题；但对于人类的眼睛来说，这很难捕捉到所有重要信息。

You can notice this very clearly yourself: the difference between reading this article that you’re reading right now with the markdown formatting that we have here, where you can see the headlines, for example, or you can see the quotes such as below. 你可以很清楚地感受到这一点：阅读这篇文章（带有 Markdown 格式，你可以看到标题或下方的引用）与阅读纯文本的区别。

This is a quote, and is parsed in a nice manner 这是一个引用，并且以美观的方式进行了排版。

For the human eye, having something that breaks up the pattern makes it a lot easier to pay attention to all of the information and actually pick up all of the information, which is why HTML files work so well. 对于人类的眼睛来说，通过某种方式打破文本的单调感，能让人更容易集中注意力并获取所有信息，这就是 HTML 文件如此有效的原因。

The agent can then present all the information they want to present to you in an HTML instead, where you can have headlines, it can have visuals, it can have bold text if something is very important, it can highlight something, it can include screenshots in the HTML, for example, that might be relevant if you’re analyzing something for your application and so on, there’s just a lot more information the agent can present to you because they can present the information in a visual manner as well, not only in a textual manner. 智能体可以将想要呈现的所有信息放入 HTML 中，其中可以包含标题、视觉元素、加粗重点文本、高亮显示，甚至可以在 HTML 中包含截图（例如，如果你正在为应用程序分析某些内容时，这可能很有用）。智能体能呈现的信息量大大增加，因为它不仅能以文本方式，还能以视觉方式呈现信息。

Not only is this easier for the human brain to understand because you can read the visuals, it also makes it a lot more intuitive. And in my experience, it makes me able to pick up the information a lot faster because I don’t h… 这不仅因为你可以通过视觉元素阅读而更容易被大脑理解，而且更加直观。根据我的经验，这使我能够更快地获取信息，因为我不需要……