Codex / Claude Code 高频问题 Wiki

采集日期：2026-06-17。
这页不是官方 FAQ 翻译，而是把 Codex 和 Claude Code 新手最容易问的问题，按“能不能直接行动”重新整理。

判断依据：

Claude Code 有官方 FAQ，明确覆盖认证、集成、配置、权限、团队协作、成本和代码库理解等常见问题。
Codex 的高频问题主要分散在 CLI、配置、沙箱与审批、AGENTS.md、MCP、Windows 等官方页面。
GitHub issue、开发者社区和搜索结果只作为“问题信号”，不作为最终事实依据；真正答案尽量回到官方文档。

先看结论

问题类型	新手最常问	最短答案
安装和登录	我装好了，为什么不能用？	先确认账号、计划、终端路径、Node/CLI 是否生效，不要先重装一堆东西
权限和审批	为什么一直问我能不能运行命令？	这是安全边界，不是故障；先学会区分只读、写文件、联网和危险命令
上下文	它会不会自动记住整个项目？	不要假设会；让 agent 先只读摸底，再把结论写进项目说明文件
AGENTS.md / CLAUDE.md	为什么我写了规则它不听？	说明文件是上下文，不是强制权限；强制限制要用权限、沙箱或 hook
MCP	MCP 是不是越多越好？	不是；只在“反复复制外部系统信息”时接入，并先看权限和凭证风险
Skill	Skill 是不是高级提示词？	更像可复用工作流；先只读审查，不要盲装
费用和用量	为什么用量涨得快？	大仓库、长上下文、MCP 输出、重复试错都会增加成本；先缩小任务
Windows	Windows 上到底用原生还是 WSL？	Codex 优先原生沙箱；需要 Linux 工具链或原生沙箱不适配时用 WSL2

安装和访问

1. Codex 是什么？和普通聊天有什么区别？

Codex CLI 是能在终端里运行的 coding agent。它可以读取当前目录里的代码、修改文件、运行命令，并围绕仓库完成开发任务。

新手不要把 Codex 当“问答聊天框”。正确使用方式是：

请先只读当前项目，不要改文件。
目标：{一个小任务}
请输出相关文件、最小交付版本、风险和验证方法。

2. Codex 需要什么账号？

OpenAI 官方文档说明，ChatGPT Plus、Pro、Business、Edu、Enterprise 计划包含 Codex。第一次运行 CLI 时会要求登录，可以使用 ChatGPT 账号或 API key。

如果你不能登录，先确认：

用的是不是包含 Codex 的账号。
是否在正确终端里运行 codex。
公司网络、代理或终端权限有没有拦截登录流程。

3. Claude Code FAQ 里最常见的访问问题是什么？

Claude 官方 FAQ 把常见问题集中在认证、集成、配置、账号和团队访问上。团队账号里，用户通常应加入 Console organization 并拥有相应 Claude Code 角色，再在 Claude Code 里 /login 选择对应 Console account。

不要自己在 Claude Code workspace 里手动创建 API key 来绕过组织配置。

权限、沙箱和安全

4. 为什么 Codex 经常问我要不要批准？

这通常不是故障。Codex 的本地 CLI / IDE extension 会用操作系统级沙箱控制文件和网络访问。默认工作区写入模式通常允许它在当前工作区读写和运行命令，但网络访问默认关闭；超出工作区、联网或有副作用的动作会触发审批。

新手应该把审批当成安全提示：

只读命令：通常低风险。
写文件：看是否只改当前任务相关文件。
联网：看目标域名和用途。
删除、移动、大范围格式化：先停。

5. Codex 的网络不能访问，是不是坏了？

不一定。Codex 的 workspace-write 沙箱默认关闭命令联网。需要联网时，可以在配置里启用 sandbox_workspace_write.network_access = true，也可以配合 network proxy 做域名控制。

新手不要为了省事直接开全局网络。更稳的做法是：

先让 Codex 说明为什么必须联网。
只允许这一次或指定域名。
完成后回到默认限制。

6. Claude Code 为什么也会一直问权限？

Claude Code 用细粒度权限系统控制工具行为。读文件和搜索通常不需要确认；Bash、文件修改、MCP 工具等会根据模式和规则触发确认。官方权限文档说明，规则可以 allow、ask、deny，且 deny 优先。

新手不要一开始就开 bypassPermissions。它适合隔离环境，例如容器或虚拟机，不适合真实项目里盲用。

7. 写在 AGENTS.md 或 CLAUDE.md 里的“不要删除文件”能强制生效吗？

不能把它当强制安全边界。

Codex 的 AGENTS.md 适合写项目规则、测试命令、工作约定。
Claude Code 的 CLAUDE.md 适合写项目说明、架构约定、偏好和工作流。
如果要强制阻止危险动作，要用权限、沙箱、hook 或受控环境。

一句话：说明文件影响 agent 的行为倾向，但不是系统权限。

上下文、记忆和代码库理解

8. Claude Code 会不会先索引整个代码库？

Claude 官方 FAQ 明确说，Claude Code 不是把整个代码库放进向量数据库。它通过搜索和读文件工具按需导航代码库。

对新手的含义是：不要问“你了解整个项目了吗”。应该要求它列出已经读过哪些文件、为什么读、还缺什么信息。

9. Codex 和 Claude Code 会不会跨会话记住我说过的话？

不要默认假设它们会完整记住。

更可靠的做法是把长期规则写进文件：

Codex：全局或项目里的 AGENTS.md，以及 .codex/config.toml。
Claude Code：CLAUDE.md、.claude/rules/、auto memory。

Claude Code 的 memory 文档说明，每个会话从新的上下文窗口开始，跨会话主要依赖 CLAUDE.md 和 auto memory。

10. 上下文爆了怎么办？

Claude Code 官方 troubleshooting 里提到高 CPU、内存、慢响应、auto-compact thrashing 等问题。可做的低风险动作：

用 /compact 缩小上下文。
让它按函数、文件片段或行号读，不要整仓库通读。
大文件任务拆给独立子任务。
不需要旧对话时用 /clear。

Codex 里也一样：任务越小、输入越明确，越不容易漂移。

MCP、Skill 和外部工具

11. MCP 是不是越多越好？

不是。MCP 适合“你经常把外部系统信息复制进 agent”的场景，例如 issue tracker、监控系统、数据库、GitHub。

Claude Code 官方 MCP 文档说明，MCP 让 Claude Code 连接外部工具、数据库和 API。Codex 也支持在 config.toml 里配置 MCP server。

新手只记一条：凡是接入账号、数据库、云服务、GitHub、生产 API 的 MCP，都先在测试项目里审查权限。

12. Skill 应该先安装还是先阅读？

先阅读。Skill 更像可复用工作流，不是“万能增强包”。

新手审查 Skill 先问：

它什么时候触发？
它会读取哪些文件？
有没有脚本、MCP、hook、浏览器、GitHub 或云服务？
是否会写文件、联网、提交代码、部署？
如何验证和回滚？

如果回答不清楚，不要安装。

13. Claude Code 的 hooks 和 CLAUDE.md 有什么区别？

Claude Code 官方 best practices 说明，hooks 会在特定工作流节点自动运行脚本；它比 CLAUDE.md 这类说明文件更确定。

新手理解：

CLAUDE.md：告诉 Claude 应该怎么做。
hook：到了某个节点自动执行动作。
permission：允许或禁止某类工具调用。

有副作用的 hook 一定要先在测试项目里试。

费用、用量和性能

14. Claude Code 用量怎么控制？

Claude Code FAQ 建议，对自动化工作流可以从 Opus 切换到 Sonnet 来节省成本，也可以通过 Console dashboard 监控 usage、设置 rate limits，使用 Workspaces 做更细的 spend limits。

新手真正要做的是减少无效上下文：

不让 agent 整仓库通读。
不一次做 5 个功能。
不把 MCP 输出无限塞进上下文。
每次只做一个可验收的小任务。

15. Codex 费用怎么判断？

Codex 是否包含在你的计划里，要看当前 OpenAI 官方 pricing 和计划说明。安装、登录、价格、额度属于高变动信息，本站只做入口和风险提醒，不把价格写死。

Windows 和环境问题

16. Codex 在 Windows 上应该用原生还是 WSL2？

OpenAI Windows 文档建议，默认使用原生 Windows 沙箱，因为性能和安全边界更直接；当你需要 Linux-native 工具链、工作流已经在 WSL2，或原生沙箱不适合时，再选择 WSL2。

注意：Codex 文档说明 WSL1 从 Codex 0.115 开始不再支持。

17. Codex 在 Windows 沙箱里读不到目录怎么办？

如果命令失败是因为 Windows 沙箱不能读取某个目录，可以在会话里用 /sandbox-add-read-dir C:\absolute\directory\path 授权读取。路径必须是已经存在的绝对目录。

不要直接切到 full access。先问：

请说明你为什么需要读取这个目录，以及读取它会不会接触密钥、客户数据、生产配置或私人文件。

团队协作

18. 团队应该共享什么配置？

适合共享：

项目启动命令。
测试命令。
代码风格。
不允许改的目录。
发布和部署边界。
安全红线。

Codex 可用仓库里的 AGENTS.md。Claude Code 可用项目范围 .claude/ 配置和 CLAUDE.md。Claude settings 文档还区分 Managed、User、Project、Local 等作用域。

19. 团队记忆现在主要靠什么？

Claude Code FAQ 提到，目前团队知识共享主要还是 Claude.md 文件；IT 团队可以注入标准化 Claude.md 到机器上的 .claude 目录。

所以不要把“团队记忆”想成自动知识库。对团队更有用的是把稳定规则写进仓库，而不是藏在个人聊天历史里。

新手最该保存的 6 句指令

请先只读项目，不要修改文件。

请列出你已经读过的文件、为什么读、还缺什么信息。

请把任务收窄到今天能完成的最小交付版本。

请说明这个命令是否只读、是否写文件、是否联网、失败后如何恢复。

请根据当前 diff 找无关改动、回归风险和缺失验证。

请生成交付说明：完成了什么、改了哪些文件、如何验证、剩余风险。

来源与日期

采集日期：2026-06-17。
OpenAI Codex 来源：Codex CLI、Agent approvals & security、Config basics、AGENTS.md、MCP、Windows。
Claude Code 来源：Claude Code FAQ、Overview、Permissions、Settings、Memory、MCP、Best practices、Troubleshooting。
社区线索：OpenAI Developer Community、openai/codex GitHub issues、anthropics/claude-code GitHub issues。社区内容仅用于判断问题频率，不作为事实依据。