1# Configuration

2 

3<CodexDocsOverviewLanding

4 title="Configuration"

5 description="Set defaults, add durable context, and customize how ChatGPT and Codex developer tools work."

6 intro="Configuration shapes how ChatGPT and Codex developer tools behave across tasks, repositories, and machines. Durable context, config files, repository guidance, subagents, external connections, and Windows setup work together to keep those workflows consistent for individuals and teams."

7 primaryCta={{

8 label: "Explore customization",

9 href: "/codex/customization/overview",

10 }}

11 hero={{

12 illustration: "configuration",

13 backgroundImage: "/images/codex/codex-wallpaper-1.webp",

14 alt: "ChatGPT settings navigation, config file options, and personality controls",

15 }}

16 sections={[

17 {

18 title: "Customization",

19 description:

20 "Adapt the experience and carry useful context between tasks.",

21 pages: [

22 {

23 title: "Customization overview",

24 description:

25 "Customize ChatGPT and Codex with guidance, skills, MCP, and subagents.",

26 href: "/codex/customization/overview",

27 icon: "customize",

28 },

29 {

30 title: "Memories",

31 description:

32 "Let ChatGPT retain useful context across chats and tasks.",

33 href: "/codex/customization/memories",

34 icon: "threads",

35 },

36 {

37 title: "Chronicle",

38 description:

39 "Understand how durable memory is collected and managed.",

40 href: "/codex/customization/chronicle",

41 icon: "stack",

42 },

43 ],

44 },

45 {

46 title: "Config file",

47 description:

48 "Control models, tools, environments, and defaults with configuration files and variables.",

49 pages: [

50 {

51 title: "Config basics",

52 description:

53 "Understand configuration layers and create a config file.",

54 href: "/codex/config-file/config-basic",

55 icon: "settings",

56 },

57 {

58 title: "Advanced config",

59 description:

60 "Use profiles, providers, policies, and advanced options.",

61 href: "/codex/config-file/config-advanced",

62 icon: "dataControls",

63 },

64 {

65 title: "Config reference",

66 description: "Look up every supported configuration key.",

67 href: "/codex/config-file/config-reference",

68 icon: "code",

69 },

70 {

71 title: "Environment variables",

72 description: "Set values that change across systems and sessions.",

73 href: "/codex/config-file/environment-variables",

74 icon: "terminal",

75 },

76 {

77 title: "Sample config",

78 description:

79 "Start from a complete, annotated configuration example.",

80 href: "/codex/config-file/config-sample",

81 icon: "folder",

82 },

83 ],

84 },

85 {

86 title: "Agent configuration",

87 description: "Shape how agents collaborate and follow project guidance.",

88 pages: [

89 {

90 title: "AGENTS.md",

91 description: "Give Codex durable instructions for a repository.",

92 href: "/codex/agent-configuration/agents-md",

93 icon: "folder",

94 },

95 {

96 title: "Subagents",

97 description: "Delegate focused tasks to specialized agents.",

98 href: "/codex/agent-configuration/subagents",

99 icon: "robot",

100 },

101 {

102 title: "Speed",

103 description: "Control how quickly and deeply Codex works.",

104 href: "/codex/agent-configuration/speed",

105 icon: "settings",

106 },

107 {

108 title: "Rules",

109 description: "Define commands Codex can run automatically.",

110 href: "/codex/agent-configuration/rules",

111 icon: "dataControls",

112 },

113 ],

114 },

115 {

116 title: "Extend ChatGPT and Codex",

117 description: "Package knowledge, connect services, and add capabilities.",

118 pages: [

119 {

120 title: "Record & Replay",

121 description:

122 "Show ChatGPT a workflow and turn it into a reusable skill.",

123 href: "/codex/extend/record-and-replay",

124 icon: "tools",

125 },

126 {

127 title: "MCP",

128 description:

129 "Connect Codex developer tools to external tools and context.",

130 href: "/codex/extend/mcp",

131 icon: "connect",

132 },

133 ],

134 },

135 {

136 title: "Windows",

137 description: "Run Codex natively on Windows or inside WSL.",

138 pages: [

139 {

140 title: "ChatGPT desktop app",

141 description:

142 "Use the ChatGPT desktop app with PowerShell or WSL workflows.",

143 href: "/codex/windows/windows-app",

144 icon: "computerUse",

145 },

146 {

147 title: "Windows sandbox",

148 description:

149 "Run Codex with native filesystem and command isolation.",

150 href: "/codex/windows/windows-sandbox",

151 icon: "lock",

152 },

153 {

154 title: "WSL",

155 description: "Use Codex in a Linux environment managed by Windows.",

156 href: "/codex/windows/wsl",

157 icon: "terminal",

158 },

159 ],

160 },

161 ]}

162/>